dataelement 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/mediumISSUE → 修复后重新审查（最多 2 轮） lowISSUE → 记录但跳过- 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"，停止