pdlc-loop-run
收敛循环引擎(自动推进 tdd→implement→review 到 review_done 或 blocked)
Install
npx skills add https://github.com/kanfu-panda/pdlc-skills/tree/main/skills/pdlc-loop-run
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install kanfu-panda-pdlc-skills@llmmart
git clone https://github.com/kanfu-panda/pdlc-skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole kanfu-panda/pdlc-skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
收敛循环引擎(loop-run)
把机械收敛段 tdd → implement → review 烧成一个自主循环:从 current_stage 出发逐阶段自动推进,直到 review_done 或被 blocked。这是 /pdlc-loop-next 之上的高层引擎——用户不必自己写 bash 循环。
非交互模式(--autonomous)
若本命令的参数含 --autonomous,本命令进入无人值守模式,按以下规则处理原本需要人应答的交互点。参数是唯一真源:不带 --autonomous 即为交互模式,一切照旧正常询问用户;绝不回读状态机 run_mode 兜底(「掉出 autonomous」是安全的失败方向)。
- 流程性确认(如「测试已绿是否继续」「是否覆盖已有文件」)→ 不询问,按预设默认前进,并把决策追加到状态机
history[].auto_decisions[](写状态机的命令:推进时给状态推进脚本传--decision "<确认点描述>=<所选默认>",可重复;脚本写成下面的样子):{ "point": "<确认点描述>", "chose": "<所选默认>", "at": "<ISO 8601>" } - 真需人判断(PRD 关键取舍、评审「需人工确认」项、真实循环依赖、测试与设计 / PRD 矛盾等无法安全默认的点)→ 不猜。
改测试、改检查命令让它变绿,永远不是「流程性默认」,不能记成
--decision:current_stage保持不变(不推进)- 写
last_phase_result.ok = false且blocked_reason = "<原因>"(写状态机的命令:给状态推进脚本传--blocked "<原因>") - 末行输出哨兵:
<<<PDLC blocked reason="<原因>">>> - 立即结束命令,交还人类
- 守卫拦截也走这一条:前置守卫(缺设计文档、缺测试、测试没红等)在
--autonomous下拦住本命令时, 不能只输出 ⛔ 就停——同样写ok=false+blocked_reason(写明哪条守卫、缺什么)并输出哨兵。 否则状态机里仍是上一阶段的ok=true,循环驱动只看到current_stage没动,会把「被拦」误报成「卡住」,真实原因丢失。
- 破坏性操作(发布 / 部署 / 打 tag / 触发 CI / DROP / force-push 等不可逆·外发操作)→
--autonomous无效,仍必须人工显式确认。 - 顺手的 sidecar 产物(如缺失时创建
CHANGELOG.md、补全文档 PDLC-TRACE 的创建时间等本阶段职责内、可安全默认的辅助改动)→ 视为流程性默认,直接做并记入auto_decisions[];这类改动不新增外部副作用,不属破坏性操作。
进入 autonomous 模式时,在状态机顶层写
run_mode: "autonomous"仅供留痕(复盘区分人工 vs 循环产出)。
⛔ 终态即
review_done(设计如此):本引擎只覆盖机械收敛段。到达review_done即成功停机,交人工决定是否/pdlc-ship。绝不自动进入pdlc-ship/pdlc-deploy——发布/部署是不可逆·外发操作,永远留人(--autonomous对它们无效)。prd/design 的关键取舍同样不在本引擎范围内。
两种运行形态
- 默认推荐 · 外部 Runbook(真进程隔离):长跑 / 过夜 / 多 feature 并行时,用独立进程逐轮跑,每轮全新进程 = 真 fresh context 最可信。本命令可打印该 Runbook 脚本(见 usage-guide「自主循环 Runbook」)。
- 便捷 · 插件内 Task 版(本命令默认行为):适合短收敛。每个 stage 派发给一个 fresh Task subagent(context 相对隔离),返回后读状态机决定推进 / 停 / block。
多个功能 / 并行:用驱动脚本
一次要推多个功能、要并行、或要长跑过夜时,不要自己写外层循环——用随本 skill 分发的驱动脚本
scripts/pdlc-loop.sh(在本 skill 目录下)。它就是上面说的外部 Runbook 形态,护栏与下面的 Task 版一致:
# 先看决策,不花钱
bash <本 skill 目录>/scripts/pdlc-loop.sh F20260924-100000 F20260924-110000 --platform claude --dry-run
# 真跑:claude 平台必须给每次调用的预算上限
bash <本 skill 目录>/scripts/pdlc-loop.sh F20260924-100000 F20260924-110000 --platform claude --max-budget-usd 5
# 所有处于收敛段、未阻塞的功能,两个一起跑(每个功能一个 git worktree)
bash <本 skill 目录>/scripts/pdlc-loop.sh --ready --platform claude --max-budget-usd 5 --parallel 2
# 看进度(/pdlc-status 也会显示)
bash <本 skill 目录>/scripts/pdlc-loop.sh --status
--platform claude|codex:每一步用claude -p或codex exec起一个全新进程--platform custom --cmd '<模板>':其它 CLI,每一步执行展开后的模板,占位符{stage}/{id}/{dir},必须带--autonomous, 例--cmd 'copilot -p "按 pdlc {stage} {id} --autonomous" --allow-all-tools'。标为「未验证」,驱动管不了它的花费,只靠--max-steps限步——跑之前把这一点告诉用户- 并行参数
--parallel N(默认 1):N>1 时每个功能在.worktrees/pdlc-loop/<ID>(分支pdlc-loop/<ID>)里跑,互不干扰; 产物留在 worktree 里,由人审阅、合并,驱动不提交、不合并。状态文件要先提交,worktree 里才看得到 - 按状态机里的
depends_on排先后:依赖没收敛,依赖方就不跑;成环的全部跳过 - 退出码:
0全部收敛;2有功能阻塞或被跳过;3达步数上限;4平台命令出错;5状态没推进 - 跑之前把命令与预计的并行数、预算告诉用户并等确认——自主循环持续花钱
循环算法(Task 版)
- 从本命令的参数取功能ID;
--max-steps取迭代上限(缺省 4)。读docs/.pdlc-state/<功能ID>.json。 - 循环,每轮:
- 运行
bash scripts/pdlc-loop.sh --next <功能ID> --project <项目根>取下一条命令,输出只会是pdlc-tdd/pdlc-implement/pdlc-review/done/blocked之一(映射只在脚本里实现一份,不要自己重算)。 done→ 成功停机,输出<<<PDLC done stage=review>>>,提示交人工/pdlc-ship。blocked→ 停机交还人类,输出<<<PDLC blocked reason="...">>>。- 否则用 Task 工具派发该命令到一个 fresh subagent,带
--autonomous,模型继承当前会话(要按阶段选模型,用外部驱动scripts/pdlc-loop.sh——它读得到各 skill 的推荐模型,Task 版读不到)。 - subagent 返回后重新读状态机
last_phase_result:ok=false→ fail-stop:停机、不重跑同一 stage,输出 blocked 哨兵。ok=true但checks里有false→ 状态自相矛盾,同样 fail-stop(以 checks 为准,不往下一阶段推)。current_stage未推进(违反 IRON LAW 第 6 条)→ stuck-stop:停机报错。ok=true且已推进 → 记一步,继续下一轮。
- 步数 >
--max-steps→ 上限停机(防病态空转烧 token)。
- 运行
- 输出循环小结(跑了几步、终态、每步
last_phase_result摘要)。
护栏(不可协商)
- 迭代上限:收敛段线性前进
tdd→implement→review(3 段),默认上限 4 = 3 段 + 1 段容错余量(供「首轮 block、人工修好后从原 stage 续跑一次」)。不给更多余量。 - 只前进不回炉:循环只在不同 stage 间前进,永不原地重跑同一 stage(与 IRON LAW「修复单次不递归」一致——单 stage 内的修复仍是单次)。
- fail-stop / stuck-stop:任一 stage
ok=false或状态未推进即停,绝不空转。 - 预算:外部 Runbook 形态必须配
--max-budget-usd(见 usage-guide)。自主循环持续烧 token,护栏是硬要求。
与 IRON LAW 的关系
本引擎不违反「修复单次不递归」:单个 stage 的自检-修复仍单次;引擎做的是跨 stage 前进 + 失败即停 + 上限,不是「重试同一步」。
功能ID: $ARGUMENTS
Files (pdlc-skills)
-
scripts
-
pdlc-loop.sh 33.4 KB
Loading…
-
-
SKILL.md 8.6 KB
--- name: pdlc-loop-run description: 收敛循环引擎——自动推进 tdd → implement → review,直到评审通过、待发布(next_step 为 pdlc-ship)或阻塞;发布永远由人做 argument-hint: "<功能ID> [--max-steps N]" allowed-tools: Read, Glob, Bash, Task layer: 3 stage: ops produces: [] requires: - docs/.pdlc-state/ next_step: null terminal_state: null # 只对 Claude Code 有用:通用安装器 npx skills 见到 internal 默认不列出、不安装 metadata: internal: true --- # 收敛循环引擎(loop-run) 把机械收敛段 `tdd → implement → review` 烧成一个自主循环:从 `current_stage` 出发逐阶段自动推进,直到 `review_done` 或被 `blocked`。这是 `/pdlc-loop-next` 之上的高层引擎——用户不必自己写 bash 循环。 <!-- @include templates/prompts/noninteractive.md(已内联于下方,无需另读) --> ## 非交互模式(`--autonomous`) 若本命令的参数含 `--autonomous`,本命令进入**无人值守**模式,按以下规则处理原本需要人应答的交互点。**参数是唯一真源**:不带 `--autonomous` 即为交互模式,一切照旧正常询问用户;绝不回读状态机 `run_mode` 兜底(「掉出 autonomous」是安全的失败方向)。 1. **流程性确认**(如「测试已绿是否继续」「是否覆盖已有文件」)→ **不询问**,按预设默认前进,并把决策追加到状态机 `history[].auto_decisions[]` (写状态机的命令:推进时给状态推进脚本传 `--decision "<确认点描述>=<所选默认>"`,可重复;脚本写成下面的样子): ```json { "point": "<确认点描述>", "chose": "<所选默认>", "at": "<ISO 8601>" } ``` 2. **真需人判断**(PRD 关键取舍、评审「需人工确认」项、真实循环依赖、**测试与设计 / PRD 矛盾**等无法安全默认的点)→ **不猜**。 改测试、改检查命令让它变绿,永远不是「流程性默认」,不能记成 `--decision`: - `current_stage` 保持不变(不推进) - 写 `last_phase_result.ok = false` 且 `blocked_reason = "<原因>"`(写状态机的命令:给状态推进脚本传 `--blocked "<原因>"`) - 末行输出哨兵:`<<<PDLC blocked reason="<原因>">>>` - 立即结束命令,交还人类 - **守卫拦截也走这一条**:前置守卫(缺设计文档、缺测试、测试没红等)在 `--autonomous` 下拦住本命令时, 不能只输出 ⛔ 就停——同样写 `ok=false` + `blocked_reason`(写明哪条守卫、缺什么)并输出哨兵。 否则状态机里仍是上一阶段的 `ok=true`,循环驱动只看到 `current_stage` 没动,会把「被拦」误报成「卡住」,真实原因丢失。 3. **破坏性操作**(发布 / 部署 / 打 tag / 触发 CI / DROP / force-push 等不可逆·外发操作)→ `--autonomous` **无效**,仍必须人工显式确认。 4. **顺手的 sidecar 产物**(如缺失时创建 `CHANGELOG.md`、补全文档 PDLC-TRACE 的创建时间等本阶段职责内、可安全默认的辅助改动)→ 视为流程性默认,**直接做并记入 `auto_decisions[]`**;这类改动不新增外部副作用,不属破坏性操作。 > 进入 autonomous 模式时,在状态机顶层写 `run_mode: "autonomous"` 仅供留痕(复盘区分人工 vs 循环产出)。 <!-- @include-end templates/prompts/noninteractive.md --> > ⛔ **终态即 `review_done`(设计如此)**:本引擎**只覆盖机械收敛段**。到达 `review_done` 即**成功停机**,交人工决定是否 `/pdlc-ship`。**绝不**自动进入 `pdlc-ship` / `pdlc-deploy`——发布/部署是不可逆·外发操作,永远留人(`--autonomous` 对它们无效)。prd/design 的关键取舍同样不在本引擎范围内。 ## 两种运行形态 - **默认推荐 · 外部 Runbook(真进程隔离)**:长跑 / 过夜 / 多 feature 并行时,用独立进程逐轮跑,每轮全新进程 = 真 fresh context 最可信。本命令可打印该 Runbook 脚本(见 usage-guide「自主循环 Runbook」)。 - **便捷 · 插件内 Task 版(本命令默认行为)**:适合短收敛。每个 stage 派发给一个 **fresh Task subagent**(context 相对隔离),返回后读状态机决定推进 / 停 / block。 ## 多个功能 / 并行:用驱动脚本 一次要推多个功能、要并行、或要长跑过夜时,**不要自己写外层循环**——用随本 skill 分发的驱动脚本 `scripts/pdlc-loop.sh`(在本 skill 目录下)。它就是上面说的外部 Runbook 形态,护栏与下面的 Task 版一致: ```bash # 先看决策,不花钱 bash <本 skill 目录>/scripts/pdlc-loop.sh F20260924-100000 F20260924-110000 --platform claude --dry-run # 真跑:claude 平台必须给每次调用的预算上限 bash <本 skill 目录>/scripts/pdlc-loop.sh F20260924-100000 F20260924-110000 --platform claude --max-budget-usd 5 # 所有处于收敛段、未阻塞的功能,两个一起跑(每个功能一个 git worktree) bash <本 skill 目录>/scripts/pdlc-loop.sh --ready --platform claude --max-budget-usd 5 --parallel 2 # 看进度(/pdlc-status 也会显示) bash <本 skill 目录>/scripts/pdlc-loop.sh --status ``` - `--platform claude|codex`:每一步用 `claude -p` 或 `codex exec` 起一个全新进程 - `--platform custom --cmd '<模板>'`:其它 CLI,每一步执行展开后的模板,占位符 `{stage}` / `{id}` / `{dir}`,必须带 `--autonomous`, 例 `--cmd 'copilot -p "按 pdlc {stage} {id} --autonomous" --allow-all-tools'`。标为「未验证」,驱动管不了它的花费,只靠 `--max-steps` 限步——跑之前把这一点告诉用户 - 并行参数 `--parallel N`(默认 1):N>1 时每个功能在 `.worktrees/pdlc-loop/<ID>`(分支 `pdlc-loop/<ID>`)里跑,互不干扰; 产物留在 worktree 里,由人审阅、合并,驱动不提交、不合并。状态文件要先提交,worktree 里才看得到 - 按状态机里的 `depends_on` 排先后:依赖没收敛,依赖方就不跑;成环的全部跳过 - 退出码:`0` 全部收敛;`2` 有功能阻塞或被跳过;`3` 达步数上限;`4` 平台命令出错;`5` 状态没推进 - 跑之前把命令与预计的并行数、预算告诉用户并等确认——自主循环持续花钱 ## 循环算法(Task 版) 1. 从本命令的参数取功能ID;`--max-steps` 取迭代上限(缺省 **4**)。读 `docs/.pdlc-state/<功能ID>.json`。 2. 循环,每轮: 1. 运行 `bash scripts/pdlc-loop.sh --next <功能ID> --project <项目根>` 取下一条命令,输出只会是 `pdlc-tdd` / `pdlc-implement` / `pdlc-review` / `done` / `blocked` 之一(映射只在脚本里实现一份,不要自己重算)。 2. `done` → **成功停机**,输出 `<<<PDLC done stage=review>>>`,提示交人工 `/pdlc-ship`。 3. `blocked` → 停机交还人类,输出 `<<<PDLC blocked reason="...">>>`。 4. 否则用 **Task 工具派发**该命令到一个 fresh subagent,**带 `--autonomous`**,模型继承当前会话(要按阶段选模型,用外部驱动 `scripts/pdlc-loop.sh`——它读得到各 skill 的推荐模型,Task 版读不到)。 5. subagent 返回后重新读状态机 `last_phase_result`: - `ok=false` → **fail-stop**:停机、不重跑同一 stage,输出 blocked 哨兵。 - `ok=true` 但 `checks` 里有 `false` → 状态自相矛盾,同样 **fail-stop**(以 checks 为准,不往下一阶段推)。 - `current_stage` 未推进(违反 IRON LAW 第 6 条)→ **stuck-stop**:停机报错。 - `ok=true` 且已推进 → 记一步,继续下一轮。 6. 步数 > `--max-steps` → **上限停机**(防病态空转烧 token)。 3. 输出循环小结(跑了几步、终态、每步 `last_phase_result` 摘要)。 ## 护栏(不可协商) - **迭代上限**:收敛段线性前进 `tdd→implement→review`(3 段),默认上限 **4** = 3 段 + 1 段容错余量(供「首轮 block、人工修好后从原 stage 续跑一次」)。不给更多余量。 - **只前进不回炉**:循环只在**不同 stage 间前进**,永不原地重跑同一 stage(与 IRON LAW「修复单次不递归」一致——单 stage 内的修复仍是单次)。 - **fail-stop / stuck-stop**:任一 stage `ok=false` 或状态未推进即停,绝不空转。 - **预算**:外部 Runbook 形态必须配 `--max-budget-usd`(见 usage-guide)。自主循环持续烧 token,护栏是硬要求。 ## 与 IRON LAW 的关系 本引擎不违反「修复单次不递归」:单个 stage 的自检-修复仍单次;引擎做的是**跨 stage 前进 + 失败即停 + 上限**,不是「重试同一步」。 功能ID: $ARGUMENTS
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.