46afea83c2
管道本來就是好的(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>
3. Specs — 需求 + SDD + 進度
各子系統的設計文檔 + 任務清單。
進行中(必讀)
| 目錄 | Phase | 狀態 |
|---|---|---|
| portal-auth/ | — | 現行 active(唯一,D35 單一活性) |
| arcrun/kbdb-base/ | Phase 7 | 上線完成 + 待處理(§8) |
「進行中」以各 design.md frontmatter
status: active為唯一判準:bash system-dev/scripts/sdd-active-check.sh。
已封存(archive/,closed)
| 目錄 | 封存日 | 備註 |
|---|---|---|
| archive/credential-primitives-wasm/ | 2026-07-21 | 主線達成(cypher-executor TS 無 credential/auth 邏輯)。現行做法=CF Workers Secrets + D1 目錄。殘留缺口 auth_mtls 未實作、7.6 端到端未驗 → 要做需另立新 SDD |
主線
| 目錄 | 內容 | 狀態 |
|---|---|---|
| arcrun-core-mvp/ | MVP 整體架構 | 基礎完成 |
| arcrun/auth-recipe.md | Auth recipe 系統 | 穩定 |
| arcrun/landing-page.md | Landing page | 設計中 |
| arcrun/sdk-and-website/ | SDK + MCP + 文檔 | 進行中 |
| arcrun-platform-evolution/ | 長期演化規劃 | 路線圖 |
安全 & 基礎設施
| 目錄 | 用途 |
|---|---|
| component-gatekeeping/ | 零件投稿 gatekeeping(PR + CI) |
| component-registry-canon/ | registry 規範化(dead storage cleanup) |
| data-exfil-warning/ | 資料外流警示 API 層實作 |
未來
| 目錄 | 用途 |
|---|---|
| llm-interface/ | AI 操盤手體驗改進(mira dogfood 痛點) |
| recipe-system/ | recipe 長期規範(§5 onwards) |
| resumable-workflow/ | workflow 暫停恢復(Phase 6) |
| user-cc-harness/ | CC harness 安裝 + 配置(Phase 7) |
讀 SDD 的順序
新任務開始:
docs/3-specs/arcrun/arcrun.md(全景進度)- 對應子系統的
design.md(設計背景) - 同目錄的
tasks.md(細節任務 + 依賴)
更新時間:2026-06-08