Files

T

Leo 39783cccc8 feat: 接關 hook + SDD 強制 hook（實作 wishlist 兩項）

§1 接關機制（雙保險）：
- session-start-recall.sh：SessionStart 自動注入 status 重點 + 快照核實提醒
- /wiki-recall：fallback 命令，hook 失效時手動接關

§2 軟規範 → 硬攔截：
- sdd-guard.sh：動 code 檔但無 SDD → exit 2 擋（/sdd-check 自動版）
- pre-write-guard.sh：專案自訂禁令骨架（預設停用）
- settings.json：掛 SessionStart + PreToolUse

配套：install.sh 下載 hooks/settings（settings 比照 CLAUDE.md 不覆蓋）；
README/CLAUDE.md 補文件 + 誠實限制聲明。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-15 16:04:58 +08:00

1.8 KiB

Raw Blame History

CLAUDE.md — [專案名稱]

導航牌。細節在兩個地方，不在這裡。這個檔案不增長——超過 100 行就是放錯地方了。

絕對鐵律（違反 = 停手）

任何 code 變動前必須有對應 SDD（docs/3-specs/[子系統]/design.md）
[技術棧限制，例如：前端只用 React，不引入其他框架]
[其他專案特定限制]

找不到對應 SDD → 停手問 [負責人]，不要自行建立。

工作流程（強制）

開始任一任務，按順序：

讀 .claude/wiki/status.md（3 分鐘，了解當前狀態）
確認有對應 SDD（docs/3-specs/）

在回覆開頭宣告：

📋 已讀 SDD：<路徑>
🎯 對應 task：<編號>
🚧 執行範圍：<會動哪些檔案>

完成後更新 .claude/wiki/status.md

Wiki 讀取順序

檔案	時機	用途
`.claude/wiki/status.md`	session 開始第一件事	當前進度、下一步
`.claude/wiki/mistakes.md`	做新功能前	已知誤解 + 快速檢查清單
`.claude/wiki/decisions-summary.md`	遇到設計判斷時	架構決策快速查

開 session 由 SessionStart hook 自動注入 status 重點。沒自動接關 → 打 /wiki-recall。 status/wiki 是 快照非即時狀態：讀快照 + 核實快照，不盲信。

規範索引

檔案	內容
`docs/README.md`	文件分類規則
`docs/3-specs/`	所有 SDD
`docs/2-architecture/decisions/`	架構決策記錄

文件位置速查

類別	位置
架構決策	`docs/2-architecture/decisions/`
SDD	`docs/3-specs/[子系統]/`
操作手冊	`docs/4-guides/`
事件記錄	`docs/5-records/incidents/`
測試報告	`docs/5-records/test-reports/`

1.8 KiB Raw Blame History Unescape Escape

CLAUDE.md — [專案名稱]

絕對鐵律（違反 = 停手）

工作流程（強制）

Wiki 讀取順序

規範索引

文件位置速查

1.8 KiB

Raw Blame History