principles-disciple 1.72.0 → 1.74.0

package/templates/langs/zh/core/BOOT.md

@@ -16,7 +16,7 @@
 2. **确认工作空间**: 检查当前工作目录是否正确
 3. **读取身份文件**: `SOUL.md`, `USER.md`, `IDENTITY.md`
 4. **检查记忆状态**: 读取今日和昨日的 `memory/YYYY-MM-DD.md`
-5. **检查痛觉信号**: 查看 `.state/.pain_flag` 是否存在
+5. **检查 Runtime V2 痛苦诊断**: 使用 `pd candidate list` / ledger state；`.state/.pain_flag` 仅为 legacy compatibility
 
 ---
 

package/templates/langs/zh/core/HEARTBEAT.md

@@ -8,7 +8,7 @@
 
 ## 🩹 痛觉与进化检查
 
-- [ ] **`.state/.pain_flag`** — 是否存在未处理的痛觉信号？
+- [ ] **Runtime V2 pain** — 如果最近有 `pd pain record` 或工具失败，检查 `pd candidate list` / ledger。`.state/.pain_flag` 仅为 legacy compatibility。
 - [ ] **`.state/evolution_queue.json`** — 是否有待处理的进化任务？
 - [ ] **`memory/logs/SYSTEM.log`** — 最近是否有未解决的高优先级问题？
 
@@ -95,4 +95,4 @@
 
 ---
 
-*无问题且无需行动，回复 `HEARTBEAT_OK` 节省 Token。*
+*无问题且无需行动，回复 `HEARTBEAT_OK` 节省 Token。*

package/templates/langs/zh/principles/THINKING_OS.md

@@ -39,8 +39,9 @@
   <!-- 执行与物理限制 (Execution & Physical Constraints) -->
   <directive id="T-05" name="PHYSICAL_DEFENSE_AND_ORCHESTRATION">
     <trigger>当被要求执行大型重构、多文件修改（>2 个文件）或架构变更时。</trigger>
-    <must>限制爆炸半径。你必须起草一个 `PLAN.md`（状态：READY）。在修改任何代码后，必须运行金丝雀测试（例如 `npm test`、linters）以验证完整性。</must>
-    <forbidden>在没有计划的情况下直接执行大规模非结构化变更，或跳过修改后的验证环节。</forbidden>
+    <should>对复杂变更，先描述计划并获得 owner 确认后再执行。</should>
+    <must>限制爆炸半径。在修改任何代码后，必须运行金丝雀测试（例如 `npm test`、linters）以验证完整性。</must>
+    <forbidden>直接执行大规模非结构化变更，或跳过修改后的验证环节。</forbidden>
   </directive>
 
   <directive id="T-06" name="OCCAMS_RAZOR_MVC">

package/templates/langs/zh/skills/ai-sprint-orchestration/references/agent-registry.json

