api-reviewer SKILL.md skillA

api-reviewer from testany-io/testany-agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add testany-io/testany-agent-skills/api-reviewer@git:20260914.a55b8c5

Pins git:20260914.a55b8c5 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
testany-io/testany-agent-skills
Path
plugins/testany-eng/skills/api-reviewer/SKILL.md
Versions recorded
5
Latest version
git:20260914.a55b8c5, committed Sep 14, 2026
First version recorded
Jan 18, 2026
Size
10,320 bytes
Repository stars
82
License
MIT

API contract review, 接口契约评审。Use when: PRD 完成后、HLD/LLD/实现前需要审查完整契约或既有批准范围内的契约增量,包括 OpenAPI/AsyncAPI/GraphQL/gRPC/WebSocket/SSE/Webhook/SDK/文件格式/IPC-CLI 契约。.

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 Reviewer - 接口契约审查专家

执行前读取 [工作流执行约定](../../references/workflow-execution.md):先取证再提问、按实际工具能力回退,并从本次安装位置定位资源。

评审先读取 [证据、准出与复审规则](../../references/review-assurance.md)。P2 不按数量阻断;缺证据不等于产品缺陷;提前门禁失败不取消独立安全检查;完成本轮评审不等于批准工件。

> **语言规则**:默认跟随用户输入语言;用户显式指定时以用户指定为准;不要因为本 `SKILL.md` 是中文而强制输出中文;`TRACEABILITY-METADATA` 的字段名、枚举值、ID、comment markers 始终保持英文。若本 skill 使用模板或派发子任务,继续传递同一个 `output_language`。详见 `../../references/language-policy.md`。

你是专业的接口契约审查专家,负责模拟真实的 Contract Review,确保契约达到「准出」标准并可作为单一事实源。

## 核心定位

**验证契约质量与对齐,而非重新设计。**

- ✅ 验证 Contract 与 PRD/边界确认一致
- ✅ 检查协议完整性、错误语义、兼容性与演进策略
- ✅ 识别与既有接口/事件/SDK 的冲突与重复造轮子
- ❌ 不替代业务/架构决策
- ❌ 不在审查中改写 Contract

## 先选工作模式

- `formal_design`:用户要求完整新功能文档或正式全量准出,执行下文完整流程、模板、追溯和适用门禁。
- `bounded_change`(`amendment`):对已有工件的有限增量,读取 [有限增量规则](../../references/document-amendments.md),检查受影响行为、授权、兼容性及直接依赖;只给该范围的结论,不签全量证书。整改 delta 仍须满足可靠完整初审的复用条件。
- 模式由实际职责、信任、契约、失败语义与批准范围决定,不按行数/文件数判断。“两行修改”改变权限边界仍需对应有权 Owner 决策。

下文全量模板、全局覆盖矩阵与整套前置文档是 `formal_design` 的要求;有限增量沿用既有工件格式、有效批准及相关追溯,不因缺某种历史文件格式自动改成新项目启动。

核对兼容性时,若已提供本轮直接消费者的实现或验证证据,实际读取相关部分与契约差异、示例交叉核对,
不能只列文件名或以“已声明兼容”代替这项核查。缺少必要工具不取消可独立完成的读取;本轮必要的消费者证据
不可得时保留相关缺口,不虚称已核验。不要求全新契约先有消费者实现,也不扩成全仓源码评审或强制执行未授权代码。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add testany-io/testany-agent-skills/api-reviewer@sha256:11e8c50e4f2cd9ad

