GSD Plan Checker 是 GSD(Get Shit Done)工作流中的计划校验智能体,核心目标是在执行之前而非执行过程中发现问题,充当规划与执行之间的质量门禁。
用途 它读取 .gsd/ROADMAP.md 中的阶段目标、.gsd/REQUIREMENTS.md(如存在)以及 .gsd/phases/{N}/*-PLAN.md 中的所有计划,对计划进行系统性校验,判断其是否具备可执行性,避免在执行阶段才暴露结构性问题。
主要能力 校验围绕六个维度展开:
- 需求覆盖:从路线图提取阶段目标并拆解为需求,检查每条需求是否有任务覆盖,标记零覆盖、多条需求共用模糊任务、部分覆盖等问题。
- 任务完整性:按任务类型检查 Files、Action、Verify、Done 要素是否齐全;auto 类型四项均需提供,tdd 类型需包含行为与实现、测试命令和预期结果,checkpoint 类型不适用。缺失验证或验收标准、动作描述模糊、文件列表为空均会被标记。
- 依赖正确性:解析计划前置元数据中的 depends_on,构建依赖图,检测循环依赖、引用不存在的计划、未来引用以及 wave 分配与依赖不一致等问题,并依据依赖规则推算最小 wave。
- 关键衔接规划:检查产物是否被串联而非孤立创建,例如组件是否被导入、API 路由是否被组件调用、数据库模型是否被查询、表单是否有真实的提交处理、状态是否被渲染。
- 范围合理性:依据每计划任务数、文件修改数和上下文占用阈值,识别任务过多、文件过多、复杂工作堆叠在单个计划中的情况并建议拆分。
- 验证推导:检查必达项是否由阶段目标推导而来,标记与目标无关、明显缺漏或过度指定实现细节的必达项。
使用方式 在 /plan 完成后、/execute 开始前,或计划被修改后运行。执行时先加载上下文并解析各计划的元数据、必达项和任务元素,随后逐维度检查并收集问题,最后判定状态:无阻断项且警告不超过 2 条为 PASSED,否则为 ISSUES_FOUND。输出采用统一的问题格式,包含维度、严重级别、描述、所属计划、任务编号和修复提示;严重级别分为 blocker(将导致执行失败,执行前必须修复)、warning(质量或效率风险,建议修复但可继续)和 info(仅观察,无需处理)。
适用场景与限制 适合采用 GSD 规划流程、按阶段和计划组织任务的开发项目,用于在编码前做结构化审查。其检查依赖 .gsd 目录下的路线图、需求与计划文件及约定格式;资料未说明其独立安装方式、运行时依赖或与其他工具的集成细节,这些方面暂未提供。