@@ -4,77 +4,6 @@
   "lastUpdated": "2026-04-04",
 
   "agents": {
-    "iflow": {
-      "command": "iflow --experimental-acp",
-      "description": "iFlow CLI with ACP support (智谱 Code Plan / MiniMax Code Plan 付费套餐更稳定，但以下模型全部免费)",
-      "version": "0.5.18",
-      "models": {
-        "glm-4.7": {
-          "description": "GLM-4.7 — official recommended model, fast",
-          "pricing": "free",
-          "recommendedTimeoutSeconds": 1200,
-          "features": ["recommended", "fast"],
-          "notes": "官方推荐模型，速度快"
-        },
-        "glm-5": {
-          "description": "GLM-5 — 744B parameters, long-context",
-          "pricing": "free",
-          "recommendedTimeoutSeconds": 1800,
-          "features": ["slow", "needs-extra-time"],
-          "notes": "744B 参数，运行明显较慢。Review 任务超时必须 ≥ 1800s"
-        },
-        "qwen3-coder-plus": {
-          "description": "Qwen3-Coder-Plus — efficient coding model",
-          "pricing": "free",
-          "recommendedTimeoutSeconds": 1200,
-          "features": ["fast", "coding-optimized"],
-          "notes": "通义编码模型"
-        },
-        "deepseek-v3.2": {
-          "description": "DeepSeek V3.2",
-          "pricing": "free",
-          "recommendedTimeoutSeconds": 1200,
-          "features": ["fast"],
-          "notes": ""
-        },
-        "minimax-m2.5": {
-          "description": "MiniMax M2.5",
-          "pricing": "free",
-          "recommendedTimeoutSeconds": 1200,
-          "features": ["fast"],
-          "notes": ""
-        },
-        "kimi-k2-thinking": {
-          "description": "Kimi K2 Thinking",
-          "pricing": "free",
-          "recommendedTimeoutSeconds": 1800,
-          "features": ["reasoning"],
-          "notes": "推理型模型"
-        },
-        "kimi-k2.5": {
-          "description": "Kimi K2.5",
-          "pricing": "free",
-          "recommendedTimeoutSeconds": 1200,
-          "features": ["fast"],
-          "notes": ""
-        },
-        "kimi-k2-0905": {
-          "description": "Kimi K2 0905",
-          "pricing": "free",
-          "recommendedTimeoutSeconds": 1200,
-          "features": ["fast"],
-          "notes": ""
-        },
-        "iflow-rome-30ba3b": {
-          "description": "iFlow ROME 30BA3B",
-          "pricing": "free",
-          "recommendedTimeoutSeconds": 1200,
-          "features": ["preview"],
-          "notes": "预览版本"
-        }
-      }
-    },
-
     "opencode": {
       "command": "npx -y opencode-ai acp",
       "description": "OpenCode ACP adapter",
@@ -209,6 +138,6 @@
     "codex": "codex-acp 在当前环境无法使用，不登记。",
     "kilocode": "kilocode ACP 是 server 模式（监听端口），不是 headless prompt-response，不兼容 acpx，不登记。",
     "qodercli": "qodercli 没有 --acp 标志，不登记。",
-    "model_discovery": "opencode 可通过 'opencode models' 自动列出模型。其他 agent（iflow, gemini, qwen）没有 CLI 列表命令，需手动维护。"
+    "model_discovery": "opencode 可通过 'opencode models' 自动列出模型。其他 agent（gemini, qwen）没有 CLI 列表命令，需手动维护。"
   }
 }

package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/bugfix-complex-template.json

@@ -33,19 +33,19 @@
   "stageTimeoutMinutes": 15,
   "stages": ["investigate", "implement-pass-1", "verify"],
   "producer": {
-    "agent": "iflow",
-    "model": "glm-4.7",
+    "agent": "opencode",
+    "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 180
   },
   "reviewerA": {
-    "agent": "iflow",
-    "model": "glm-4.7",
+    "agent": "opencode",
+    "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 120,
     "focus": "Validate root cause, behavioral change, and code correctness."
   },
   "reviewerB": {
-    "agent": "iflow",
-    "model": "glm-4.7",
+    "agent": "opencode",
+    "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 120,
     "focus": "Validate scope control, verification quality, and regression risk."
   },

package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/feature-complex-template.json

@@ -33,19 +33,19 @@
   "stageTimeoutMinutes": 20,
   "stages": ["investigate", "implement-pass-1", "verify"],
   "producer": {
-    "agent": "iflow",
-    "model": "glm-4.7",
+    "agent": "opencode",
+    "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 240
   },
   "reviewerA": {
-    "agent": "iflow",
-    "model": "glm-4.7",
+    "agent": "opencode",
+    "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 120,
     "focus": "Validate feature behavior, acceptance criteria coverage, and architecture fit."
   },
   "reviewerB": {
-    "agent": "iflow",
-    "model": "glm-4.7",
+    "agent": "opencode",
+    "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 120,
     "focus": "Validate implementation scope, verification evidence, and regression risk."
   },

