Menú
从测试视角审查设计文档的完整性与精炼度，检查 API 定义、错误处理、配置格式、业务规则、跨文档一致性等维度
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
| name | doc-review |
| description | 从测试视角审查设计文档的完整性与精炼度，检查 API 定义、错误处理、配置格式、业务规则、跨文档一致性等维度 |
| when_to_use | 当用户希望检查设计文档是否足够完整，能支撑测试团队编写和执行用例 |
| argument-hint | ["doc_dir"] |
| arguments | ["doc_dir"] |
| user-invocable | true |
| allowed-tools | Read Glob Grep |
| effort | high |
审查 $doc_dir 目录下的设计文档，从测试视角评估其完整性和精炼度。未传 $doc_dir 时，默认审查当前 workspace 的 docs/ 目录。
读取 $doc_dir 下所有文件，将每份文档分类为：
每个维度给出评分：
对文档中提到的每个 API 端点检查：
常见缺口：迭代文档新增了字段但从未汇总成完整 Schema；字段只列了名字没标必填/可选/默认值；响应结构只有文字描述没有结构化定义。
对文档中涉及的每个外部依赖（缓存、下游服务、文件系统等）检查：
常见缺口：只描述了正常流程；"读 Redis"但没说 Redis 不可用或 key 不存在时怎么办；下游服务故障完全未提及。
对文档中提到的每个配置文件、数据文件、数据存储检查：
常见缺口："从配置读取"但没给配置结构；"存入 Redis"但没给 Key 格式；引用了特征字段数量但没列出字段名。
对文档中的每条业务规则检查：
常见缺口："按条件过滤"但没列出条件；"按优先级排序"但没定义优先级计算方式；区间表示不明确。
常见缺口：总览文档仍然描述迭代前的行为；迭代文档说"改 X 为 Y"但总览还写着 X；同一概念在不同文档中命名不同。
常见缺口：管理接口只在表格中列了一行但无任何详细定义；测试基础设施接口（初始化数据、查询结果）完全没有文档。
# 文档审查报告
## 文档盘点
（文档列表及分类）
## 维度评分
| 维度 | 评分 | 关键缺口 |
|------|------|----------|
| API 契约完整性 | PASS/PARTIAL/MISSING | ... |
| 错误处理与降级 | PASS/PARTIAL/MISSING | ... |
| 配置与数据格式 | PASS/PARTIAL/MISSING | ... |
| 业务规则精确度 | PASS/PARTIAL/MISSING | ... |
| 跨文档一致性 | PASS/PARTIAL/MISSING | ... |
| 辅助接口覆盖 | PASS/PARTIAL/MISSING | ... |
| 精炼度与可读性 | PASS/PARTIAL/MISSING | ... |
## 详细发现
（对每个 PARTIAL/MISSING 维度，列出具体缺口：
- 缺什么
- 应该补充在哪份文档中
- 补充后应该长什么样（给出示例片段））
## 优先修复项
（按影响面排序的 Top 5 待修复项，说明：
1. 修复后能解锁多少测试场景
2. 补充的工作量大小）
从 target-aware case suite、task manifest 或 target/module/all selector 生成 pytest，执行 profile gate、Case IR、freshness check，并处理少量 UNPARSED 补写
构建模块级 fixture/module profile 或用例级 suite profile，把 Markdown 用例接入 test-codegen 管线
从已验证 pytest、Case IR 和 profile 中识别可沉淀模式，评估是否晋升为 assertion_rules、case_flows、fixture helper 或 emitter 规则
基于测试知识库和测试规范，为指定模块或需求 suite 生成 Markdown 用例和 mismatch 记录
测试资产维护分诊台：诊断项目当前状态，定位管线断裂层，路由到正确的 skill 或 CLI 命令
将外部/历史/公司测试平台用例迁移为 AITest Markdown suite 用例，并保留语义追溯、阻塞分类和人工 review 清单