plan-checker 是 GSD 工作流中的计划校验智能体,核心目标是在执行前而非执行中发现计划问题,充当规划与执行之间的质量关卡。
用途 在计划完成后、执行开始前校验计划质量,提前发现会导致执行失败或质量下降的问题;也可在计划修改后重新检查。
主要能力 校验按六个维度展开:
- 需求覆盖:从 ROADMAP.md 提取阶段目标并拆解为需求,逐项查找承接任务,标记零覆盖、多个需求共用一个模糊任务、部分覆盖等情况。
- 任务完整性:检查每个任务是否具备 Files、Action、Verify、Done 四要素;checkpoint 类任务不适用;tdd 类任务要求行为与实现、测试命令与预期结果。缺失验证或完成标准、动作过于笼统、文件列表为空均会被标记。
- 依赖正确性:解析每个计划 frontmatter 中的 depends_on,构建依赖图,检查循环依赖、引用不存在的计划、前向引用以及波次分配与依赖不一致。
- 关键链路规划:检查产物是否被真正串联,如组件是否被导入、API 是否被组件调用、数据库模型是否被 API 查询、表单提交处理是否为占位。
- 范围合理性:依据每计划任务数(目标 2-3,4 为警告,5+ 为阻塞)、文件数(目标 5-8,10 为警告,15+ 为阻塞)、上下文占用(约 50% 为目标,70% 警告,80%+ 阻塞)判断是否需要拆分。
- 验证推导:检查 must-haves 是否从阶段目标推导而来,标记与目标无关、明显需求缺失或过度具体(写成实现细节而非结果)的条目。
使用方式 检查流程为:读取 .gsd/ROADMAP.md、.gsd/REQUIREMENTS.md(如存在)及 .gsd/phases/{N}/*-PLAN.md;解析各计划的 frontmatter、must_haves 与任务元素;执行六个维度检查并收集问题;按严重级别判定状态——无 blocker 且警告不超过 2 条为 PASSED,存在任一 blocker 或 3 条以上警告为 ISSUES_FOUND;最后输出通过或失败报告,列出阻塞项、警告项与建议修复。问题以结构化格式记录维度、严重级别、描述、计划编号、任务编号与修复提示。
适用场景 适用于采用 GSD 流程、以阶段和计划组织任务的开发项目,尤其在多计划并行、依赖关系复杂或单计划范围偏大时用于提前止损。
限制 资料仅描述该智能体的校验逻辑与输出规范,未提供安装命令、运行环境要求、收费方式或与其他工具的集成细节,这些内容暂未提供。