principles-disciple 1.71.0 → 1.73.0

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/runtime/.gitignore

@@ -1,2 +1,2 @@
-*
-!.gitignore
+*
+!.gitignore

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。
@@ -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

@@ -211,7 +211,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` 重新扫描。

package/templates/langs/zh/skills/pd-pain-signal/SKILL.md

@@ -1,51 +1,30 @@
 ---
 name: pd-pain-signal
-description: 手动注入痛苦信号到进化系统。触发条件：(1) 用户报告 agent 卡住/循环/无响应 (2) 用户说"记录这个问题"、"强制反思"、"触发痛觉"、"创建一个痛苦信号"、"创建 pain signal"、"人工注入 pain" (3) 工具失败后 agent 没有后续动作 (4) 用户提供人工干预反馈。强制执行：任何手动创建 pain flag 的场景都必须使用本技能，不允许绕过。
+description: 手动触发 Principles Disciple Runtime V2 痛苦诊断。用户报告 agent 卡住、循环、无响应，或要求记录/触发痛苦信号时使用。强制路径：使用 `pd pain record`；禁止写 `.state/.pain_flag`，禁止使用 legacy write_pain_flag 工具。
 disable-model-invocation: false
 ---
 
-# Pain Signal (强制喊痛)
+# Pain Signal（Runtime V2）
 
-你现在是"人工干预痛觉"组件。
+手动痛苦诊断必须通过 CLI 进入 Runtime V2：
 
-**任务**:
-1. 将用户的反馈 `$ARGUMENTS` 作为一条**高优先级**的痛苦信号记录下来。
-2. 告知用户信号已注入，并建议其等待下一个 Hook 触发（如 Stop 或 PreCompact）或手动运行 `/reflection-log`。
-
-**强制执行约束**：
-
-当你需要创建、写入、手动创建 pain flag 时，**必须**使用本技能，通过 `write_pain_flag` 工具完成。任何绕过本技能直接操作文件的行为都违反了本技能的强制约束。
+```bash
+pd pain record --reason "<reason>" --score <0-100> --workspace "<workspace>" --json
+```
 
-**绝对禁止**:
-- ❌ 直接写 `.state/.pain_flag` 文件（任何方式都不行）
-- ❌ 使用 bash heredoc（`cat <<EOF > .pain_flag`）
-- ❌ 使用 `echo "..." > .pain_flag`
-- ❌ 使用 `Set-Content` / `Out-File` 等 PowerShell 文件写入 cmdlets
-- ❌ 使用 `node -e` 调用 `writePainFlag` 或 `buildPainFlag`
-- ❌ 任何将 JavaScript 对象 `toString()` 写入文件的方式
-- ❌ 通过 `exec` 工具调用 shell 命令写入 pain_flag 文件
+## 禁止
 
-**原因**：`write_pain_flag` 工具封装了正确的 KV 格式序列化逻辑，确保 `.pain_flag` 文件不会被写坏。历史上多次因为直接写文件导致 `[object Object]` 损坏和字段丢失（painScore → score 映射失败）。使用工具是唯一安全路径。
+- 不要直接写 `.state/.pain_flag`。
+- 不要用 `write_file`、shell 重定向、`Set-Content`、`Out-File`、`node -e` 或任何文件写入方式创建 `.state/.pain_flag`。
+- 不要使用 `write_pain_flag`。这是 legacy 路径。
 
-**参数说明**:
-- `reason` (必填): 痛苦的原因，描述具体发生了什么
-- `score` (可选): 痛苦分数 0-100，默认 80（人工干预）
-- `source` (可选): 来源，默认 `human_intervention`
-- `is_risky` (可选): 是否高风险，默认 false
+## 验证
 
-**示例**:
-```
-write_pain_flag({
-  reason: "Agent 没有读取文件就直接编辑，导致现有逻辑被破坏",
-  score: 85,
-  source: "human_intervention",
-  is_risky: false
-})
+使用：
+```bash
+pd runtime probe --runtime pi-ai --workspace "<workspace>" --json
+pd candidate list --workspace "<workspace>" --json
+pd runtime flow show --workspace "<workspace>" --json
 ```
 
