spec-doc-review
用 persona reviewers 审查 requirements、plan 或 task pack 的一致性、可执行性和风险。
基本信息
| 字段 | 内容 |
|---|---|
| Skill | spec-doc-review |
| 类型 | workflow command |
| 研发链路位置 | Review |
| 入口 | /spec:doc-review / $spec-doc-review |
| Source | skills/spec-doc-review/SKILL.md |
描述
Review requirements, plan, or task-pack documents using persona reviewers that surface role-specific issues. When reviewer dispatch is available, run bounded parallel reviewers; when dispatch is unavailable, explicitly disabled, or unsafe, fall back to a single-agent report-only review instead of bypassing host boundaries.
何时使用
- 文档准备交给下一阶段前。
- 计划、需求或 task pack 可能有歧义、scope creep 或安全/设计缺口。
- 需要 headless 或 interactive 文档审查。
工作步骤
- 读取 diff、PR、文档、计划、task pack 或专项审查输入。
- 按风险域选择 always-on 与 conditional reviewer personas。
- 合并、去重和校准 findings，区分 safe_auto、gated_auto、manual 和 advisory。
- 输出修复、残留风险或下一步处理建议。
输出
- review findings、safe_auto fixes、residual risks、audit report 或 release checklist。
- 当 reviewer dispatch 不可用时，输出明确的 report-only fallback 覆盖说明。
Agent 调度
- 这是 persona agents 的主要使用层：correctness、testing、security、performance、scope、design 等按证据触发。
- review workflow 自身负责任务边界、合成和最终判断。
边界
- workflow 自身不是 agent。
- dispatcher 不可用时降级为单 agent report-only fallback。