cc-devflow 4.5.6 → 4.5.8

package/README.zh-CN.md

@@ -14,13 +14,42 @@ CC-DevFlow 是一个给 Agent 编程时代准备的小而明确的工作流系
 ```text
 cc-roadmap
 
-PDCA: cc-plan        -> cc-do -> cc-check -> cc-act
-IDCA: cc-investigate -> cc-do -> cc-check -> cc-act
+PR Harness: cc-next -> cc-dev -> cc-pr-review -> cc-pr-land
+
+PDCA: cc-plan        -> [cc-review] -> cc-do -> [cc-review] -> cc-check -> cc-act
+IDCA: cc-investigate -> [cc-review] -> cc-do -> [cc-review] -> cc-check -> cc-act
+```
+
+```mermaid
+flowchart TD
+  Roadmap["cc-roadmap\n产品方向和阶段真相"] --> Next["cc-next\n选择下一个 Goal Packet"]
+  Next --> Dev["cc-dev\n当前 worktree 自动推进到 PR"]
+
+  Dev --> Route{"路线"}
+  Route -->|新需求或变更| Plan["cc-plan\n冻结范围和任务"]
+  Route -->|Bug 或回归| Investigate["cc-investigate\n冻结根因和修复边界"]
+
+  Plan --> PlanReview["cc-review\n可选方案 Review"]
+  Investigate --> PlanReview
+  PlanReview --> Do["cc-do\n实现并留下证据"]
+  Plan --> Do
+  Investigate --> Do
+
+  Do --> ImplReview["cc-review\n可选实现 Review"]
+  ImplReview --> Check["cc-check\n新鲜验证裁决"]
+  Do --> Check
+  Check --> Act["cc-act\n创建或更新远程 PR"]
+  Act --> PRReview["cc-pr-review\n单独会话 Review PR"]
+  PRReview --> PRLand["cc-pr-land\nRebase 合并并证明 main parity"]
+  PRReview -->|需要修复| Dev
+  PRLand --> Main["main\n本地和远程一致"]
 ```
 
+![CC-DevFlow PR Harness 中文可视化流程](./docs/assets/cc-devflow-pr-harness-zh.svg)
+
 ## 为什么用 cc-devflow
 
-- **公开入口很小**：6 个可见 workflow skill，加一个负责安装和平台适配的 CLI。
+- **公开入口很小**：核心 workflow skill、PR Harness 链路、1 个可选深度 review skill，加一个负责安装和平台适配的 CLI。
 - **先证据后完成**：实现之后必须经过验证证据，才能进入 ship 或 handoff。
 - **Skill-first 分发**：公开契约写在 `.claude/skills/<skill>/SKILL.md` 和 `PLAYBOOK.md`，不依赖隐藏运行时语义。
 - **多平台产物**：一次安装，再生成 Codex、Cursor、Qwen、Antigravity 等 Agent 环境需要的输出。