The line at the top of this page pins the label git:20260914.a55b8c5, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_rnrsan2ywsrfml2q.svg)](https://markdownregistry.com/a/art_rnrsan2ywsrfml2q)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jan 18, 2026 and Sep 14, 2026, about one every 60 days.

versioncommittedcommitsizeaudit
git:20260914.a55b8c5 latest2026-09-14 a55b8c5 10,320 BA view · diff
git:20260331.40884ae2026-03-31 40884ae 7,810 BA view · diff
git:20260307.f7f51c12026-03-07 f7f51c1 6,738 BA view · diff
git:20260121.98ba0de2026-01-21 98ba0de 6,736 BA view · diff
git:20260118.d6cd0672026-01-18 d6cd067 6,832 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10320 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

GitHub

testany-io/testany-agent-skills · 82 stars · license MIT · pushed 2026-10-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_rnrsan2ywsrfml2q
GET https://markdownregistry.com/api/v1/resolve?ref=testany-io/testany-agent-skills/api-reviewer
GET https://markdownregistry.com/api/v1/blob/11e8c50e4f2cd9ad5f053535b906a9921a98afc23b3c2cd7f246b9f498c27d5e

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 testany-io/testany-agent-skills

AGENTS.md AGENTS.md file
testany-io/testany-agent-skills · AGENTS.md
git:20261012.a12f7a7 · audit A · 82 stars
CLAUDE.md CLAUDE.md file
testany-io/testany-agent-skills · CLAUDE.md
git:20261012.a12f7a7 · audit A · 82 stars
skill-manager SKILL.md skill
testany-io/testany-agent-skills · plugins/skilldock/skills/skill-manager/SKILL.md · 打开 SkillDock 本地 GUI,浏览和管理本机 Codex 与 Claude 的 skills、plugins 与 marketplace 来源;适用于技能库、安装更新、启禁、移除恢复的可视化管理。普通任务只需使用某个 skill…
git:20261013.5055ec7 · audit A · 82 stars
AGENTS.md@plugins/teamdesk AGENTS.md file
testany-io/testany-agent-skills · plugins/teamdesk/AGENTS.md
git:20260924.789f9d4 · audit A · 82 stars
team-workspace SKILL.md skill
testany-io/testany-agent-skills · plugins/teamdesk/skills/team-workspace/SKILL.md · Open and operate TeamDesk, a local AI team workspace built on existing Codex tasks. Use for 打开 AI 团队工作台、创建或绑定 AI…
git:20260924.4350616 · audit A · 82 stars
testany-sync-case-env-from-source SKILL.md skill
testany-io/testany-agent-skills · plugins/testany-bot/skills/SKILL.md · 从 OpenAPI 生成的 Testany case 源代码中自动识别入参和出参,并同步到 case 的环境变量列表中。适用于源代码存储在需要认证的 Git 仓库(如 Bitbucket)的场景。
git:20260914.a55b8c5 · audit A · 82 stars
testany-case-writing SKILL.md skill
testany-io/testany-agent-skills · plugins/testany-bot/skills/testany-case-writing/SKILL.md · Testany platform case 编写助手 - 将传统测试场景拆解为 Testany platform cases,并生成可注册的 case packages
git:20260914.a55b8c5 · audit A · 82 stars
testany-case SKILL.md skill
testany-io/testany-agent-skills · plugins/testany-bot/skills/testany-case/SKILL.md · Testany platform case 注册与 CRUD - 将已准备好的 platform case package 注册到平台,并管理 metadata、脚本与生命周期
git:20260914.a55b8c5 · audit A · 82 stars
testany-debug SKILL.md skill
testany-io/testany-agent-skills · plugins/testany-bot/skills/testany-debug/SKILL.md · 分析 Testany 测试失败原因 - 排查问题、查看日志、定位根因;处理签名日志前先单独加载本 skill,勿回显原始请求。
git:20260914.a55b8c5 · audit A · 82 stars
testany-execution SKILL.md skill
testany-io/testany-agent-skills · plugins/testany-bot/skills/testany-execution/SKILL.md · Testany execution 观测与管理 - 查看进度、查询历史、刷新状态、取消未开始执行、将失败执行交给 debug
git:20260914.a55b8c5 · audit A · 82 stars
testany-guide SKILL.md skill
testany-io/testany-agent-skills · plugins/testany-bot/skills/testany-guide/SKILL.md · Testany 平台核心概念和配置参考
git:20260914.a55b8c5 · audit A · 82 stars
testany-import-git SKILL.md skill
testany-io/testany-agent-skills · plugins/testany-bot/skills/testany-import-git/SKILL.md · Testany Git 导入:把 Git 仓库里的测试脚本批量注册成 Testany platform cases,并持续同步、切 commit、演化 binding、配 webhook
git:20260914.a55b8c5 · audit A · 82 stars

Every file in testany-io/testany-agent-skills

Browse by kind, by grade A, or by owner.