Pdlc loop next

Skill kanfu-panda/pdlc-skills/skills/pdlc-loop-next

36 slash commands that turn Claude Code into a real PDLC workflow — PRD → TDD → implement → review → ship. Hard contracts force AI to persist artifacts, write failing tests first, and run self-checks. No more "looks done" in chat.

Install

npx -y skills add kanfu-panda/pdlc-skills --skill pdlc-loop-next

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

9 stars9 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

打印循环下一步应执行的命令（机器可读，供 loop 驱动）

SKILL.md

3.7 KB, as published. Nobody here has run it

循环下一步（loop-next）

读取指定功能的状态机，只打印一个 token，告诉外层循环下一步该跑哪条命令。它是 /pdlc-loop-run 与用户自写 bash 循环的低层 helper——自身只读、不改任何状态、不含 --autonomous 语义。

输出契约（安全关键）

输出必须是下列固定白名单中的单个 token，独占一行，不含任何散文、标点或解释，尤其不要用代码块（三反引号）或反引号包裹：

pdlc-tdd | pdlc-implement | pdlc-review | done | blocked

✅ 正确：整个回复就是一行 pdlc-implement
❌ 错误：用 ``` 包成代码块、用反引号包住、加 下一步： 前缀或任何解释——任何包裹/前缀都会让下游 case 匹配失败。
本命令只覆盖机械收敛段 tdd → implement → review。到达 review_done 或更后（发布属人工闸门）→ 输出 done，绝不输出 pdlc-ship / pdlc-deploy（发布永远留人）。
下游 helper 必须先净化（去反引号/空白）再校验 token 属于白名单，非法即中止（见下方参考脚本）——这是防御模型偶发包裹的兜底。

执行流程

从 $ARGUMENTS 取功能ID；读取 docs/.pdlc-state/<功能ID>.json。
文件不存在 / 无法解析 → 输出 blocked。
last_phase_result.blocked_reason 非空 → 输出 blocked。
current_stage 属终态（以 _done 结尾——实际由编排器写入的终态值为 feature_done / fix_done）→ 输出 done。（注：单阶段命令的 current_stage 用短名 impl/review，review 完成的判定靠下面第 5 步的 next_step，不靠此处。）

否则以 next_step（状态机里存的下一跳命令名）为主键判定并输出。

⚠️ 必须用 next_step 判定，不要用 current_stage 字符串匹配：现有状态机的 current_stage 用短名（requirements / design / tdd / impl / review，如 pdlc-implement 明写 current_stage: impl），格式不适合直接判阶段；而 next_step 是无歧义的命令名。

`next_step`	输出	说明
`pdlc-tdd`	`pdlc-tdd`
`pdlc-implement`	`pdlc-implement`
`pdlc-review`	`pdlc-review`
`pdlc-ship` / `pdlc-deploy` / `null`	`done`	机械收敛已完成（review 通过），发布留人
`pdlc-prd` / `pdlc-design`	`blocked`	尚在 tdd 之前，需人工（超出循环范围）
其它	`blocked`

不写文件、不产任何 artifact。

参考 helper（供 usage-guide / 外层循环使用，含白名单校验）

# 净化：把输出切成 token（去反引号、按空白分行）再用 grep -x 整 token 匹配白名单——
# 容忍空白/代码块包裹，又避免从 done_at / blocked_reason 等子串里误抽 done/blocked
RAW=$(claude -p "/pdlc-loop-next $ID")
CMD=$(printf '%s' "$RAW" | tr '`' ' ' | tr -s ' \t' '\n' | grep -xE '(pdlc-tdd|pdlc-implement|pdlc-review|done|blocked)' | head -1)
case "$CMD" in
  pdlc-tdd|pdlc-implement|pdlc-review)
    claude -p "/$CMD $ID --autonomous" ;;
  done)    echo "✅ 已到 review_done，交人工决定是否 /pdlc-ship"; break ;;
  blocked) echo "⛔ 需人工介入"; break ;;
  *)       echo "❌ 非法命令（原始输出：$RAW）"; exit 1 ;;
esac

功能ID: $ARGUMENTS