Home / testany-io / testany-agent-skills · plugins/testany-eng/skills/api-reviewer/SKILL.md · GitHub

api-reviewer skillA

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

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns 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

Latest version
mdr add testany-io/testany-agent-skills/api-reviewer@git:20260914.a55b8c5
Exact content
mdr add testany-io/testany-agent-skills/api-reviewer@sha256:11e8c50e4f2cd9ad

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

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. Deterministic, no model, 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-09-24 · 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 agent 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.

More from testany-io/testany-agent-skills

AGENTS.md agents
testany-io/testany-agent-skills · AGENTS.md
git:20260924.8cef21d · audit A · 82 stars
CLAUDE.md claude
testany-io/testany-agent-skills · CLAUDE.md
git:20260914.a55b8c5 · audit A · 82 stars
skill-manager skill
testany-io/testany-agent-skills · plugins/skilldock/skills/skill-manager/SKILL.md · 打开 SkillDock 本地 GUI,浏览和管理 Codex skills、plugins 与 marketplace 来源;适用于技能库、安装更新、启禁、移除恢复的可视化管理。普通任务只需使用某个 skill 时不触发。
git:20260923.048c4b0 · audit A · 82 stars
AGENTS.md@plugins/teamdesk agents
testany-io/testany-agent-skills · plugins/teamdesk/AGENTS.md
git:20260924.789f9d4 · audit A · 82 stars
team-workspace 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
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
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
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
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
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
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
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.