📦
ml-antipattern-validator
81验证 ML 工作流中的隐藏反模式
ML 项目可能看起来准确，但数据泄漏或薄弱的评估会掩盖严重缺陷。此技能会指导对拆分、指标、训练和部署就绪情况进行结构化检查。
数据与分析 查看
技能 api-contract-design
📦
api-contract-design
v1.0 内容修订 r1 安全 ⚙️ 外部命令🌐 网络访问📁 文件系统访问🔑 环境变量
设计以 Schema 优先的 OpenAPI 契约
当契约不清晰或在实现之后才编写时，API 团队会浪费时间。此技能指导 OpenAPI 优先设计、TypeScript 生成、验证、文档和 mock 工作流。
支持: Claude Codex Code(CC)
使用我的智能体安装
将此请求复制给你的智能体，其中包含权威 Skill 页面和清单。
智能体请求
Review the Skillstore skill "api-contract-design" from https://skillstore.io/skills/doyajin174-api-contract-design.md and its manifest at https://skillstore.io/api/skills/doyajin174-api-contract-design/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.你的智能体仍应展示其计划，并按安全策略请求必要确认。
Agent 可读资源
当 AI Agent、爬虫或脚本需要干净上下文，而不是读取完整页面时，请使用这些链接。
测试它
正在使用“api-contract-design”。 团队需要在后端工作开始前创建用户管理 API。
预期结果:
- 包含用户、身份验证、分页和错误部分的 OpenAPI 契约大纲。
- 面向前端和后端团队的审查清单。
- 共享客户端模型的类型生成计划。
正在使用“api-contract-design”。 旧服务缺少类型化客户端。
预期结果:
一个迁移计划，将端点映射到 OpenAPI operations，然后生成 TypeScript 类型和客户端。
正在使用“api-contract-design”。 前端开发因缺少后端端点而受阻。
预期结果:
一个使用契约、共享示例和 API 变更审查步骤的 mock server 工作流。
安全审计
安全v8 • 2026/7/6 打开版本化报告
All static findings were adjudicated as false positives in documentation examples, reference links, or OpenAPI schema snippets. No prompt injection, credential exfiltration, unauthorized command execution, or malicious network intent was found in SKILL.md or marketplace.json.
2
已扫描文件
620
分析行数
0
复核项
0
已忽略误报
风险因素
⚙️ 外部命令 (41)
marketplace.json:65 SKILL.md:29 SKILL.md:31-245 SKILL.md:245-249 SKILL.md:249-263 SKILL.md:263-267 SKILL.md:267-274 SKILL.md:274-278 SKILL.md:278-283 SKILL.md:283-289 SKILL.md:289-291 SKILL.md:291-293 SKILL.md:293-296 SKILL.md:296-300 SKILL.md:300-308 SKILL.md:308-314 SKILL.md:314-316 SKILL.md:316-318 SKILL.md:318-341 SKILL.md:341-345 SKILL.md:345-347 SKILL.md:347-349 SKILL.md:349-362 SKILL.md:362-368 SKILL.md:368-395 SKILL.md:395-401 SKILL.md:401-403 SKILL.md:403-405 SKILL.md:405-415 SKILL.md:415-419 SKILL.md:419-421 SKILL.md:421-423 SKILL.md:423-438 SKILL.md:438-444 SKILL.md:444-448 SKILL.md:448-452 SKILL.md:452-459 SKILL.md:459-465 SKILL.md:465-477 SKILL.md:477-481 SKILL.md:481-487
🌐 网络访问 (9)
📁 文件系统访问 (2)
🔑 环境变量 (2)
最新一次完成的静态与语义审计未检测到已确认的安全发现。这并不能证明该 Skill 没有副作用。
审计者: codex 查看审计历史 →
分享与引用此报告
分享版本化评估报告、中性徽章、嵌入卡片和引用。Skillstore 只报告证据，不判断该 Skill 是否安全。
复制报告链接
https://skillstore.io/skills/doyajin174-api-contract-design/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown 徽章
[](https://skillstore.io/skills/doyajin174-api-contract-design?utm_source=security_passport_badge)HTML 徽章
<a href="https://skillstore.io/skills/doyajin174-api-contract-design?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/doyajin174-api-contract-design/security.svg" alt="Skillstore security assessment" loading="lazy"></a>嵌入卡片
<iframe src="https://skillstore.io/embed/skills/doyajin174-api-contract-design.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>学术引用 (APA · BibTeX · CFF)
APA 引用
Doyajin174. (2026). api-contract-design security audit report (audit version 8) [Author version 1.0]. Skillstore. https://skillstore.io/skills/doyajin174-api-contract-design/audits/8BibTeX 引用
@techreport{doyajin174-doyajin174-api-contract-design-2026,
author = {Doyajin174},
title = {api-contract-design security audit report (audit version 8)},
institution = {Skillstore},
year = {2026},
number = {8},
url = {https://skillstore.io/skills/doyajin174-api-contract-design/audits/8},
note = {Author version 1.0}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "api-contract-design security audit report (audit version 8)"
version: "1.0"
type: report
authors:
- name: "Doyajin174"
date-released: "2026-07-06"
url: "https://skillstore.io/skills/doyajin174-api-contract-design/audits/8"
identifiers:
- type: other
value: "skillstore:doyajin174-api-contract-design:audit:8"
description: "Skillstore immutable audit report identifier"
Skillstore 评分
评分依据 证据置信度: 高 55
架构
85
可维护性
87
内容
71
社区
78
规范符合性
你能构建什么
规划新的产品 API
在开始实现之前定义端点、数据模型、错误响应和客户端类型。
记录现有 REST 服务
将当前行为转换为团队可以审查和维护的 OpenAPI 契约。
标准化服务契约
为跨服务的分页、错误、版本控制、验证和生成的 SDK 创建一致模式。
试试这些提示
创建基础契约
为 todo API 设计一个 OpenAPI 3.1 契约。包含 CRUD 端点、请求 schema、响应和常见错误。
添加类型生成
使用可复用 schema 和 operation IDs 扩展此 API 契约。解释如何生成 TypeScript 类型并验证请求。
设计团队工作流
为前端和后端团队创建一个 schema-first 工作流。包含 mock server 使用、审查、版本控制和文档发布。
审计大型契约
审查此 OpenAPI 契约的可维护性、破坏性变更、重复 schema、弱验证和代码生成风险。提出按优先级排序的改进建议。
最佳实践
- 在实现开始前就 operation IDs、响应形状和错误模型达成一致。
- 通过可复用 schema、响应和路径引用，让大型契约保持模块化。
- 在生成客户端或 SDK 之前，像审查生产代码一样审查 API 契约。
避免
- 不要在没有明确所有权规则的情况下混用 schema-first 和 code-first 来源。
- 不要在没有迁移说明的情况下把破坏性变更隐藏在版本标签后面。
- 不要从未经审查的契约或过时规范生成客户端。
常见问题
此技能会自动运行 OpenAPI 工具吗？
不会。它解释命令和模式，但工具执行需要用户明确操作。
它面向哪个 OpenAPI 版本？
它专注于 OpenAPI 3.1，同时许多模式也适用于 OpenAPI 3.0。
它能帮助处理现有 API 吗？
可以。它可以帮助将当前端点描述为用于审查和文档的契约。
它能替代后端验证吗？
不能。它概述验证模式，但应用程序必须在运行时强制执行验证。
Claude、Codex 或 Claude Code 可以使用它吗？
可以。报告标明支持 Claude、Codex 和 Claude Code 工作流。
它对生成客户端有用吗？
有用。它解释 operation IDs、可复用 schema，以及用于类型化客户端的生成工作流。
开发者详情
作者
Doyajin174许可证
MIT
作者版本
v1.0
Skillstore 修订
r1
版本提示
作者声明的版本不符合 SemVer 规范。
引用
72d5025b022c77f7a51bdf5c1637c689c80e89d1
维护新鲜度
2026/7/18
使用量
6 次下载 · 261 次浏览
文件结构
Doyajin174 的更多技能
查看全部📦
systematic-debugging
79系统化调试软件问题
当在理解证据之前就开始修复时，调试往往会失败。本技能引导 Claude、Codex 和 Claude Code 进行根因分析、模式比较、假设测试和已验证的修复。
编码与开发 查看
📦
prompt-engineering
79编写更好的 AI 提示词
模糊的提示词往往会产生不完整或不一致的 AI 响应。此技能为 Claude、Codex 和 Claude Code 提供清晰的结构、示例和迭代方法。
写作与内容 查看
📦
readme-for-developers
79创建开发者入门 README
新贡献者常常会在查找设置步骤、架构背景和归属规则上浪费时间。此技能会将项目事实转化为结构化 README，以支持入门、调试和交付。
文档 查看
📦
adr-log
79使用 ADR 记录架构决策
团队常常会忘记重大技术选择当初为什么会被做出。此技能可帮助起草、审查和整理 ADR，并提供清晰的背景、替代方案和后果说明。
文档 查看
📦
report-writing
78创建完成报告
团队在已完成工作未被记录时会丢失上下文。此技能会将变更、影响、验证和后续任务整理成结构化的完成报告。
文档 查看
相关技能
查看全部📦
api-designer
84设计可靠的 REST 和 GraphQL API
由 AutumnsGrove
API 团队需要一致的端点、身份验证和文档。此技能指导 REST、GraphQL、OpenAPI、版本控制和安全设计决策。
编码与开发 查看
📦
api-design
80设计更好的 REST 和 GraphQL API
由 supercent-io
API 团队需要在实现开始之前建立一致的契约。此技能可指导资源设计、请求格式、错误、版本控制和文档编写。
编码与开发 查看
📦
api-design-framework
80设计生产就绪的 API 契约
由 ArieGoldkin
团队在设计 API 时常常存在资源、错误和版本控制不一致的问题。此技能为 REST、GraphQL、gRPC、OpenAPI 和 AsyncAPI 工作提供模式、清单和模板。
编码与开发 查看
📦
playwright-testing
86提升 Playwright 测试覆盖率
由 C0ntr0lledCha0s
当配置、定位器和 fixtures 不一致时，Playwright 测试套件可能会变得不稳定。此技能提供可靠浏览器测试、调试和可复用页面对象的实用模式。
编码与开发 查看
📦
python-fastapi-patterns
85使用可复用模式构建 FastAPI API
由 0xDarkMatter
FastAPI 项目需要在验证、依赖项、中间件和后台工作方面保持一致选择。此 skill 为 Claude、Codex 和 Claude Code 提供可复用模式，用于实用的 Python API 开发。
编码与开发 查看
📦
nestjs-code-audit
84Audit NestJS Code with Evidence-Backed Findings
由 amirtaherkhani
NestJS repositories can hide boundary flaws and runtime risks that lint results alone cannot reveal. This skill combines local evidence collection and semantic review into one prioritized report.
编码与开发 查看