步驟1 最後一筆：install-harness 交付內容升級到現世代＋世代閘

管道本來就是好的（install-harness 功能完整、冪等），**過時的是內容**：
harness skill（4066B）grep「意圖」「>>」= 0 命中，只講世界觀／別寫 Python
⇒ 新裝的封測者拿不到步驟 1 的核心教材（`>>` 意圖語法）。

■ 單一真相源：harness skill 改為建置期由 registry 複製
  build-harness-skill.mjs＝head ＋ registry/skills/write_intent_workflow.md 正文 ＋ tail。
  選「建置期複製」的理由：npm files 只收 harness/，registry 不進套件；
  symlink 在 npm pack 與 Windows 不可靠。產物 commit 進 repo（npm 裝的是產物、不跑 build）。
  head/tail 是 harness 專屬（CLI 語境入口／acr 指令表／暴露同意／誠實鐵律），
  install-harness 的 copyTree 跳過 .head/.tail，不鋪進使用者專案。

■ 其餘三件逐份對照現世代事實後更新（過時的直接刪，不留死代碼）
  - CLAUDE.block.md：補 >> 意圖語法、not_found 兩條路、零件 vs recipe 分型、
    腹語術紅線、金鑰只拿名字
  - commands/arcrun.md：步驟改成「先寫意圖 → 丟去查 → 再寫 YAML」，補 acr search／validate
  - hooks/arcrun-guard.sh：**正路提示改為指向 arcrun-mindset Skill ＋意圖語法**
    （呼應「hook 沒提 skill 反而把 AI 導向 repo 文件」的教訓）；
    新增 code 節點腹語術提醒，settings.fragment 補 Write|Edit|MultiEdit matcher

■ 世代閘（防再度脫節）
  check-harness-generation.mjs 檢查四件交付物的現世代指紋，缺指紋 exit 1，
  掛進 npm run build（prepublishOnly 因此也擋）。
  反向驗證：把 skill／CLAUDE.block 換回上一代 → 兩者都被擋下並逐條點名缺哪個指紋。

■ 驗收（考生 haiku／受測物＝環境）
  乾淨臨時目錄 acr install-harness → 四件鋪好；重跑冪等（全檔 md5 不變、
  CLAUDE.md 66 行不變、hooks 條目 2 不變、arcrun 區塊仍 1 個）。
  haiku 只讀該目錄的 CLAUDE.md＋SKILL.md（明令禁讀 ~/.claude、禁上網；
  兩份教材 md5 與大小均不同，可證非考本機那支）答十題
  → grade-step1.sh **10 / 10 通過**（判分器同時反向驗證仍會抓
  ON_TRUE／ON_FAILURE／第一節點非 input）。
  npm test 18/18、tsc 綠。

SDD：workflow-discovery/tasks.md 3.11

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

cli/scripts/build-harness-skill.mjs

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+/**
+ * build-harness-skill.mjs — 由 registry/skills/ 組出 harness 的 arcrun-mindset SKILL.md
+ *
+ * 【為什麼是「建置期複製」而不是人工維護兩份】
+ * `registry/skills/write_intent_workflow.md` 是意圖語法的**單一真相源**——它同時是
+ * MCP `arcrun_get_skill()` 回給雲端 AI 的內容。harness 的 skill 若人工再抄一份，
+ * 兩份必然漂移（2026-07-31 實錄：harness 那份停在上一代，grep「意圖」「>>」= 0 命中，
+ * 只講世界觀，害新裝的用戶 AI 學不到 `>>`）。
+ *
+ * 作法：harness skill = 三段拼接
+ *   SKILL.md.head            ← harness 專屬（frontmatter／CLI 入口／三種東西的分型）
+ *   registry 的 write_intent_workflow.md 正文  ← 單一真相源，只此一份被維護
+ *   SKILL.md.tail            ← harness 專屬（acr 指令表／暴露同意／誠實鐵律）
+ *
+ * 為什麼不用 symlink / npm 打包直接引用：npm `files` 只收 `harness/`，
+ * registry/ 不進套件；symlink 在 npm pack 與 Windows 上不可靠。建置期複製最單純。
+ *
+ * 產物 `SKILL.md` **有 commit 進 repo**（npm 套件裝的是它，不會跑 build），
+ * 由 check-harness-generation.mjs 驗證它與 registry 沒有漂移。
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const here = dirname(fileURLToPath(import.meta.url));       // cli/scripts
+const repoRoot = join(here, '..', '..');                    // repo 根
+const skillDir = join(here, '..', 'harness', 'skills', 'arcrun-mindset');
+const registrySkill = join(repoRoot, 'registry', 'skills', 'write_intent_workflow.md');
+
+const head = readFileSync(join(skillDir, 'SKILL.md.head'), 'utf8').trimEnd();
+const tail = readFileSync(join(skillDir, 'SKILL.md.tail'), 'utf8').trimEnd();
+const body = readFileSync(registrySkill, 'utf8');
+
+// 取 registry skill 的正文：去掉它自己的 H1 標題與「何時用這個 skill」那段
+// （harness 的 head 已用 CLI 語境寫過入口），從第一個 `## 1.` 章節起收。
+const idx = body.indexOf('## 1. 意圖工作流的語法');
+if (idx < 0) {
+  console.error('❌ registry/skills/write_intent_workflow.md 找不到「## 1. 意圖工作流的語法」章節；');
+  console.error('   registry skill 結構變了 → 請同步更新 cli/scripts/build-harness-skill.mjs 的取段規則。');
+  process.exit(1);
+}
+const middle = body
+  .slice(idx)
+  // registry 版把 MCP 工具當預設介面；harness 裝在有 acr CLI 的專案 → 補上 CLI 等價指令
+  .replace(/`arcrun_get_workflow\(<name>\)`/g, '`acr logs <name>`（有 MCP 則 `arcrun_get_workflow(<name>)`）')
+  .replace(/`arcrun_list_components` \/ `arcrun_search_components`/g, '`acr parts` / `acr search`')
+  .replace(/下一步該讀哪支 skill：`arcrun_list_skills\(\)`/g, '下一步該讀哪支 skill（需 MCP）：`arcrun_list_skills()`')
+  .trimEnd();
+
+const out = [
+  head,
+  '',
+  '<!-- 以下正文由 registry/skills/write_intent_workflow.md 於建置期複製而來（單一真相源）。',
+  '     不要直接編輯本段——改 registry 那份，然後跑 `npm run build:harness`。 -->',
+  '',
+  middle,
+  '',
+  tail,
+  '',
+].join('\n');
+
+writeFileSync(join(skillDir, 'SKILL.md'), out, 'utf8');
+console.log(`✓ harness skill 已由 registry 重建：${out.length} bytes`);