spec-doc-review ​

用 persona reviewers 审查 requirements、plan 或 task pack 的一致性、可执行性和风险。

ASCII 链路图 ​

text
Codebase -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge
                                                |
                                                v
                                                spec-doc-review
                                                entry: spec-doc-review
                                                type: workflow command

基本信息 ​

字段内容
Skillspec-doc-review
类型workflow command
研发链路位置Review
当前入口spec-doc-review
兼容别名/spec:doc-review、$spec-doc-review
Sourceskills/spec-doc-review/SKILL.md
Governancesrc/cli/contracts/dual-host-governance/skills-governance.json（supported-host skills governance）

描述 ​

使用角色化 lens 审查 requirements、plans、task packs 或 specs。适用于改进既有规划与执行文档；默认 standard roster（≤3 reviewers），完整条件 roster 使用 roster:full。

Source 契约摘要 ​

该 source skill 未声明标准 Workflow Contract Summary 小节；本页以 frontmatter、supported-host governance 和维护者补充元数据为准。

何时使用 ​

  • 文档准备交给下一阶段前。
  • 计划、需求或 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 列表 ​

  • 这是 persona agents 的主要使用层：correctness、testing、security、performance、scope、design 等按证据触发。
  • review workflow 自身负责任务边界、合成和最终判断。

本 skill 在 source 中挂载了 8 个 skill-local 专家资产（agent 0 · persona 8），路径为 skills/spec-doc-review/references/{agents,personas}/。跨 skill 复用时，详情页按文件名去重。

名称类型摘要
spec-adversarial-document-reviewerpersonaYou challenge plans by trying to falsify them.
spec-coherence-reviewerpersonaYou are a technical editor reading for internal consistency.
spec-design-lens-reviewerpersonaYou are a senior product designer reviewing plans for missing design decisions.
spec-feasibility-reviewerpersonaYou are a systems architect evaluating whether this plan can actually be built as described and whether an implementer could start working from it without ma...
spec-product-lens-reviewerpersonaYou are a senior product leader.
spec-scope-guardian-reviewerpersonaYou ask two questions about every plan: "Is this right-sized for its goals?" and "Does every abstraction earn its keep?" You are not reviewing whether the pl...
spec-security-lens-reviewerpersonaYou are a security architect evaluating whether this plan accounts for security at the planning level.
spec-whole-doc-reviewerpersonaYou are an independent, strong generalist reviewing this entire document on a different model than the host.

agent 详情页入口仍在 /reference/agents/*；完整按 skill 归属索引见 Agents 参考。persona 目前以 skill-local prompt 形式挂在所属 skill 下，不单独生成全局详情页。

边界 ​

  • workflow 自身不是 agent。
  • dispatcher 不可用时降级为单 agent report-only fallback。

源码校准 ​

  • 本页由 website/scripts/generate-skill-detail-pages.js 从上游 source skill 生成。
  • 当前入口、兼容别名与宿主投递 metadata 来自 src/cli/contracts/dual-host-governance/skills-governance.json。
  • 当 source skill 或 governance contract 变化后，应重新运行 npm run reference:pages 并执行 npm run content:audit。