@@ -56,16 +85,21 @@ npx cc-devflow@latest adapt --cwd /path/to/your/project --platform antigravity
 npx cc-devflow@latest adapt --cwd /path/to/your/project --all
 ```
 
-安装完成后，直接让 Agent 使用这些 workflow skill。产品方向先走 `cc-roadmap`，新需求走 `cc-plan`，Bug 和 regression 走 `cc-investigate`，然后继续进入 `cc-do`、`cc-check`、`cc-act`。
+安装完成后，直接让 Agent 使用这些 workflow skill。产品方向先走 `cc-roadmap`。需要自动选择下一步时走 `cc-next`；选中目标后用 `cc-dev` 在当前 worktree 内自动跑 PDCA 或 IDCA，直到远程 PR 打开；PR 用单独会话跑 `cc-pr-review`；review 后用单独会话跑 `cc-pr-land` 合并并证明 main parity。手动核心链路仍然是：新需求走 `cc-plan`，Bug 和 regression 走 `cc-investigate`；复杂计划或根因合同冻结后可以先接 `cc-review`，再进入 `cc-do`；实现复杂时还可以再接一次实现 `cc-review`，最后进入 `cc-check` 和 `cc-act`。
 
 ## Workflow Skill
 
 | Skill | 什么时候用 | 主要产物 |
 | --- | --- | --- |
 | `cc-roadmap` | 需要产品方向、阶段范围或 backlog 顺序 | `devflow/roadmap.json`、`devflow/ROADMAP.md`、deprecated `devflow/BACKLOG.md` |
+| `cc-next` | 需要从 roadmap 和 issue truth 里选下一个 ready 目标 | 交给 `cc-dev` 的 Goal Packet |
+| `cc-dev` | 已选目标要在当前 worktree 内自动推进到远程 PR | PDCA/IDCA 产物加 PR 或 handoff |
 | `cc-plan` | 新功能或变更需要澄清范围、设计方案、冻结任务 | `planning/design.md`、`planning/tasks.md`、`task-manifest.json` |
 | `cc-investigate` | Bug 需要症状、复现、根因和修复边界 | `planning/analysis.md`、`planning/tasks.md`、`task-manifest.json` |
 | `cc-do` | 已计划或已调查的任务需要实现 | 代码、测试、checkpoint、scratch runtime |
+| `cc-review` | 复杂方案、调查根因或 diff 需要在实现前或验证前做可选深度多轮 Review | `cc-review-report.md`，可选 `cc-review-findings.json` |
+| `cc-pr-review` | 远程 PR 需要单独会话做合并前 Review | PR review packet、findings 和 landing verdict |
+| `cc-pr-land` | 已 Review PR 需要 rebase-first 合并到 main 并证明 parity | 已集成 main 和本地 / 远程一致性证据 |
 | `cc-check` | 工作需要新鲜验证证据 | `report-card.json` |
 | `cc-act` | 已验证工作需要 PR、本地 handoff、release note 或 closeout | 唯一最终 handoff 文件 |
 
@@ -82,6 +116,8 @@ Canonical language 和 durable decisions 只收敛到 cc-devflow 原生真相源
 
 `cc-plan` 会在 `cc-do` 开始前冻结更多实现决策。非 trivial 计划需要比较 minimal viable 和 ideal architecture，full-design 需要包含 implementation decision horizon 和 error/rescue map；测试计划要记录测试框架证据、public test seam、spec-style test name、public verification path、behavior assertion、mock boundary、覆盖质量、强制 regression test、interface depth、Green minimality guard、refactor candidates 和 vertical tracer-bullet slices。交接前，`cc-plan` 和 `cc-investigate` 还会校准 source roadmap item，让 RM 状态、REQ/FIX 绑定、progress 和 spec diagnosis 不再漂移。
 
+`cc-review` 是可选的深度 Review，不替代 `cc-check`。它可以接在 `cc-plan` / `cc-investigate` 后审冻结的计划或根因合同，也可以接在 `cc-do` 后审实现。它先读取上次 Review 记录和当前 git/artifact delta，写出 Review 计划，再逐节点检查并写 ledger。宿主支持 subAgent 时，选中的节点可以派给独立只读 reviewer，让 strategy、engineering、design、DX、坏味道、测试和运行时审查不共享同一个被污染的上下文。复杂实现 Review 可以把 intent/regression、security/privacy、performance/reliability、contracts/coverage 拆成独立风险 lane，再由主线程聚合和筛掉弱 findings。计划 Review 通过渐进式 references 借鉴 strategy / design / engineering / DX 方法；实现 Review 检查 diff 范围、代码坏味道、测试、UI/runtime 行为、Browser/Computer Use 证据和日志。Finding 回到 `cc-plan` 或 `cc-do`；实现 Review 干净后再进入 `cc-check`。
+
 ## 验证与交付门禁
 
 `cc-check` 现在把 QA 当成反馈环问题，而不是只看测试是否绿。Bugfix 和行为变更需要记录证明现实的 loop、expected / actual、复现步骤、测试边界质量；如果没有干净的 public test seam，要留下架构 follow-up。
@@ -117,9 +153,14 @@ node bin/cc-devflow-cli.js adapt --cwd /tmp/example-project --platform codex
 
 ```bash
 npx skills add https://github.com/Dimon94/cc-devflow --skill cc-roadmap
+npx skills add https://github.com/Dimon94/cc-devflow --skill cc-next
+npx skills add https://github.com/Dimon94/cc-devflow --skill cc-dev
 npx skills add https://github.com/Dimon94/cc-devflow --skill cc-plan
 npx skills add https://github.com/Dimon94/cc-devflow --skill cc-investigate
 npx skills add https://github.com/Dimon94/cc-devflow --skill cc-do
