关于 rpi-implement
这是一项用于在现有代码库中落实已批准技术计划的 Agent Skill。它按阶段实施并在计划文件中跟踪任务,检查成功标准;遇到手动验证时会暂停等待用户确认。
主要功能
- 01查找或读取指定计划
- 02完整阅读计划及引用文件
- 03用复选框跟踪任务状态
- 04验证各阶段成功标准
- 05暂停并等待手动验证
适用场景
- 01落实已批准的分阶段技术计划
- 02从计划中首个未完成任务继续
- 03报告计划与代码库不符之处
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ maibornwolff/ acf-research-plan-implement-skills --skill rpi-implement安装后在 Claude Code 中输入/rpi-implement确认已加载。
详细介绍
实施计划
你需要实施一份已批准的技术计划。这些计划包含多个阶段,每个阶段都列出了具体变更和成功标准。
开始
如果用户提供了计划路径,请直接继续。如果没有提供计划路径,请检查 docs/agents/plans/ 中最新的计划。如果没有找到,请向用户索要路径。
拿到计划后:
- 完整阅读计划,并检查是否已有勾选项(
- [x]) - 阅读计划中提到的所有文件
- 完整阅读文件——绝不要使用 limit/offset 参数,你需要完整的上下文
- 深入思考各部分如何相互配合
- 如果你理解了需要完成的工作,就开始实施
- 将正在处理的任务标记为
[-],将已完成的任务标记为[x](优先使用此方式,而不是任务列表工具)
任务跟踪
计划文件同时也是状态跟踪器。每完成一项任务,都必须立即更新复选框。也要标记正在处理的任务:
[ ]- 尚未开始[-]- 进行中(开始前更新)[x]- 已完成(任务成功测试后立即更新)。对于手动验证步骤,只有在用户确认后才能标记为[x]。
实施原则
计划经过了周密设计,但实际情况可能很复杂。你的工作是:
- 遵循计划的意图,并根据实际情况灵活调整
- 完整实施每个阶段后再进入下一阶段
- 验证你的工作在更广泛的代码库上下文中是否合理
如果实际情况与计划不完全一致,请思考原因并清楚地说明。计划是你的指引,但你也需要运用判断力。
如果遇到不匹配:
- 停下来,深入思考为何无法按计划执行
- 清楚地说明问题:
Issue in Phase [N]: Expected: [what the plan says] Found: [actual situation] Why this matters: [explanation] How should I proceed?
验证方法
实施完一个阶段后:
- 运行计划中列出的成功标准检查(测试命令、代码检查工具、类型检查器等)
- 修复所有问题后再继续
- 如果该阶段包含手动验证步骤,请暂停并告知用户:
Phase [N] Complete - Ready for Manual Verification Automated verification passed: - [List automated checks that passed] Please perform the manual verification steps listed in the plan: - [List manual verification items from the plan] Let me know when manual testing is complete so I can proceed to Phase [N+1]. - 继续下一阶段(除非另有明确指示)
在用户确认之前,不要勾选手动测试步骤。
所有阶段全部完成后,向用户提供摘要以供验证。
遇到阻碍时
遇到问题时:
- 首先,确保你已阅读并理解所有相关代码
- 考虑代码库是否已在计划编写后发生变化
- 清楚地说明不匹配之处并寻求指导
谨慎使用子 Agent——主要用于有针对性的调试或探索不熟悉的领域。
恢复工作
如果计划中已有勾选项:
- 相信已完成的工作已经完成
- 从第一个未勾选的项目开始
- 只有在发现异常时才验证之前的工作
请记住,你是在实施解决方案,而不仅仅是勾选复选框。牢记最终目标,持续推进。
评论
支持 Markdown