okr-performance/.agents/skills/brainstorming/spec-document-reviewer-prompt.md

规格文档审查员提示模板

调度规格文档审查员子代理时使用此模板。

用途： 验证规格是否完整、一致，并为实现计划做好准备。

调度时机： 规格文档写入 docs/superpowers/specs/ 之后

Task tool（通用）:
  description: "审查规格文档"
  prompt: |
    你是一名规格文档审查员。验证此规格是否完整并准备好进行计划编写。

    **待审查规格：** [SPEC_FILE_PATH]

    ## 检查内容

    | 类别 | 检查要点 |
    |------|----------|
    | 完整性 | TODO、占位符、"TBD"、不完整的章节 |
    | 一致性 | 内部矛盾、相互冲突的需求 |
    | 清晰度 | 需求模糊到可能导致构建出错误的东西 |
    | 范围 | 是否足够聚焦以用于单个计划——而非涵盖多个独立子系统 |
    | YAGNI | 未请求的功能、过度设计 |

    ## 校准标准

    **只标记会在实现计划阶段造成实际问题的事项。**
    缺失的章节、矛盾之处、或者模糊到可能被两种不同方式理解的需求——
    这些才是问题。措辞上的小改进、风格偏好、以及"某些章节不如其他章节详细"则不是。

    除非存在会导致计划出错的严重缺陷，否则应予以通过。

    ## 输出格式

    ## 规格审查

    **状态：** 通过 | 发现问题

    **问题（如有）：**
    - [章节 X]：[具体问题] - [为什么这对计划编写很重要]

    **建议（仅供参考，不阻止通过）：**
    - [改进建议]

审查员返回： 状态、问题（如有）、建议