sdd-review

name	sdd-review
description	对 BiSheng 项目的 SDD 文档执行审查。

SDD Review Skill

调用方式

/sdd-review <feature_dir> <doc_type>

例：

/sdd-review features/v2.5.0/004-rebac-core spec
/sdd-review features/v2.5.0/001-multi-tenant tasks

审查流程

第一步：解析参数

从用户输入或调用上下文中提取：

• feature_dir：特性目录路径（如 features/v2.5.0/004-rebac-core）
• doc_type：文档类型，必须是 spec / design / tasks

若参数缺失或无效，向用户报告错误后停止。

---

spec 模式（辅助审查，不自动推进）

spec.md 合并了需求规范和技术设计，因此 spec 审查同时覆盖需求覆盖和架构合规检查。

第二步（spec）：执行合并审查

读取文件：

• <feature_dir>/spec.md（已写的规格文档）
• spec.md 中"关联 PRD"字段指向的文件（若未标注，读取 docs/PRD/ 下与特性名最相关的文件）
• features/v2.5.0/release-contract.md（不变量约束，确认 spec 未越界）
• docs/architecture/02-backend-modules.md（后端模块架构）
• docs/architecture/10-permission-rbac.md（权限体系）

按 references/spec-checklist.md 中的检查清单执行 14 项检查。

第三步（spec）：展示报告，等待用户确认

向用户展示分析结果：

• 无 gap / 无问题：告知"审查通过，可继续确认"
• 有 gap / 有问题：展示每个问题（MISSING / FORMAT / CONFLICT / ISSUE），供用户决定是否修改

等待用户确认（唯一手动暂停点）。用户确认后，将 <feature_dir>/tasks.md 状态表中 spec.md 行更新为 ✅ 已评审。

---

design 模式（辅助审查，不自动推进）

design.md 是"现状快照 + 关键决策"文档，决定新 agent 接手时能否在不读代码情况下快速建立认知。审查重点是接手测试四要素：现状、决策、坑、契约。

第二步（design）：执行审查

读取文件：

• <feature_dir>/design.md（已写的设计文档）
• <feature_dir>/spec.md（校验 design 没偏离需求）
• <feature_dir>/tasks.md（若存在；校验偏差记录已回写）
• features/_templates/design.md（模板结构基线）
• features/v{X.Y.Z}/release-contract.md（关键约束、不变量）

按 references/design-checklist.md 中的检查清单执行 24 项检查。

第三步（design）：展示报告，等待用户确认

向用户展示分析结果：

• 无问题：告知"审查通过，可继续确认"
• 有问题：展示每个问题（ISSUE 含 SEVERITY 和 LOC），供用户决定是否修改

等待用户确认（唯一手动暂停点）。用户确认后，将 <feature_dir>/tasks.md 状态表中 design.md 行更新为 ✅ 已评审（若状态表尚无该行，提示用户补一行 | design.md | 🔲 草稿 | ... |）。

---

tasks 模式（自动审查）

第二步（tasks）：执行审查

读取文件：

• <feature_dir>/tasks.md
• <feature_dir>/spec.md（验收标准 + 技术方案）
• features/v2.5.0/release-contract.md（领域归属 + 不变量）

按 references/tasks-checklist.md 中的检查清单执行 21 项检查。

第三步（tasks）：处理审查结果

输出格式：

• 有问题：ISSUE: <描述> | SEVERITY: high/medium/low | TASK: <T-NN 若适用>
• 无问题：LGTM

处理逻辑：

• LGTM → 更新 <feature_dir>/tasks.md 状态表，将 tasks.md 行改为 ✅ 已拆解
• 有 high/medium ISSUE → 修复后重新审查（最多 2 轮）
• low ISSUE → 记录但跳过
• 2 轮后仍有 high/medium → 停止，向用户报告剩余问题

错误处理

• feature_dir 不存在 → 报告路径错误，停止
• doc_type 不是 spec / design / tasks → 报告参数错误，停止
• spec.md 不存在 → 报告"找不到 spec.md，请先完成 spec"，停止
• design.md 不存在（design 模式）→ 报告"找不到 design.md，请先按 features/_templates/design.md 完成 design"，停止
• tasks.md 不存在（tasks 模式）→ 报告"找不到 tasks.md，请先完成 tasks"，停止