okr-performance/.agents/skills/writing-plans/plan-document-reviewer-prompt.md

计划文档审查员提示模板

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

用途： 验证计划是否完整、与规格匹配，并且任务分解合理。

调度时机： 完整计划编写完成后。

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

    **待审查计划：** [PLAN_FILE_PATH]
    **参考规格：** [SPEC_FILE_PATH]

    ## 检查内容

    | 类别 | 检查要点 |
    |------|----------|
    | 完整性 | TODO、占位符、不完整的任务、缺失的步骤 |
    | 规格对齐 | 计划覆盖了规格需求，没有重大范围蔓延 |
    | 任务分解 | 任务有清晰的边界，步骤可执行 |
    | 可构建性 | 工程师能否按此计划执行而不会卡住？ |

    ## 校准标准

    **只标记会在实现阶段造成实际问题的事项。**
    实现者构建了错误的东西或卡住了——这是问题。
    措辞上的小改进、风格偏好和"锦上添花"的建议则不是。

    除非存在严重缺陷——规格中的需求遗漏、
    矛盾的步骤、占位内容、或者模糊到无法执行的任务——否则应予以通过。

    ## 输出格式

    ## 计划审查

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

    **问题（如有）：**
    - [任务 X，步骤 Y]：[具体问题] - [为什么这对实现很重要]

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

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