关于 ds-plan-loop
ds-plan-loop 是一项编码技能,用于制定可检查、可修订的计划,并逐步执行和验证。它适合需要先规划再实施任务的编码 Agent。
主要功能
- 01重述目标并检查相关文件
- 02制定带验收检查的编号步骤
- 03将计划保存到文件
- 04审阅计划并修正假设
- 05完成步骤时记录证据
适用场景
- 01规划多步骤代码修改
- 02将工作拆分为可验证的差异
- 03跨会话恢复工作
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ aicodeking/ deepseek-stack --skill ds-plan-loop安装后在 Claude Code 中输入/ds-plan-loop确认已加载。
详细介绍
ds-plan-loop
先规划,再编码;检查一次计划,然后一次完成一个经过验证的步骤。
步骤
- 用一句话重述目标。列出预计要修改的文件和执行的命令。规划前先阅读这些文件。不要凭记忆规划。
- 编写带编号的计划。每一步只包含一个操作和一项验收检查,且检查结果可通过命令或直接观察确认,例如“
npm test -- auth通过”或“GET /health返回 200”。每一步都要足够小,能在单个差异中验证。 - 将计划写入文件(PLAN.md,或 ds-context-reset 中的 PROGRESS.md),以便后续步骤和新会话能够读取。
- 以全新的视角审查计划。只重新阅读目标和计划,像一位没有参与编写的审查者那样进行检查。如果可以,请在子 Agent 或新会话中进行审查。回答以下三个问题:
- 哪一步缺失了(设置、迁移、配置、测试、清理)?
- 哪个假设尚未根据代码或文档核实?
- 有没有更简单的路径,可以用更少的步骤达到同样的目标?
- 修订计划。现在通过阅读代码或运行命令来检查每个有风险的假设。不要把未经核实的猜测带入计划。
- 仅执行第 1 步。运行验收检查并阅读实际输出。如果检查失败,使用 ds-verify-loop。
- 在计划文件中标记该步骤已完成,并附上证据(命令和结果)。然后继续下一步。
- 如果某一步表明计划有误,请停止并修订剩余步骤,然后再继续。不要临时应对。
停止条件
- 所有步骤均已标记完成,且检查均通过;端到端检查后,原始目标仍然成立。
- 已完成 2 轮审查。第三轮几乎不会发现新问题,因此开始执行。
- 某一步的检查连续失败 2 次。切换到 ds-unstick。
规则
- 每一步都必须有检查。“看起来没问题”不算检查。
- 每个差异只做一个步骤。不要为了节省时间而合并步骤。
- 不要添加目标不需要的步骤。
- 计划要简短:约 3-10 步。较大的工作要拆分为多个计划。
评论
支持 Markdown