hj110b13-Andy/claude-dev-system

把 Stock-web 專案系統優化中「成熟且驗證過」的通用流程，封裝成可跨專案、跨裝置安裝的 Claude Code 全域工具。
版本見 config/VERSION（目前 0.9.5），相容範圍見 config/compat.json，變更見 CHANGELOG.md。
## 內容與分層
| 目錄 | 內容 | 安裝到（ ＝~/.claude） |
| rules/ | 通用規則（分層說明見 rules/README.md）；core.md 是唯一會進 CLAUDE.md 的部分 | claude-dev-system/rules/；core.md 另合併進 CLAUDE.md 標記區塊 |
| skills/ | cds-agent-dispatch、cds-safe-refactor、cds-doc-governance、cds-feedback-audit、cds-blast-radius、cds-verify-app、cds-session-pickup（皆有 frontmatter） | skills/ /（Claude Code 原生個人 skill 位置） |
| hooks/usageguard.py | 用量守門 hook（通用版；門檻讀設定檔） | claude-dev-system/hooks/，並在 settings.json 註冊 UserPromptSubmit／PostToolUse |
| tools/ | depgraph.py（依賴圖／循環閘門）、moduleInventory.py（模組盤點）、progress-diff.py（文件瘦身逐句比對）、video.py（影片：搜尋、逐字稿、截圖、數據、Gemini 問答；選用，需 --with-video）；不寫死路徑，全用參數 | claude-dev-system/tools/ |
| config/ | VERSION、compat.json、dispatch-config.json（用量門檻、方案期間、模型表；專案 .claude/dispatch-config.json 優先於全域）、web-sources.json（聯網來源：免金鑰搜尋 MCP 與 WebSearch 上限 env，選用）、video.json（影片來源：要 pip 的套件與 video.py 預設值，選用） | claude-dev-system/config/（dispatch-config 可自行修改，更新時保留；本機金鑰與開關在 local.json，不進 repo） |
| installer/ | install.py＋cds/ 模組（只用 Python 標準庫） | — |
| tests/ | 安裝器與工具的自我測試 | — |
| docs/ | 安裝、更新、解除安裝、跨裝置、故障排除、相容版本 | — |
全域只放通用能力；業務規則、資料模型、專案命令留在各專案 CLAUDE.md（規格 10.1）。專案規則與全域規則衝突時以專案為準。
本工具不宣稱靠 CLAUDE.md 就能控制所有行為：CLAUDE.md 區塊只是載入給模型的指引；真正自動執行的只有 hook（用量守門）。
## 必要條件
Python ≥ 3.10（安裝器、hook、工具都只用標準庫；選用的影片來源例外，--with-video 會 pip 裝 yt-dlp 等）
git（從版本庫取得本工具）
Claude Code ≥ 2.1.0、 ；②複製規則／工具／hook／設定到 ~/.claude/claude-dev-system/、skills 到 ~/.claude/skills/cds-；③在 settings.json 只新增指令結尾帶 # claude-dev-system 的 hook（若已有你自己的 usageguard.py hook 就不重複註冊、不寫檔）；④在 CLAUDE.md 末端加 ～ 區塊，區塊外一字不動；⑤安裝紀錄（版本、每個檔的雜湊、加了哪些條目）寫在 ~/.claude/claude-dev-system/manifest.json。
不碰 permissions、model、language、statusLine、enabledPlugins、其他 hooks 與 ~/.claude/commands/。不會把任何金鑰或 .credentials.json 打包進工具。
細節：docs/install.md。
## 設定視窗（不用打指令）
bash
python installer/install.py gui # Windows：py -3 installer/install.py gui
所有選用項目、金鑰（框內顯示目前值、可測試、可填「哪個帳號申請的」備註）、用量守門開關與門檻、目前用量（5 小時／7 天 %）、背景任務巡檢（每 N 分鐘）、WebSearch 上限、下載資料夾、Claude in Chrome 都在視窗裡改；底下會列「將變更 N 項」，按「套用」才動，按「取消」回到實際狀態。開啟與套用後都重讀真實檔案，畫面不會和實際不一樣。缺 ffmpeg／PowerShell 7／faster-whisper 有安裝按鈕。打包成 exe 與視窗內更新在下一版。
## 執行檔（不用裝 Python 也能開設定視窗；Windows）
從 Releases 下載 claude-dev-system-settings.exe，直接開。第一次 Windows SmartScreen 會擋（沒有程式碼簽章）：按「其他資訊」→「仍要執行」。
exe 內含一份規則／工具／skill 快照；頂端「檢查更新」會比對 GitHub 的版本，有新版就下載到 ~/.claude/claude-dev-system/app/，之後按「套用」寫進 Claude Code，不用換 exe。只有安裝器程式碼本身有變（視窗功能）才需要到 Releases 抓新 exe，視窗會提示。
hook 與影片工具仍需要系統有 Python ≥3.10（exe 內建的 Python 不能代替）；環境區會顯示找到的是哪個 Python，沒有就有「開下載頁」按鈕。
自己打包：py -3 -m pip install pyinstaller && py -3 installer/buildexe.py，產物在 dist/。推 v 標籤時 GitHub Actions 會自動打包並附在 Release。
## 自我測試（確認 Claude Code 真的會自己用這些工具）
bash
python installer/install.py selftest --list # 列九題
python installer/install.py selftest # 全跑（約 20～40 分鐘、九場短對話的用量；Chrome 題要瀏覽器開著）
python installer/install.py selftest --only video --only live-data
每題在全新無頭 claude -p 對話裡只給問題、不提工具名，讀它實際呼叫的工具與 config/selftest.json 的預期比對（例如停車場題要先打 TDX 再跨索引、即時數值題不得用 firecrawl 抓頁、影片動作題要走 Gemini ask）。改了規則就跑一次；視窗核心區也有同一顆按鈕。
## 選用：聯網來源
bash
python installer/install.py update --with-web # 放寬內建 WebSearch 上限＋UTF-8 env＋註冊免金鑰 MCP（搜尋 parallel、exa；文件 context7、deepwiki、mslearn）