chore(wiki): 本 session capture(薄殼防複發/歷史債卡 + mistakes #19-21 + status)
兩次 /wiki-capture 累積的知識落盤: - cards/decisions/ 新卡:薄殼防複發-能力對照表加smoke、薄殼規則晚於實作-MCP漂移是歷史債 (+ 00-INDEX 編入,決策桶現 15 張) - mistakes #19 死端點假綠(grep route/smoke 驗端點存在) - mistakes #20 gitignored 檔無 git 史(時間靠檔內註記) - mistakes #21 wrangler.toml services=[...] inline 在 [vars] 後被吸成 vars.services(issue #12) - decisions-summary:薄殼防複發機制、workflow description 由操盤 CC 據實生成 - status:本 session #8/#11/#12 進度 + merge 結果 純記憶/文檔,無 code。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -327,6 +327,41 @@ code-node 規則已定、零件實作屬 wishlist C1 另案。**詳見**:DECIS
|
||||
|
||||
---
|
||||
|
||||
## 薄殼防複發機制=對照清單 + 本機 smoke(2026-06-27,issue #11)
|
||||
|
||||
**Q:CLI/MCP 薄殼漂移(死端點假綠)怎麼防複發?**
|
||||
|
||||
**決策**:雙層,非 CI。
|
||||
- **層 1 能力對照清單** `docs/4-guides/cli-mcp-capability-matrix.md`:一張表「能力 × CLI 端點 × MCP 端點 × route 存在? × 同源?」,新增薄殼能力**必填一行**,PR review 對照。
|
||||
- **層 2 本機 smoke test** `scripts/thin-shell-smoke.sh`:對每能力打真端點、**斷言非 404**(死端點當場現形)。**本機手動跑非 CI/cron/輪詢**(守 flag 紅線,對齊「執行鏈路不依賴 CI」)。
|
||||
- **機制自驗**:注入故意死端點 → smoke 當場攔(已驗證能攔,exit 1)。
|
||||
|
||||
**為什麼**:根因是**假綠**——宣稱「一致性落地」但端點不存在,光靠宣稱會再犯。smoke 區分「code 有 route」vs「prod 真部署」(首跑就揭 #8 search/backfill 在 prod 仍 404=未部署)。
|
||||
|
||||
**避坑**:不用 CI 高頻打真端點(違 flag 紅線);smoke 是「宣布完成前手動跑一次」的閘。
|
||||
|
||||
**詳見**:thin-shell-alignment SDD §5、[[薄殼規則晚於實作-MCP漂移是歷史債]] 卡、mistakes #19。
|
||||
|
||||
---
|
||||
|
||||
## workflow description 由操盤 CC 據實生成、用戶可改(2026-06-27,issue #8)
|
||||
|
||||
**Q:強制 workflow 填 description,但 low-code 用戶不知道要填,怎麼辦?**
|
||||
|
||||
**決策**:強制非空落 API(不變);**空時由操盤的 CC 據實寫一句「能做什麼」,用戶可改**——非逼用戶手填、非介面層機械塞佔位。
|
||||
|
||||
**調和關鍵(分清兩種「生成」)**:
|
||||
- ✅ **操盤 CC 據實生成**:CC 剛建這 workflow、最懂它做什麼 → 寫真描述(leo 例「呼叫可 Upsert Google Sheets」)。**真描述非假裝**,不違 mindset §7。
|
||||
- ❌ **介面層機械塞佔位**(從 name 複製、`workflow_xxx`)=假描述,仍禁。
|
||||
|
||||
**為什麼**:low-code 用戶不知道要填 description(逼填違北極星「不增負擔」);但自動機械填=假裝有(違誠實)。北極星「執行力外包給 AI」=AI 據實幫他寫好、他可改。
|
||||
|
||||
**避坑**:description 是一句「能做什麼」供語意搜尋,**非寫文章**。
|
||||
|
||||
**詳見**:workflow-discovery SDD §3.2。
|
||||
|
||||
---
|
||||
|
||||
## 快速決策樹
|
||||
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user