SuperAPI AI 工具集

plan-implementation-review

编程与开发

查看项目

更新于 10-15 10:10

技能介绍

用途

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)。
  • 测试结果与构建状态检查仅在可用时执行。
  • 具体代理数量、缓存路径和命令行为以实际项目配置为准;其他项目使用可能需要适配。