SuperAPI AI 工具集

execute-prp

编程与开发

查看项目

更新于 10-20 09:59

技能介绍

execute-prp 是一个用于执行 PRP(Product Requirement Prompt)文件的技能,旨在从 PRP 文件实现功能并驱动开发直至每个验证门禁通过。PRP 文件由 prp-generator 技能生成,遵循其 assets/prp_template.md 模板。该技能主要依赖 PRP 中的 Implementation Blueprint(包括 Prerequisites、Implementation Steps、Error Handling Strategy、Edge Cases)、Validation Gates 和 Success Criteria 等部分。对于手写的 PRP,可能需要先将其章节映射到这些部分再执行。

使用方式:技能以 $ARGUMENTS 接收 PRP 文件路径。执行流程分为五个阶段:

  1. 加载:阅读整个 PRP,打开每个引用的文件(依据 path:line 引用)并获取 Research Findings 中列出的、与将要编写的代码相关的文档 URL。如果引用已过时(文件移动、API 变更),需找到当前等效项并记录差异。完成标志是所有引用的文件和 URL 都已打开,且每个 Prerequisite 要么已满足,要么被列为用户的阻塞项。

  2. 计划:将 Implementation Steps 转换为任务列表,每个步骤一个任务,按 PRP 顺序排列。每个 Validation Gate 增加一个最终任务。对于每个任务,指明其遵循的现有文件模式。完成标志是任务列表覆盖所有 Implementation Steps 和 Validation Gates。

  3. 实现:按顺序执行任务。每完成一步后,运行覆盖该步的最窄门禁(该步自己的测试、类型检查或对触及文件的 lint),并在继续前修复失败。在过程中应用 PRP 的 Error Handling Strategy 和 Edge Cases,而不是事后。完成标志是所有实现任务完成且其窄检查通过。

  4. 验证:按顺序原样运行 Validation Gates 下的每个命令。失败时,阅读错误,检查 PRP 的 gotchas 和错误处理说明,修复,并重新运行该门禁及之后的所有门禁。完成标志是所有门禁在单次不间断运行中均以 0 退出。

  5. 收尾:从上到下重新阅读 PRP,对照代码勾选每个 Success Criteria 项,并附上证明的文件或测试。向用户报告:哪些标准已满足(附证据),哪些门禁或标准无法满足及原因,以及所有偏离 PRP 的地方。完成标志是每个 Success Criteria 项都在报告中得到说明。

适用场景:当已有由 prp-generator 生成的 PRP 文件,需要按照其规范实现功能并确保通过所有验证时使用。限制:需要 PRP 文件存在且格式符合模板;手写 PRP 可能需要手动映射章节;技能本身不生成 PRP,需配合 prp-generator 使用。