+npx skills add https://github.com/Dimon94/cc-devflow --skill cc-review
+npx skills add https://github.com/Dimon94/cc-devflow --skill cc-pr-review
+npx skills add https://github.com/Dimon94/cc-devflow --skill cc-pr-land
 npx skills add https://github.com/Dimon94/cc-devflow --skill cc-check
 npx skills add https://github.com/Dimon94/cc-devflow --skill cc-act
 ```
@@ -182,9 +223,14 @@ npx cc-devflow config doctor --cwd /path/to/your/project
 当前分发目录：
 
 - `.claude/skills/cc-roadmap/`
+- `.claude/skills/cc-next/`
+- `.claude/skills/cc-dev/`
 - `.claude/skills/cc-plan/`
 - `.claude/skills/cc-investigate/`
 - `.claude/skills/cc-do/`
+- `.claude/skills/cc-review/`
+- `.claude/skills/cc-pr-review/`
+- `.claude/skills/cc-pr-land/`
 - `.claude/skills/cc-check/`
 - `.claude/skills/cc-act/`
 - `.claude/skills/cc-spec-init/`
@@ -218,6 +264,14 @@ npm run verify:publish
 
 主要贡献说明见 [`CONTRIBUTING.zh-CN.md`](./CONTRIBUTING.zh-CN.md)，里面包含公开入口规则、本地 CLI 冒烟验证、文档规则和 PR 期望。
 
+## 讨论交流
+
+欢迎扫码加入 cc-devflow 交流 1 群，反馈问题、交流使用体验或提出新功能建议。
+
+<img src="./docs/assets/wechat-group-qr.jpg" alt="cc-devflow 交流 1 群微信群二维码" width="320" />
+
+如果二维码过期，请在 issue 中提醒维护者更新。
+
 ## 社区与贡献
 
 - 如果这个工作流对你有用，可以给项目一个 Star：[GitHub stars](https://github.com/Dimon94/cc-devflow/stargazers)

package/bin/cc-devflow-cli.js

@@ -60,6 +60,10 @@ Commands:
   config doctor       Validate config and local ignore safety
   query list          List typed runtime query ids
   query <id>          Run a typed runtime query as JSON
+  next-change-key     Compute the next REQ/FIX change key
+  archive-change      Archive a completed change to devflow/changes/archive/YYYY-MM/
+  restore-change      Restore an archived change back to devflow/changes/
+  list-archived       List all archived changes
 
 Init options:
   --dir <path>         Target project path (default: cwd)
@@ -91,6 +95,11 @@ Query options:
   --change-id <id>     Alias for --change
   --change-key <key>   Full change key, for example REQ-123-my-feature
 
+Next-change-key options:
+  --prefix <REQ|FIX>   Change type prefix (required)
+  --description <text> Short description, will be slugified (required)
+  --cwd <path>         Project path (default: cwd)
+
 Examples:
   cc-devflow init
   cc-devflow init --dir /path/to/project
@@ -528,6 +537,31 @@ async function runQueryCommand(args) {
   return result.ok ? 0 : 2;
 }
 
+function runNextChangeKey(args) {
+  const parsed = { prefix: null, description: null, cwd: null };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--prefix') { parsed.prefix = args[++i]; continue; }
+    if (arg.startsWith('--prefix=')) { parsed.prefix = arg.slice('--prefix='.length); continue; }
+    if (arg === '--description') { parsed.description = args[++i]; continue; }
+    if (arg.startsWith('--description=')) { parsed.description = arg.slice('--description='.length); continue; }
+    if (arg === '--cwd') { parsed.cwd = args[++i]; continue; }
+    if (arg.startsWith('--cwd=')) { parsed.cwd = arg.slice('--cwd='.length); continue; }
+  }
+
+  if (!parsed.prefix || !parsed.description) {
+    console.error('Use: cc-devflow next-change-key --prefix REQ|FIX --description "short description"');
+    return 1;
+  }
+
+  const { nextChangeKey } = require(path.join(PACKAGE_ROOT, 'lib/skill-runtime/paths.js'));
+  const repoRoot = path.resolve(parsed.cwd || process.cwd());
+  const result = nextChangeKey(repoRoot, parsed.prefix, parsed.description);
+  process.stdout.write(`${result.changeId}\n${result.changeKey}\n`);
+  return 0;
+}
+
 function runAdapt(args) {
   const { options, rest } = parseCliArgs(args);
 
@@ -571,6 +605,75 @@ function runAdapter(command, args) {
   return typeof result.status === 'number' ? result.status : 1;
 }
 
+function runArchiveChange(args) {
+  const parsed = { changeKey: null, cwd: null };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--cwd') { parsed.cwd = args[++i]; continue; }
+    if (arg.startsWith('--cwd=')) { parsed.cwd = arg.slice('--cwd='.length); continue; }
+    if (!arg.startsWith('-') && !parsed.changeKey) { parsed.changeKey = arg; continue; }
+  }
+
+  if (!parsed.changeKey) {
+    console.error('Use: cc-devflow archive-change <change-key> [--cwd path]');
+    return 1;
+  }
+
+  const { archiveChange } = require(path.join(PACKAGE_ROOT, 'lib/skill-runtime/archive-change.js'));
+  const repoRoot = path.resolve(parsed.cwd || process.cwd());
+  const result = archiveChange(repoRoot, parsed.changeKey);
+  process.stdout.write(`Archived to ${result.archived}\n`);
+  return 0;
+}
+
+function runRestoreChange(args) {
+  const parsed = { archivedPath: null, cwd: null };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--cwd') { parsed.cwd = args[++i]; continue; }
+    if (arg.startsWith('--cwd=')) { parsed.cwd = arg.slice('--cwd='.length); continue; }
+    if (!arg.startsWith('-') && !parsed.archivedPath) { parsed.archivedPath = arg; continue; }
+  }
+
+  if (!parsed.archivedPath) {
+    console.error('Use: cc-devflow restore-change <archived-path> [--cwd path]');
+    return 1;
+  }
+
+  const { restoreChange } = require(path.join(PACKAGE_ROOT, 'lib/skill-runtime/archive-change.js'));
+  const repoRoot = path.resolve(parsed.cwd || process.cwd());
+  const archivePath = path.resolve(parsed.archivedPath);
+  const result = restoreChange(repoRoot, archivePath);
+  process.stdout.write(`Restored to ${result.restored}\n`);
+  return 0;
+}
+
+function runListArchived(args) {
+  const parsed = { cwd: null };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--cwd') { parsed.cwd = args[++i]; continue; }
+    if (arg.startsWith('--cwd=')) { parsed.cwd = arg.slice('--cwd='.length); continue; }
+  }
+
+  const { listArchived } = require(path.join(PACKAGE_ROOT, 'lib/skill-runtime/archive-change.js'));
+  const repoRoot = path.resolve(parsed.cwd || process.cwd());
+  const items = listArchived(repoRoot);
+
+  if (items.length === 0) {
+    process.stdout.write('No archived changes.\n');
+    return 0;
+  }
+
+  for (const item of items) {
+    process.stdout.write(`${item.month}  ${item.changeKey}\n`);
+  }
+  return 0;
+}
+
 async function main() {
   const argv = process.argv.slice(2);
   const [command, ...rest] = argv;
@@ -596,6 +699,22 @@ async function main() {
     return runQueryCommand(rest);
   }
 
+  if (command === 'next-change-key') {
+    return runNextChangeKey(rest);
+  }
+
+  if (command === 'archive-change') {
+    return runArchiveChange(rest);
+  }
+
+  if (command === 'restore-change') {
+    return runRestoreChange(rest);
+  }
+
+  if (command === 'list-archived') {
+    return runListArchived(rest);
+  }
+
   return runAdapter(command, rest);
 }
 

package/config/distributable-skills.json

@@ -1,17 +1,27 @@
 {
   "publicSkills": [
     "cc-roadmap",
+    "cc-next",
+    "cc-dev",
     "cc-plan",
     "cc-investigate",
     "cc-do",
+    "cc-review",
+    "cc-pr-review",
+    "cc-pr-land",
     "cc-check",
     "cc-act"
   ],
   "distributedSkills": [
     "cc-roadmap",
+    "cc-next",
+    "cc-dev",
     "cc-plan",
     "cc-investigate",
     "cc-do",
+    "cc-review",
+    "cc-pr-review",
+    "cc-pr-land",
     "cc-check",
     "cc-act",
     "cc-spec-init",

package/docs/assets/cc-devflow-pr-harness-en.svg

@@ -0,0 +1,153 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="1000" viewBox="0 0 1600 1000" role="img" aria-labelledby="title desc">
+  <title id="title">CC-DevFlow PR Harness workflow</title>
+  <desc id="desc">A visual workflow diagram showing roadmap selection, goal-driven development, PDCA and IDCA loops, PR review, and PR landing with main parity.</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#07111f"/>
+      <stop offset="0.48" stop-color="#0d2638"/>
+      <stop offset="1" stop-color="#102414"/>
+    </linearGradient>
+    <linearGradient id="blue" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#4cc9f0"/>
+      <stop offset="1" stop-color="#4361ee"/>
+    </linearGradient>
+    <linearGradient id="green" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#b8f05a"/>
+      <stop offset="1" stop-color="#2fbf71"/>
+    </linearGradient>
+    <linearGradient id="amber" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#ffd166"/>
+      <stop offset="1" stop-color="#ef8354"/>
+    </linearGradient>
+    <linearGradient id="violet" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#d0a2ff"/>
+      <stop offset="1" stop-color="#7b2cbf"/>
+    </linearGradient>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="16" stdDeviation="16" flood-color="#000000" flood-opacity="0.35"/>
+    </filter>
+    <marker id="arrow" markerWidth="16" markerHeight="16" refX="12" refY="8" orient="auto" markerUnits="strokeWidth">
+      <path d="M2,2 L14,8 L2,14 Z" fill="#d7e3f4"/>
+    </marker>
+    <style>
+      .title{font:800 62px Inter,Arial,sans-serif;fill:#f8fbff;letter-spacing:0}
+      .subtitle{font:500 26px Inter,Arial,sans-serif;fill:#bdd0e8}
+      .label{font:800 26px Inter,Arial,sans-serif;fill:#f8fbff;letter-spacing:0}
+      .small{font:500 18px Inter,Arial,sans-serif;fill:#d7e3f4}
+      .micro{font:700 15px Inter,Arial,sans-serif;fill:#0a1421;letter-spacing:.5px}
+      .note{font:600 18px Inter,Arial,sans-serif;fill:#f8fbff}
+      .muted{font:500 16px Inter,Arial,sans-serif;fill:#9fb4cd}
+      .card{fill:#102033;stroke:#27445f;stroke-width:2;filter:url(#shadow)}
+      .lane{fill:#0b1728;stroke:#27445f;stroke-width:2}
+      .line{fill:none;stroke:#d7e3f4;stroke-width:4;marker-end:url(#arrow)}
+      .thin{fill:none;stroke:#6c819b;stroke-width:3;stroke-dasharray:8 10;marker-end:url(#arrow)}
+    </style>
+  </defs>
+  <rect width="1600" height="1000" fill="url(#bg)"/>
+  <circle cx="140" cy="125" r="220" fill="#2247ff" opacity="0.12"/>
+  <circle cx="1450" cy="820" r="260" fill="#2fbf71" opacity="0.13"/>
+
+  <text x="80" y="96" class="title">CC-DevFlow PR Harness</text>
+  <text x="84" y="136" class="subtitle">Roadmap-aware goal autopilot: pick next work, drive to PR, review separately, land with main parity.</text>
+
+  <rect x="80" y="190" width="1440" height="150" rx="18" class="lane"/>
+  <text x="110" y="225" class="note">Navigation layer</text>
+  <g transform="translate(130 250)">
+    <rect width="260" height="70" rx="16" fill="url(#blue)"/>
+    <text x="24" y="32" class="label">cc-roadmap</text>
+    <text x="24" y="56" class="small">product order and staged truth</text>
+  </g>
+  <g transform="translate(520 250)">
+    <rect width="260" height="70" rx="16" fill="url(#green)"/>
+    <text x="24" y="32" class="label">cc-next</text>
+    <text x="24" y="56" class="small">choose one ready Goal Packet</text>
+  </g>
+  <g transform="translate(910 250)">
+    <rect width="300" height="70" rx="16" fill="url(#amber)"/>
+    <text x="24" y="32" class="label">cc-dev</text>
+    <text x="24" y="56" class="small">current worktree to remote PR</text>
+  </g>
+  <path class="line" d="M390 285 H510"/>
+  <path class="line" d="M780 285 H900"/>
+
+  <rect x="80" y="390" width="675" height="335" rx="18" class="lane"/>
+  <text x="110" y="426" class="note">PDCA feature loop</text>
+  <text x="110" y="455" class="muted">For new behavior, API/UI changes, and requirement work</text>
+  <g transform="translate(120 490)">
+    <rect width="230" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-plan</text>
+    <text x="24" y="57" class="small">scope, design, tasks</text>
+  </g>
+  <g transform="translate(455 490)">
+    <rect width="230" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-do</text>
+    <text x="24" y="57" class="small">red, green, refactor</text>
+  </g>
+  <g transform="translate(120 615)">
+    <rect width="230" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-check</text>
+    <text x="24" y="57" class="small">fresh evidence verdict</text>
+  </g>
+  <g transform="translate(455 615)">
+    <rect width="230" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-act</text>
+    <text x="24" y="57" class="small">create or update PR</text>
+  </g>
+  <path class="line" d="M350 526 H445"/>
+  <path class="line" d="M570 562 V605"/>
+  <path class="line" d="M455 651 H360"/>
+
+  <rect x="845" y="390" width="675" height="335" rx="18" class="lane"/>
+  <text x="875" y="426" class="note">IDCA bug loop</text>
+  <text x="875" y="455" class="muted">For regressions, broken behavior, crashes, and flaky failures</text>
+  <g transform="translate(885 490)">
+    <rect width="270" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-investigate</text>
+    <text x="24" y="57" class="small">repro, root cause, boundary</text>
+  </g>
+  <g transform="translate(1245 490)">
+    <rect width="230" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-do</text>
+    <text x="24" y="57" class="small">repair with evidence</text>
+  </g>
+  <g transform="translate(885 615)">
+    <rect width="230" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-check</text>
+    <text x="24" y="57" class="small">prove the symptom is fixed</text>
+  </g>
+  <g transform="translate(1245 615)">
+    <rect width="230" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-act</text>
+    <text x="24" y="57" class="small">create or update PR</text>
+  </g>
+  <path class="line" d="M1155 526 H1235"/>
+  <path class="line" d="M1360 562 V605"/>
+  <path class="line" d="M1245 651 H1125"/>
+
+  <path class="thin" d="M1060 320 C950 360 830 365 685 410"/>
+  <path class="thin" d="M1060 320 C1180 360 1230 365 1260 410"/>
+
+  <rect x="250" y="790" width="1100" height="120" rx="22" fill="#101f2f" stroke="#3c5a78" stroke-width="2" filter="url(#shadow)"/>
+  <g transform="translate(305 815)">
+    <rect width="230" height="64" rx="14" fill="url(#violet)"/>
+    <text x="24" y="30" class="label">cc-pr-review</text>
+    <text x="24" y="52" class="small">separate PR review session</text>
+  </g>
+  <g transform="translate(690 815)">
+    <rect width="230" height="64" rx="14" fill="url(#green)"/>
+    <text x="24" y="30" class="label">cc-pr-land</text>
+    <text x="24" y="52" class="small">rebase and land reviewed PR</text>
+  </g>
+  <g transform="translate(1075 815)">
+    <rect width="220" height="64" rx="14" fill="url(#blue)"/>
+    <text x="24" y="30" class="label">main</text>
+    <text x="24" y="52" class="small">local and remote parity</text>
+  </g>
+  <path class="line" d="M535 847 H680"/>
+  <path class="line" d="M920 847 H1065"/>
+  <path class="thin" d="M805 815 C720 760 650 735 570 690"/>
+  <path class="thin" d="M805 815 C920 760 1110 735 1360 690"/>
+
+  <rect x="84" y="930" width="1432" height="42" rx="12" fill="#07111f" stroke="#27445f"/>
+  <text x="110" y="957" class="small">Boundary: cc-dev never creates nested worktrees and never merges PRs. Review and landing are separate sessions by design.</text>
+</svg>

package/docs/assets/cc-devflow-pr-harness-zh.svg

@@ -0,0 +1,152 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="1000" viewBox="0 0 1600 1000" role="img" aria-labelledby="title desc">
+  <title id="title">CC-DevFlow PR Harness 运作流程</title>
+  <desc id="desc">一张中文流程图，展示 roadmap 选题、目标自动驾驶、PDCA 和 IDCA 循环、PR 独立 Review、PR 合并和 main 一致性证明。</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#07111f"/>
+      <stop offset="0.48" stop-color="#0d2638"/>
+      <stop offset="1" stop-color="#102414"/>
+    </linearGradient>
+    <linearGradient id="blue" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#4cc9f0"/>
+      <stop offset="1" stop-color="#4361ee"/>
+    </linearGradient>
+    <linearGradient id="green" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#b8f05a"/>
+      <stop offset="1" stop-color="#2fbf71"/>
+    </linearGradient>
+    <linearGradient id="amber" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#ffd166"/>
+      <stop offset="1" stop-color="#ef8354"/>
+    </linearGradient>
+    <linearGradient id="violet" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#d0a2ff"/>
+      <stop offset="1" stop-color="#7b2cbf"/>
+    </linearGradient>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="16" stdDeviation="16" flood-color="#000000" flood-opacity="0.35"/>
+    </filter>
+    <marker id="arrow" markerWidth="16" markerHeight="16" refX="12" refY="8" orient="auto" markerUnits="strokeWidth">
+      <path d="M2,2 L14,8 L2,14 Z" fill="#d7e3f4"/>
+    </marker>
+    <style>
+      .title{font:800 62px Inter,"PingFang SC","Microsoft YaHei",Arial,sans-serif;fill:#f8fbff;letter-spacing:0}
+      .subtitle{font:500 26px Inter,"PingFang SC","Microsoft YaHei",Arial,sans-serif;fill:#bdd0e8}
+      .label{font:800 26px Inter,"PingFang SC","Microsoft YaHei",Arial,sans-serif;fill:#f8fbff;letter-spacing:0}
+      .small{font:500 18px Inter,"PingFang SC","Microsoft YaHei",Arial,sans-serif;fill:#d7e3f4}
+      .note{font:600 18px Inter,"PingFang SC","Microsoft YaHei",Arial,sans-serif;fill:#f8fbff}
+      .muted{font:500 16px Inter,"PingFang SC","Microsoft YaHei",Arial,sans-serif;fill:#9fb4cd}
+      .card{fill:#102033;stroke:#27445f;stroke-width:2;filter:url(#shadow)}
+      .lane{fill:#0b1728;stroke:#27445f;stroke-width:2}
+      .line{fill:none;stroke:#d7e3f4;stroke-width:4;marker-end:url(#arrow)}
+      .thin{fill:none;stroke:#6c819b;stroke-width:3;stroke-dasharray:8 10;marker-end:url(#arrow)}
+    </style>
+  </defs>
+  <rect width="1600" height="1000" fill="url(#bg)"/>
+  <circle cx="140" cy="125" r="220" fill="#2247ff" opacity="0.12"/>
+  <circle cx="1450" cy="820" r="260" fill="#2fbf71" opacity="0.13"/>
+
+  <text x="80" y="96" class="title">CC-DevFlow PR Harness</text>
+  <text x="84" y="136" class="subtitle">从 roadmap 选题，到当前 worktree 自动开发，再到独立 PR Review 和 main 一致性证明。</text>
+
+  <rect x="80" y="190" width="1440" height="150" rx="18" class="lane"/>
+  <text x="110" y="225" class="note">导航层</text>
+  <g transform="translate(130 250)">
+    <rect width="260" height="70" rx="16" fill="url(#blue)"/>
+    <text x="24" y="32" class="label">cc-roadmap</text>
+    <text x="24" y="56" class="small">产品顺序和阶段真相</text>
+  </g>
+  <g transform="translate(520 250)">
+    <rect width="260" height="70" rx="16" fill="url(#green)"/>
+    <text x="24" y="32" class="label">cc-next</text>
+    <text x="24" y="56" class="small">选择一个 ready 目标</text>
+  </g>
+  <g transform="translate(910 250)">
+    <rect width="300" height="70" rx="16" fill="url(#amber)"/>
+    <text x="24" y="32" class="label">cc-dev</text>
+    <text x="24" y="56" class="small">当前 worktree 推进到 PR</text>
+  </g>
+  <path class="line" d="M390 285 H510"/>
+  <path class="line" d="M780 285 H900"/>
+
+  <rect x="80" y="390" width="675" height="335" rx="18" class="lane"/>
+  <text x="110" y="426" class="note">PDCA 新需求循环</text>
+  <text x="110" y="455" class="muted">适用于新行为、接口、UI、规格和需求变更</text>
+  <g transform="translate(120 490)">
+    <rect width="230" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-plan</text>
+    <text x="24" y="57" class="small">冻结范围、设计、任务</text>
+  </g>
+  <g transform="translate(455 490)">
+    <rect width="230" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-do</text>
+    <text x="24" y="57" class="small">红灯、绿灯、重构</text>
+  </g>
+  <g transform="translate(120 615)">
+    <rect width="230" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-check</text>
+    <text x="24" y="57" class="small">新鲜证据裁决</text>
+  </g>
+  <g transform="translate(455 615)">
+    <rect width="230" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-act</text>
+    <text x="24" y="57" class="small">创建或更新 PR</text>
+  </g>
+  <path class="line" d="M350 526 H445"/>
+  <path class="line" d="M570 562 V605"/>
+  <path class="line" d="M455 651 H360"/>
+
+  <rect x="845" y="390" width="675" height="335" rx="18" class="lane"/>
+  <text x="875" y="426" class="note">IDCA Bug 调查循环</text>
+  <text x="875" y="455" class="muted">适用于回归、崩溃、错误行为和不稳定失败</text>
+  <g transform="translate(885 490)">
+    <rect width="270" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-investigate</text>
+    <text x="24" y="57" class="small">复现、根因、修复边界</text>
+  </g>
+  <g transform="translate(1245 490)">
+    <rect width="230" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-do</text>
+    <text x="24" y="57" class="small">带证据修复</text>
+  </g>
+  <g transform="translate(885 615)">
+    <rect width="230" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-check</text>
+    <text x="24" y="57" class="small">证明症状已修复</text>
+  </g>
+  <g transform="translate(1245 615)">
+    <rect width="230" height="72" rx="14" class="card"/>
+    <text x="24" y="32" class="label">cc-act</text>
+    <text x="24" y="57" class="small">创建或更新 PR</text>
+  </g>
+  <path class="line" d="M1155 526 H1235"/>
+  <path class="line" d="M1360 562 V605"/>
+  <path class="line" d="M1245 651 H1125"/>
+
+  <path class="thin" d="M1060 320 C950 360 830 365 685 410"/>
+  <path class="thin" d="M1060 320 C1180 360 1230 365 1260 410"/>
+
+  <rect x="250" y="790" width="1100" height="120" rx="22" fill="#101f2f" stroke="#3c5a78" stroke-width="2" filter="url(#shadow)"/>
+  <g transform="translate(305 815)">
+    <rect width="230" height="64" rx="14" fill="url(#violet)"/>
+    <text x="24" y="30" class="label">cc-pr-review</text>
+    <text x="24" y="52" class="small">单独会话 Review PR</text>
+  </g>
+  <g transform="translate(690 815)">
+    <rect width="230" height="64" rx="14" fill="url(#green)"/>
+    <text x="24" y="30" class="label">cc-pr-land</text>
+    <text x="24" y="52" class="small">Rebase 并合并 PR</text>
+  </g>
+  <g transform="translate(1075 815)">
+    <rect width="220" height="64" rx="14" fill="url(#blue)"/>
+    <text x="24" y="30" class="label">main</text>
+    <text x="24" y="52" class="small">本地和远程一致</text>
+  </g>
+  <path class="line" d="M535 847 H680"/>
+  <path class="line" d="M920 847 H1065"/>
+  <path class="thin" d="M805 815 C720 760 650 735 570 690"/>
+  <path class="thin" d="M805 815 C920 760 1110 735 1360 690"/>
+
+  <rect x="84" y="930" width="1432" height="42" rx="12" fill="#07111f" stroke="#27445f"/>
+  <text x="110" y="957" class="small">边界：cc-dev 不创建嵌套 worktree，也不合并 PR；Review 和 Landing 必须是独立会话。</text>
+</svg>

package/docs/examples/example-bindings.json

@@ -1,12 +1,17 @@
 {
-  "updatedAt": "2026-05-06",
+  "updatedAt": "2026-05-10",
   "skills": {
-    "cc-roadmap": "5.0.0",
-    "cc-plan": "3.7.7",
-    "cc-investigate": "1.2.2",
-    "cc-do": "1.6.2",
+    "cc-roadmap": "5.2.0",
+    "cc-next": "1.0.0",
+    "cc-dev": "1.0.0",
+    "cc-plan": "3.8.2",
+    "cc-investigate": "1.3.0",
+    "cc-do": "1.6.3",
+    "cc-review": "1.3.0",
+    "cc-pr-review": "1.0.0",
+    "cc-pr-land": "1.0.0",
     "cc-check": "1.10.1",
-    "cc-act": "1.8.2",
+    "cc-act": "1.8.3",
     "cc-spec-init": "1.1.0"
   },
   "examples": [

package/docs/examples/full-design-blocked/BACKLOG.md

@@ -5,7 +5,7 @@
 ## Backlog Meta
 
 - Roadmap version: `roadmap.v2`
-- Skill version: `5.0.0`
+- Skill version: `5.2.0`
 - Last synced: `2026-04-19`
 - Current focus stage: `Stage 2`
 - Roadmap state source: `roadmap.json`