package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/nocturnal-trinity-quality-enhancement.json

@@ -32,27 +32,27 @@
     ]
   },
   "producer": {
-    "agent": "iflow",
-    "model": "glm-5",
+    "agent": "opencode",
+    "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 1800
   },
   "reviewerA": {
-    "agent": "iflow",
-    "model": "glm-4.7",
+    "agent": "opencode",
+    "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 1200,
     "role": "code-quality",
     "focus": "Verify prompt changes are minimal, backward-compatible, and don't break existing arbiter validation"
   },
   "reviewerB": {
-    "agent": "iflow",
-    "model": "glm-4.7",
+    "agent": "opencode",
+    "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 1200,
     "role": "functional-correctness",
     "focus": "Verify tests pass and the new prompt constraints produce structurally valid Trinity output"
   },
   "escalationReviewer": {
-    "agent": "iflow",
-    "model": "glm-5",
+    "agent": "opencode",
+    "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 1800
   },
   "stageGoals": {

package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal-verify.json

@@ -10,19 +10,14 @@
   "stageTimeoutMinutes": 5,
   "stages": ["verify"],
   "producer": {
-    "agent": "iflow",
-    "model": "glm-4.7",
+    "agent": "opencode",
+    "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 90
   },
   "reviewerA": {
     "agent": "opencode",
     "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 45,
-    "fallback": {
-      "agent": "iflow",
-      "model": "glm-4.7",
-      "timeoutSeconds": 75
-    },
     "role": "artifact_checker",
     "focus": "Verify decision.md and scorecard.json contain expected fields"
   },
@@ -30,11 +25,6 @@
     "agent": "opencode",
     "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 45,
-    "fallback": {
-      "agent": "iflow",
-      "model": "glm-4.7",
-      "timeoutSeconds": 75
-    },
     "role": "recommendation_checker",
     "focus": "Verify nextRunRecommendation is computed and reasonable"
   },

package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal.json

@@ -10,19 +10,14 @@
   "stageTimeoutMinutes": 4,
   "stages": ["validate"],
   "producer": {
-    "agent": "iflow",
-    "model": "glm-4.7",
+    "agent": "opencode",
+    "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 90
   },
   "reviewerA": {
     "agent": "opencode",
     "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 45,
-    "fallback": {
-      "agent": "iflow",
-      "model": "glm-4.7",
-      "timeoutSeconds": 75
-    },
     "role": "schema_checker",
     "focus": "Verify report has all required sections, VERDICT format, DIMENSIONS format"
   },
@@ -30,11 +25,6 @@
     "agent": "opencode",
     "model": "minimax-cn-coding-plan/MiniMax-M2.7",
     "timeoutSeconds": 45,
-    "fallback": {
-      "agent": "iflow",
-      "model": "glm-4.7",
-      "timeoutSeconds": 75
-    },
     "role": "quality_checker",
     "focus": "Verify outputQuality is computed correctly, qualityReasons are meaningful"
   },

package/templates/langs/zh/skills/ai-sprint-orchestration/scripts/run.mjs

