api-contract-testing SKILL.md skillA
api-contract-testing from naodeng/awesome-qa-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add naodeng/awesome-qa-skills/api-contract-testing@git:20260829.175e380Pins git:20260829.175e380 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- naodeng/awesome-qa-skills
- Path
skills/zh/testing-types/api-contract-testing/SKILL.md- Versions recorded
- 2
- Latest version
- git:20260829.175e380, committed Aug 29, 2026
- First version recorded
- Aug 29, 2026
- Size
- 3,061 bytes
- Repository stars
- 279
- License
- a license file GitHub does not identify
Use this skill when you need to verify API contract compatibility, consumer expectations, and schema change risk; triggers include API 契约测试 and API contract testing.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# API 契约测试（中文版） ## 何时使用 - 需要验证 API 提供方与消费方在 schema、语义、兼容性和演进策略上的契约一致性。 - 需要对现有方案、结果或证据做风险评审，并形成可执行改进项。 - 输入不完整，但仍需先给出带假设和信息缺口的可用初版。 ## 输出格式选项 - 默认输出 Markdown，适合评审、执行和持续补充。 - 用户要求表格、CSV、JSON 或工单格式时，保留同样的风险、证据、优先级和边界字段。 - 若输出会进入自动化流程，先确认字段 schema、枚举值和必填项。 ## 如何使用 1. 先阅读并遵循 `prompts/api-contract-testing.md` 的输入、执行规则、最低覆盖清单和输出顺序。 2. 补充真正影响判断的范围、环境、版本、限制、证据和成功标准。 3. 先做输入审计，再区分已确认事实、合理假设和待确认问题。 4. 按风险和证据强度排序，产出可直接执行、评审或验证的结果。 5. 信息不足时不要停在提问：先交付受限初版，并说明哪些结论暂不能成立。 ## 参考文件 - 每次执行必须读取 `prompts/api-contract-testing.md`；它是本 Skill 的完整执行规范。 - 需要评测或回归本 Skill 时，读取 `evals/eval.yaml` 与匹配的 `evals/cases/` 用例。 - 只有目录实际存在且任务需要时，才读取 `references/`、`examples/`、`scripts/` 或 `output-formats.md`，不要假设不存在的资产。 ## 核心约束 - 契约不仅是 schema，还包括语义和错误行为 - 不凭样例推断完整契约 - 破坏性变更必须给迁移路径 - 不编造输入中不存在的系统行为、字段、数据、指标或根因。 - 关键结论必须关联证据；证据不足时标记为假设并给出验证方法。 - 优先级必须说明业务影响、发生可能性或可探测性依据。 ## 交付前自检 - [ ] 已覆盖：字段与类型、必填和可空、枚举、状态码、错误体、兼容性、版本演进、消费者影响。 - [ ] 已区分事实、假设、缺口和建议。 - [ ] 高风险项有明确优先级、证据、负责人或下一步。 - [ ] 输出包含可验证的判断标准，而非泛泛而谈。 - [ ] 未执行未经授权的生产写操作或破坏性动作。 ## 常见误区 - 只列检查点，不说明输入条件、预期结果或证据。 - 把所有事项都标为高优先级，失去取舍价值。 - 用工具名或通用理论替代领域判断。 - 输入不完整时直接拒绝，或反过来假装结论已经确定。 ## 最佳实践 - 从最可能造成业务损失、安全问题或发布阻塞的路径开始。 - 用最小可验证实验缩小不确定性，并记录复现条件。 …
Read the whole file at its exact version.
How to install
mdr add naodeng/awesome-qa-skills/api-contract-testing@sha256:f23ad31163b3dae2The line at the top of this page pins the label git:20260829.175e380, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_kci35cbib5mpocrr)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, all committed on Aug 29, 2026.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260829.175e380 latest | 2026-08-29 | 175e380 | 3,061 B | A | view · diff |
| git:20260829.30ae153 | 2026-08-29 | 30ae153 | 363 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (3061 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
naodeng/awesome-qa-skills · 279 stars · license a license file GitHub does not identify · pushed 2026-10-22 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_kci35cbib5mpocrr GET https://markdownregistry.com/api/v1/resolve?ref=naodeng/awesome-qa-skills/api-contract-testing GET https://markdownregistry.com/api/v1/blob/f23ad31163b3dae24ad60703ebb69e87c7e7c6cc1eb662b5c9208dc2a3564795
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from naodeng/awesome-qa-skills
Every file in naodeng/awesome-qa-skills