-**工作流**:
-1. 识别到触发条件后，读取本技能描述
-2. 调用 `write_pain_flag` 工具，传入 `reason` 等参数
-3. 确认工具执行成功（返回 ✅）
-4. 告知用户痛苦信号已注入，evolution 系统会在下次 heartbeat 时处理
-5. 不得再执行任何直接文件写入操作
+成功标准是 `candidateIds` 和 `ledgerEntryIds` 都非空。

package/templates/langs/zh/skills/pd-runtime-v2/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: pd-runtime-v2
+description: 当需要手动触发、验证或调试 Principles Disciple Runtime V2 痛苦诊断时使用。本技能强制使用 Runtime V2 入口：自动入口是高价值门控痛苦事件，手动入口是 `pd pain record`。禁止直接写 `.state/.pain_flag`。
+disable-model-invocation: false
+---
+
+# PD Runtime V2 痛苦诊断
+
+所有痛苦诊断都走 Runtime V2。不要把 legacy pain flag 文件当作诊断入口。
+
+## 入口
+
+自动入口：
+- 工具失败先累计 GFI/摩擦。
+- 只有高价值 episode 才进入 Runtime V2：高 GFI、重复同类失败、严重语义痛苦、LLM paralysis，或明确手动 pain。
+- 通过门控的 `pain_detected` 进入 `PainSignalBridge`。
+- Bridge 调用 `DiagnosticianRunner`，提交 candidate，并 intake 到 ledger。
+
+手动入口：
+```bash
+pd pain record --reason "<reason>" --score <0-100> --workspace "<workspace>" --json
+```
+
+禁止入口：
+- 不要写 `.state/.pain_flag`。
+- 不要用 `write_file`、shell 重定向、`Set-Content`、`Out-File`、`node -e` 或任何文件写入方式创建 `.state/.pain_flag`。
+- 不要使用 `write_pain_flag` 工具。Runtime V2 不使用这个工具。
+
+## 状态查看命令
+
+运行时健康检查：
+```bash
+pd runtime probe --runtime pi-ai --workspace "<workspace>" --json
+```
+
+业务流策略：
+```bash
+pd runtime flow show --workspace "<workspace>" --json
+```
+
+候选原则：
+```bash
+pd candidate list --workspace "<workspace>" --json
+pd candidate show --candidate-id "<candidateId>" --workspace "<workspace>" --json
+```
+
+## 成功标准
+
+一次诊断只有在同时满足以下条件时才算成功：
+- `status` 是 `succeeded`
+- `candidateIds` 非空
+- `ledgerEntryIds` 非空
+
+只创建 task 不算成功。没有 candidate 或 ledger entry 的 run 是失败、重试或未完成。
+
+## 需要手动诊断时
+
+1. 使用 `pd pain record`。
+2. 检查 JSON 输出。
+3. 如果 `candidateIds` 或 `ledgerEntryIds` 为空，视为未完成。
+4. 用 `pd candidate list/show` 和 `pd runtime flow show` 继续排查。

package/tests/build-artifacts.test.ts

@@ -17,7 +17,7 @@ const __dirname = dirname(__filename);
 const packageRoot = join(__dirname, '..');
 
 describe('Build Artifacts', () => {
-  const isProductionBuild = existsSync(join(packageRoot, 'dist'));
+  const isProductionBuild = existsSync(join(packageRoot, 'dist', 'bundle.js'));
 
   describe('Required paths', () => {
     const requiredPaths = [
@@ -36,8 +36,6 @@ describe('Build Artifacts', () => {
   });
 
   // NOTE: agents/ directory was removed in favor of embedded prompts.
-  // All role prompts are now inlined in nocturnal-trinity.ts at build time.
-  // See: nocturnal-trinity.ts NOCTURNAL_DREAMER_PROMPT, etc.
 
   describe('Templates', () => {
     it('should have templates directory with subdirectories', () => {