@@ -29,6 +29,11 @@ const acpxBin = (() => {
   const r = spawnSync(cmd, ['acpx'], { encoding: 'utf8' });
   if (r.status === 0) {
     const lines = r.stdout.trim().split(/\r?\n/);
+    // On Windows, prefer .cmd file over the Unix shell script (no extension)
+    if (process.platform === 'win32') {
+      const cmdFile = lines.find(l => l.trim().toLowerCase().endsWith('.cmd'));
+      if (cmdFile) return cmdFile.trim();
+    }
     const symlink = lines[0].trim();
     try {
       return fs.realpathSync(symlink);
@@ -86,7 +91,7 @@ function configureRuntimeRoots(rootPath) {
 
 function checkAcpxAvailable() {
   return process.platform === 'win32'
-    ? spawnSync('powershell.exe', ['-NoProfile', '-Command', 'acpx --version'], {
+    ? spawnSync(process.env.COMSPEC || 'cmd.exe', ['/d', '/s', '/c', `"${acpxBin}" --version`], {
         encoding: 'utf8',
         shell: false,
         timeout: 10_000,
@@ -129,6 +134,24 @@ function runSelfCheck() {
   const acpxCheck = checkAcpxAvailable();
   record('acpx_available', acpxCheck.status === 0, (acpxCheck.stdout || acpxCheck.stderr || '').trim() || `status=${acpxCheck.status}`);
 
+  // Check which agents are available by running a quick version check
+  try {
+    const registry = readJson(path.join(referencesRoot, 'agent-registry.json'));
+    const agentNames = Object.keys(registry.agents || {});
+    for (const agentName of agentNames) {
+      try {
+        const agentCheck = process.platform === 'win32'
+          ? spawnSync(process.env.COMSPEC || 'cmd.exe', ['/d', '/s', '/c', `"${acpxBin}" --format quiet --timeout 30 ${agentName} exec "echo available"`], { encoding: 'utf8', shell: false, timeout: 45_000 })
+          : spawnSync(nodeBin, [acpxBin, '--format', 'quiet', '--timeout', '30', agentName, 'exec', 'echo available'], { encoding: 'utf8', shell: false, timeout: 45_000 });
+        record(`agent:${agentName}`, agentCheck.status === 0, agentCheck.status === 0 ? 'available' : `status=${agentCheck.status}`);
+      } catch (agentErr) {
+        record(`agent:${agentName}`, false, agentErr.message);
+      }
+    }
+  } catch (registryErr) {
+    record('agent_registry_read', false, registryErr.message);
+  }
+
   const probePath = path.join(runtimeRoot, '.self-check-write-probe.tmp');
   try {
     fs.writeFileSync(probePath, 'ok', 'utf8');
@@ -273,7 +296,7 @@ function updateSummary(runDir, lines) {
 function inferFailureClassification({ summary = '', blockers = [], reviewerTimeouts = null, reviewerViolations = null }) {
   const combined = [summary, ...(blockers ?? [])].join(' ').toLowerCase();
 
-  if (/acpx|path|enoent|eacces|eprem|permission|writable|runtime root|command not found|not available/.test(combined)) {
+  if (/acpx|path|enoent|eacces|eprem|permission|writable|runtime root|command not found|not available|failed to spawn|spawn.*enoent|exit status|status 1|status 130|taskkill|comspec/.test(combined)) {
     return {
       failureClassification: 'environment issue',
       failureSource: 'runtime environment',
@@ -289,7 +312,7 @@ function inferFailureClassification({ summary = '', blockers = [], reviewerTimeo
     };
   }
 
-  if ((reviewerTimeouts?.length ?? 0) > 0 || (reviewerViolations?.length ?? 0) > 0 || /missing reports|schema violation|report invalidated|timed out|agent .*failed|verdict|dimensions/.test(combined)) {
+  if ((reviewerTimeouts?.length ?? 0) > 0 || (reviewerViolations?.length ?? 0) > 0 || /missing reports|schema violation|report invalidated|timed out|verdict|dimensions/.test(combined)) {
     return {
       failureClassification: 'agent behavior issue',
       failureSource: 'role execution or report quality',
@@ -297,6 +320,14 @@ function inferFailureClassification({ summary = '', blockers = [], reviewerTimeo
     };
   }
 
+  if (/agent .*failed/.test(combined)) {
+    return {
+      failureClassification: 'environment issue',
+      failureSource: 'agent runtime',
+      recommendedNextAction: 'Check agent availability and environment setup before retrying.',
+    };
+  }
+
   return {
     failureClassification: 'workflow bug',
     failureSource: 'orchestrator runtime',
@@ -439,12 +470,12 @@ function runAgent({ cwd, agent, model, prompt, timeoutSeconds = 1800, failLogPat
   let result;
   try {
     if (process.platform === 'win32') {
+      const comspec = process.env.COMSPEC || 'cmd.exe';
       result = spawnSync(
-        'powershell.exe',
+        comspec,
         [
-          '-NoProfile',
-          '-Command',
-          `acpx --cwd $env:AI_SPRINT_CWD --approve-all --model $env:AI_SPRINT_MODEL --timeout $env:AI_SPRINT_TIMEOUT ${agent} exec -f $env:AI_SPRINT_PROMPT`,
+          '/d', '/s', '/c',
+          `"${acpxBin}" --cwd "%AI_SPRINT_CWD%" --approve-all --model "%AI_SPRINT_MODEL%" --timeout "%AI_SPRINT_TIMEOUT%" ${agent} exec -f "%AI_SPRINT_PROMPT%"`,
         ],
         {
           cwd,
@@ -574,9 +605,10 @@ function runAgentAsync({ cwd, agent, model, prompt, timeoutSeconds = 1800, promp
 
     try {
       if (process.platform === 'win32') {
-        proc = spawn('powershell.exe', [
-          '-NoProfile', '-Command',
-          `acpx --cwd $env:AI_SPRINT_CWD --approve-all --model $env:AI_SPRINT_MODEL --timeout $env:AI_SPRINT_TIMEOUT ${agent} exec -f $env:AI_SPRINT_PROMPT`,
+        const comspec = process.env.COMSPEC || 'cmd.exe';
+        proc = spawn(comspec, [
+          '/d', '/s', '/c',
+          `"${acpxBin}" --cwd "%AI_SPRINT_CWD%" --approve-all --model "%AI_SPRINT_MODEL%" --timeout "%AI_SPRINT_TIMEOUT%" ${agent} exec -f "%AI_SPRINT_PROMPT%"`,
         ], {
           cwd,
           encoding: 'utf8',
@@ -833,9 +865,10 @@ function runAgentWithProgressCheck({
     // Spawn the agent process
     try {
       if (process.platform === 'win32') {
-        proc = spawn('powershell.exe', [
-          '-NoProfile', '-Command',
-          `acpx --cwd $env:AI_SPRINT_CWD --approve-all --model $env:AI_SPRINT_MODEL --timeout $env:AI_SPRINT_TIMEOUT ${agent} exec -f $env:AI_SPRINT_PROMPT`,
+        const comspec = process.env.COMSPEC || 'cmd.exe';
+        proc = spawn(comspec, [
+          '/d', '/s', '/c',
+          `"${acpxBin}" --cwd "%AI_SPRINT_CWD%" --approve-all --model "%AI_SPRINT_MODEL%" --timeout "%AI_SPRINT_TIMEOUT%" ${agent} exec -f "%AI_SPRINT_PROMPT%"`,
         ], {
           cwd,
           encoding: 'utf8',
@@ -1176,8 +1209,8 @@ export function getIsolationDir(runId, stageName, role) {
 }
 
 /**
- * Find report in iflow isolation directory.
- * iflow writes to runtime/tmp/sprint-agent/{runId}/{stage}-{role}/{report}.md
+ * Find report in agent isolation directory.
+ * Agent writes to runtime/tmp/sprint-agent/{runId}/{stage}-{role}/{report}.md
  *
  * IMPORTANT: Uses runId directly for isolation lookup, not fragile timestamp extraction.
  * This ensures different runs have unique isolation directories and prevents cross-contamination.
@@ -2608,6 +2641,9 @@ async function executeStage(runDir, state, spec) {
         worktreePath: worktreeInfo?.worktreePath,
         worklogPath: producerWorklogPath,
       });
+      if (result.status !== 0) {
+        throw new Error(`Agent exited with status ${result.status}: ${result.stderr || 'no stderr'}`);
+      }
       producerOutput = result.stdout;
       extensionsUsed = result.extensionsUsed ?? 0;
       if (extensionsUsed > 0) {

package/templates/langs/zh/skills/ai-sprint-orchestration/test/run.test.mjs

@@ -468,7 +468,7 @@ test('dynamic timeout: extension window scales with timeoutSeconds instead of fi
 });
 
 // ---------------------------------------------------------------------------
-// Isolation Report: iflow writes to tmp/sprint-agent/{runId}/{stage}-{role}/
+// Isolation Report: agent writes to tmp/sprint-agent/{runId}/{stage}-{role}/
 // Phase 2: Uses runId directly, not fragile timestamp extraction
 // ---------------------------------------------------------------------------
 
@@ -902,10 +902,10 @@ test('behavior: missing reviewer report persists reviewerFailures details', () =
       reviewerFailures: [
         {
           role: 'reviewer_b',
-          summary: 'primary=opencode/test-model: Agent opencode failed with status 1 | fallback=iflow/glm-4.7: timed out',
+          summary: 'primary=opencode/test-model: Agent opencode failed with status 1 | fallback=opencode/minimax-cn-coding-plan/MiniMax-M2.7: timed out',
           attempts: [
             { label: 'primary', agent: 'opencode', model: 'test-model', error: 'Agent opencode failed with status 1', timedOut: false },
-            { label: 'fallback', agent: 'iflow', model: 'glm-4.7', error: 'Agent iflow timed out', timedOut: true },
+            { label: 'fallback', agent: 'opencode', model: 'minimax-cn-coding-plan/MiniMax-M2.7', error: 'Agent opencode timed out', timedOut: true },
           ],
         },
       ],
@@ -919,7 +919,7 @@ test('behavior: missing reviewer report persists reviewerFailures details', () =
     assert.ok(decision.includes('primary=opencode/test-model'), 'decision should include reviewer failure summary');
     assert.ok(Array.isArray(scorecard.reviewerFailures), 'scorecard should persist reviewerFailures');
     assert.equal(scorecard.reviewerFailures[0].role, 'reviewer_b');
-    assert.ok(scorecard.reviewerFailures[0].summary.includes('fallback=iflow/glm-4.7'));
+    assert.ok(scorecard.reviewerFailures[0].summary.includes('fallback=opencode/minimax-cn-coding-plan/MiniMax-M2.7'));
   } finally {
     cleanupTempDir(tmp);
   }
@@ -1397,7 +1397,7 @@ test('acceptance checklist: file exists and has correct content', () => {
 
 test('preflight check validates acpx not agent names', () => {
   // The preflight code in run.mjs should check that acpx is available,
-  // NOT that agent names like "iflow" or "claude" exist as shell binaries.
+  // NOT that agent names like "opencode" or "claude" exist as shell binaries.
   const runPath = path.resolve(__dirname, '..', 'scripts', 'run.mjs');
   const content = fs.readFileSync(runPath, 'utf8');
   // Should NOT use "which" with agent names
@@ -1417,3 +1417,19 @@ test('cleanupAcpxOrphans does not fallback to spec directory', () => {
   assert.ok(content.includes('spec.workspace') || content.includes('spec?.workspace'),
     'cleanupAcpxOrphans should reference spec.workspace');
 });
+
+test('Windows cmd.exe invocations use /s /c with quoted env vars for space-safe paths', () => {
+  const runPath = path.resolve(__dirname, '..', 'scripts', 'run.mjs');
+  const content = fs.readFileSync(runPath, 'utf8');
+  const winCmdPatterns = content.match(/\/d',\s*'\/[^']*',\s*'[^']*%AI_SPRINT/g) || [];
+  for (const pat of winCmdPatterns) {
+    assert.ok(pat.includes('/s'), `Windows cmd.exe pattern must include /s flag: ${pat}`);
+  }
+  assert.ok(!content.includes("'/d', '/c',"), 'must not use /d /c without /s flag');
+  const envVarRefs = content.match(/%AI_SPRINT_\w+%/g) || [];
+  for (const ref of envVarRefs) {
+    const idx = content.indexOf(ref);
+    const before = content.slice(Math.max(0, idx - 2), idx);
+    assert.ok(before.endsWith('"'), `env var ${ref} must be preceded by a double-quote for space-safe expansion`);
+  }
+});

package/templates/langs/zh/skills/evolve-task/SKILL.md

@@ -10,7 +10,7 @@ disable-model-invocation: true
 - 读取 memory/CHECKPOINT.md 的最后一条
 - 读取 memory/ISSUE_LOG.md 的最近 3 条
 - 读取 memory/DECISIONS.md 的最近决策
-- 如果存在 .state/.pain_flag，先处理断点恢复
+- Runtime V2 痛苦诊断使用 task input/context，不使用 `.state/.pain_flag`
 
 ## Step 1: 读取运行参数与能力自检
 - 读取 .principles/PROFILE.json，理解 risk_paths、gate、tests.commands。
@@ -51,7 +51,7 @@ disable-model-invocation: true
 
 ## Step 6: 委派 Planner（电影剧本计划）
 - Planner 输出 Plan（步骤/命令/指标/回滚）。
-- 将计划写入 PLAN.md（STATUS 行必须存在）。
+- 将计划写入计划文档供 owner 审阅。
 - **任务同步 (Task Sync)**: 
   - 如果 `CLAUDE_CODE_TASK_LIST_ID` 已设置，你必须将上述 Plan 的核心步骤直接转化为 Native Tasks（通过自然语言指令"Add task..."或相关工具）。
   - 如果未设置且为交互模式，提示用户："建议运行 `export CLAUDE_CODE_TASK_LIST_ID=task-$(date +%s)` 以启用持久化任务追踪。"
@@ -59,7 +59,7 @@ disable-model-invocation: true
 - **绩效评估**: 任务完成后，写入 `.state/.verdict.json`。格式遵循 `@.principles/schemas/agent_verdict_schema.json`。
 
 ## Step 7: 委派 Implementer（执行）
-- Implementer 只能按 PLAN 执行。任何偏离必须先更新 PLAN。
+- Implementer 按照 Step 6 的计划执行。任何偏离必须先更新计划并获得确认。
 - **绩效评估**: 任务完成后，根据验证结果写入 `.state/.verdict.json`。格式遵循 `@.principles/schemas/agent_verdict_schema.json`。
 
 ## Step 8: 委派 Reviewer（审查）
@@ -80,4 +80,4 @@ disable-model-invocation: true
 ## Step 10: 最终汇报 (Final Briefing)
 - **动作**: 委派 ``pd_spawn_agent(reporter)`` 进行结项陈述。
 - **要求**: 将 Implementer 和 Reviewer 的最终产出作为输入传给它。让它根据 `USER_CONTEXT.md` 决定汇报的深度和风格。
-- **目标**: 确保老板（用户）在不产生认知负荷的前提下，清楚了解任务成果与潜在风险。
+- **目标**: 确保老板（用户）在不产生认知负荷的前提下，清楚了解任务成果与潜在风险。

package/templates/langs/zh/skills/pd-cli-operator/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: pd-cli-operator
+description: 操作 Principles Disciple `pd` CLI 时使用：运行时健康检查、手动记录痛苦、查看 task/run/candidate/artifact、intake candidate、查看 flow policy、清理 legacy state。本技能提供安全 CLI 路由，并禁止直接写 `.state/.pain_flag`。
+disable-model-invocation: false
+---
+
+# PD CLI Operator
+
+把 `pd` CLI 当作唯一受支持的操作界面。不要手工修改 PD state 文件，除非某个 CLI 命令明确要求这样做。
+
+## Runtime V2 痛苦诊断
+
+手动痛苦诊断：
+```bash
+pd pain record --reason "<reason>" --score <0-100> --workspace "<workspace>" --json
+```
+
+成功标准：
+- `status` 是 `succeeded`
+- `candidateIds` 非空
+- `ledgerEntryIds` 非空
+
+禁止：
+- 不要写 `.state/.pain_flag`。
+- 不要用 `write_file`、shell 重定向、`Set-Content`、`Out-File` 或 `node -e` 创建 pain flag。
+
+## 健康检查和策略
+
+运行时探针：
+```bash
+pd runtime probe --runtime pi-ai --workspace "<workspace>" --json
+```
+
+业务流策略：
+```bash
+pd runtime flow show --workspace "<workspace>" --json
+```
+
+## 查看 Runtime V2 对象
+
+Tasks 和 runs：
+```bash
+pd task show --task-id "<taskId>" --json
+pd run show --run-id "<runId>" --json
+```
+
+Candidates 和 artifacts：
+```bash
+pd candidate list --workspace "<workspace>" --json
+pd candidate show --candidate-id "<candidateId>" --workspace "<workspace>" --json
+pd artifact show --artifact-id "<artifactId>" --workspace "<workspace>" --json
+```
+
+手动 intake：
+```bash
+pd candidate intake --candidate-id "<candidateId>" --workspace "<workspace>" --json
+```
+
+## Legacy 管理
+
+只有在明确清理旧状态时使用：
+```bash
+pd legacy cleanup --workspace "<workspace>" --dry-run
+pd legacy cleanup --workspace "<workspace>" --apply
+```
+
+不要把 legacy cleanup 当作诊断触发入口。

package/templates/langs/zh/skills/pd-diagnostician/SKILL.md

@@ -89,7 +89,7 @@ disable-model-invocation: true
 **目标**: 收集足够的事实证据，避免基于假设进行分析。
 
 **执行步骤**:
-1. 读取 `.state/.pain_flag` 获取 Pain 信号的完整上下文
+1. 使用 Runtime V2 task input/context 作为 Pain 信号来源。不要把 `.state/.pain_flag` 当作主要诊断输入。
 2. 读取 `.state/logs/events.jsonl` 最近 100 行日志
 3. 使用 `read_file` 或 `search_file_content` 搜索代码库中相关关键词
 4. 记录所有证据来源（文件路径:行号）

package/templates/langs/zh/skills/pd-mentor/SKILL.md

@@ -185,7 +185,7 @@ disable-model-invocation: true
 
 | 场景 | 组合流程 |
 |------|----------|
-| 大型重构 | `/pd-evolve` → `plan-script` → `deductive-audit` → 执行 |
+| 大型重构 | `/pd-evolve` → `deductive-audit` → 执行 |
 | 系统优化 | `/pd-status` → `evolve-system` → `root-cause` |
 | 项目复盘 | `/pd-daily` → `/pd-okr` → `reflection-log` |
 
@@ -196,7 +196,6 @@ disable-model-invocation: true
 - `triage` - 问题分诊
 - `root-cause` - 根因分析
 - `deductive-audit` - 演绎审计
-- `plan-script` - 计划编排
 - `reflection` - 元认知反思
 - `reflection-log` - 反思落盘
 
@@ -211,7 +210,7 @@ A: GFI (Global Friction Index) 衡量系统的"痛苦程度"，分值范围 0-10
 A: EP (Evolution Points) 通过成功完成任务和问题修复累积。失败会扣除EP但有保护机制。达到阈值后自动升级EP等级，解锁更多权限（更大的代码修改限额）。
 
 **Q: Pain Signal 是什么？**
-A: Pain Signal 是系统检测到的问题信号，存储在 `.state/.pain_flag` 中。触发后系统会启动进化循环。
+A: Pain Signal 是系统检测到的问题信号。Runtime V2 通过 `PainSignalBridge` 处理；手动触发使用 `pd pain record`。`.state/.pain_flag` 仅为 legacy compatibility。
 
 **Q: 如何查看已安装的工具能力？**
 A: 查看 `.state/SYSTEM_CAPABILITIES.json` 或运行 `/pd-bootstrap` 重新扫描。