القائمة
安裝並初始化本 repo 的 harness 制度庫（symlink、個人環境配置 env.md、健康檢查、導覽）。使用者 clone 本 repo 後說「安裝」「初始化」「setup」「裝起來」，或第一次在本 repo 目錄開 session 時使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | harness-install |
| description | 安裝並初始化本 repo 的 harness 制度庫（symlink、個人環境配置 env.md、健康檢查、導覽）。使用者 clone 本 repo 後說「安裝」「初始化」「setup」「裝起來」，或第一次在本 repo 目錄開 session 時使用。 |
目標：讓 clone 本 repo 的人一次完成安裝＋個人配置＋驗證，並知道怎麼開始用。 全程使用台灣用語的繁體中文。
自動掃描發現可用的 AI 代理 CLI 工具（copilot、opencode、codex、antigravity、gemini、hermes、claude 等），列出已安裝和未安裝的狀態：
════════════════════════════════════════════
可用的 CLI / IDE 工具
════════════════════════════════════════════
✓ 已安裝：
1. claude → /home/yao/.local/bin/claude
2. codex → /home/yao/.nvm/versions/node/v22.20.0/bin/codex
3. copilot → /home/yao/.nvm/versions/node/v22.20.0/bin/copilot
4. gemini → /home/yao/.nvm/versions/node/v22.20.0/bin/gemini
5. hermes → /home/yao/.local/bin/hermes
6. opencode → /home/yao/.nvm/versions/node/v22.20.0/bin/opencode
選擇要 symlink 的工具：
a = 全部已安裝
1,2,3,... = 選擇特定工具編號
(直接按 Enter 略過此步驟)
規則：
python3 claude/install.py
腳本是冪等的，會自動：
~/.claude/CLAUDE.md~/.claude/cli/ 建立 CLI 工具的 symlink~/.claude/env.md 不存在時從 claude/env.example.md 複製範本若腳本失敗，把錯誤原文貼給使用者，不要腦補修法；
symlink 不可用的環境（少見）改走 claude/README.md 的手動步驟。
讀 ~/.claude/env.md。若仍是範本佔位符（含 <GITLAB_HOST> 等字樣），逐項詢問使用者：
| 問題 | 對應欄位 | 可略過 |
|---|---|---|
| 有自架 GitLab 或其他內網 git 主機嗎？位址是？ | <GITLAB_HOST> | ✅ |
| 用什麼 CLI 操作 ticket？使用說明在哪？ | <TICKET_CLI>、<TICKET_CLI_DOC_URL> | ✅ |
| 有工作專案對應表（CSV 等）嗎？路徑是？ | <PROJECT_MAPPING_CSV_PATH> | ✅ |
| 有本機知識庫（LLM wiki）嗎？路徑是？ | <WIKI_ROOT> | ✅ |
| 本機有什麼要提醒未來 session 的注意事項？ | 本機注意事項 | ✅ |
規則：
~/.claude/env.md。這個檔不在版控內，內網／公司資訊只能寫在這裡。python3 claude/check_harness.py
~/.claude/CLAUDE.md 的框架（如 OMC），
行數警告可能持續存在，如實回報並讓使用者決定，不要自行刪除框架內容。用簡短篇幅告訴使用者：
~/.claude/CLAUDE.md（symlink 到本 repo），每個 session 自動載入。~/.claude/env.md，不可寫進 repo（公開的）。claude/maintenance-protocol.md。python3 claude/check-harness.py。