用途
plan-implementation-review 是 AG Charts 的实现审查提示(Prompt),用于审查计划执行的完整程度:跟踪进度、识别缺口并验证质量。它面向 AG Charts 项目,帮助判断实现是否真正服务于计划目标,而不仅仅是完成任务。
主要能力
- 支持两种审查模式:
--quick快速进度检查(2 个代理)与--thorough全面验证(默认,4 个代理)。 - 可接受显式计划文件路径,或从上下文中自动检测近期计划。
- 检测计划创建以来的 Git 变更,包括提交记录与文件差异。
- 提取计划的核心意图(“为什么”),用于评估实现质量而非仅完成度。
- 通过并行代理进行分析:快速模式包含进度审计员与验证检查员;彻底模式包含进度审计员、缺口检测器、意图与质量验证器(关键)以及测试覆盖审查员。
- 将计划步骤与 Git 提交、修改文件、测试结果和构建状态进行交叉引用分析。
- 生成报告,包含完成度指标(总体、按章节、按步骤)、剩余工作、偏差记录和可操作的后续步骤。
- 审查结果缓存于
node_modules/.cache/plan-implementation-reviews/,用于跟踪进度。
使用方式
基本用法:
/plan-implementation-review
快速进度检查:
/plan-implementation-review --quick
指定计划文件:
/plan-implementation-review path/to/plan.md
执行分为三个阶段:
- 阶段 0:上下文收集与模式选择。加载原始计划文件,确定审查模式,检测 Git 变更,提取核心意图,识别修改文件与计划的关系。
- 阶段 1:实现分析(并行代理)。根据模式启动分析代理,加载代理提示模板,并在所有子代理提示中包含 Discovered Work Protocol。
- 阶段 2:交叉引用分析。将计划步骤映射到 Git 提交、修改文件和测试/构建结果。
- 阶段 3:报告生成。计算完成度指标,识别剩余工作,记录偏差,提供后续步骤,并汇总发现的任务。
适用场景
- 实现前:运行
/plan-review验证计划。 - 实现过程中:定期运行
/plan-implementation-review跟踪进度。 - 实现后:运行完整测试套件和文档审查。
限制
- 该技能面向 AG Charts 项目,依赖其仓库结构、Git 历史与构建/测试命令(如
yarn nx test ag-charts-community、yarn nx build:types、yarn nx lint)。 - 需要可访问计划文件、Git 仓库以及相关子文档(agent-prompts.md、output-format.md、discovered-work.md)。
- 测试结果与构建状态检查仅在可用时执行。
- 具体代理数量、缓存路径和命令行为以实际项目配置为准;其他项目使用可能需要适配。