workspace-init — Claude Code Workspace Personalisation Skill

workspace-init 係一個 Claude Code skill，每次對話開始時自動注入你嘅 workspace 背景、身份、語言偏好同 project context。

目的： 提高 LLM 嘅 cache hit rate、減少重複解釋、令每次對話更個人化。

• ✅ 第一次用 /init 問你嘅名、公司、語言偏好、tone，然後記住
• ✅ 每次對話自動注入 context，唔使再重複講「我用廣東話」、「唔好亂估」
• ✅ 自動 call 其他 skills（ponytail、graphify、yuanyuai-quota 等）
• ✅ 支援多種語言（廣東話、普通話、English、其他）
• ✅ Git 整合 — 自動 detect branch、project language
• ✅ Tone 設定 — casual / formal / technical / friendly / minimal
• ✅ Skill 推薦系統 — 根據 project language 同 branch 推薦相關 skills
• ✅ Profile 匯出/匯入 — backup 或搬去第二部機
• ✅ 多 project 支援 — 唔同 folder 自動 detect 用唔同 profile
• ✅ 所有資料自己控制，唔會洩漏俾其他人

curl -L -o /tmp/hkinit.zip https://github.com/ricehung29/workspace-hkinit-skill/archive/refs/heads/main.zip
unzip /tmp/hkinit.zip -d /tmp/hkinit
cp -r /tmp/hkinit/workspace-hkinit-skill-main/skills/workspace-init ~/.claude/skills/

git clone https://github.com/ricehung29/workspace-hkinit-skill.git /tmp/hkinit
cp -r /tmp/hkinit/skills/workspace-init ~/.claude/skills/

如果你想將 skill 綁定喺某個 project，其他人 clone 就有：

cp -r ~/.claude/skills/workspace-init .claude/skills/
git add .claude/skills/workspace-init
git commit -m "add workspace-init skill"

開一個新對話，然後輸入：

/init

Skill 會問你：

1. 你叫咩名？ — 英文名 / 中文名 / 代號都得
2. 你嘅公司 / 團隊名？ — optional，可以 skip
3. 你個 project 係咩？ — 簡短描述
4. 你想用咩語言交流？ — 廣東話 / 普通話 / English / 其他
5. 你嘅稱呼偏好？ — 例如「師兄」、「大佬」、「你」
6. 你想用咩 tone？ — casual / formal / technical / friendly / minimal

預設會建立 local profile（.claude/project-profile.json，跟 project 走），唔會儲存 global profile。

如果你需要 global profile（跨 project 共用），可以叫 LLM 幫你 save 埋一份去 ~/.config/claude/。Global profile 只儲存基本資料（user_name、company、language、preferred_form、tone），唔會包含 project 資訊。

如果已有 global profile 但未建立 local profile，LLM 會 detect 到並提示你補返 project 名同描述，然後自動建立 local profile。

/init --update
# 或者手動：
curl -sL https://raw.githubusercontent.com/ricehung29/workspace-hkinit-skill/main/skills/workspace-init/scripts/update.sh | bash

每次 /init 會自動 detect：

• Git repo 位置
• 當前 branch
• Project language（自動 detect package.json / Cargo.toml / go.mod 等）
• File count

呢啲資料會注入 LLM context，令回覆更貼近你嘅 project 實際情況。

根據 detect 到嘅 project language 同 branch 自動推薦：

• JavaScript/TypeScript → ponytail, impeccable, dependency-auditor
• Rust → CI/CD, dependency-auditor, ponytail
• Python → RAG architect, database-designer, ponytail
• Go → performance-profiler, CI/CD
• Branch main → 推 changelog-generator
• Branch feat/* → 推 PR review expert
• Branch fix/* → 推 focused-fix

唔同 Git repo 會自動儲存獨立嘅 project profile：

~/.config/claude/workspace-profiles/
  ├── <repo1_hash>.json
  ├── <repo2_hash>.json
  └── ...

當你喺唔同 folder 開對話，會自動 load 對應嘅 project profile。

非 Git project 或者你想 profile 跟 repo 一齊 share，可以用 --save-local（或 --sl）：

/init --save-local /path/to/project '{"project":"My App","project_details":"..."}'
# 或者短版
/init --sl /path/to/project '{"project":"My App","project_details":"..."}'

--save-local 會自動 merge global profile 嘅所有欄位（user_name、company、language、preferred_form、tone、extra_skills 等），所以你只需提供 project 相關嘅 field 就得。

Profile 會 save 喺 project 嘅 .claude/project-profile.json，無論係 Git 定非 Git project 都 work。

載入優先級：

1. .claude/project-profile.json（最高優先，跟 project 走）
2. ~/.config/claude/workspace-profiles/<hash>.json（Git project 專用）
3. 冇 → 用 global profile 嘅預設值

~/.config/claude/workspace-init-profile.json          # 主 profile
~/.config/claude/workspace-profiles/                  # multi-project profiles（舊方式）
.claude/project-profile.json                          # local project profile（新方式，跟 project 走）

權限：chmod 600（僅 owner 可讀寫），唔會俾 git 追蹤。

• Claude Code（已安裝）
• jq — JSON 處理（profile merge、context build、export/import）
  • macOS: brew install jq
  • Linux: apt install jq / yum install jq
  • Windows (Git Bash): curl -sL -o ~/bin/jq https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-windows-amd64.exe
• git — Git 整合 detect（已安裝）
• 其他 skills（optional）：ponytail、graphify、yuanyuai-quota 等，冇嘅話就 skip

rm -rf ~/.claude/skills/workspace-init
rm -f ~/.config/claude/workspace-init-profile.json
rm -rf ~/.config/claude/workspace-profiles

MIT

• Profile priority: .claude/project-profile.json > workspace-profiles/<hash>.json > global (原本: 永遠 global first)
• Default save: 預設建立 local profile，global 只係 optional backup（原本: 預設 global）
• --save 改咗 priority: 跟 local → workspace-profiles → global（原本: 固定 global）
• --ctx 改咗 loading: 先 check local → fallback global（原本: 先 global）
• --check: 改為 check local profile（原本: check global）
• JSON escaping: 全部用 jq -n --arg build JSON，唔再 raw string interpolation
• JSON format: 全部 output formatted multi-line（原本部分 one line）
• Global profile: 只儲 basic info（user_name, company, language, preferred_form, tone），skip project 資訊
• use_global status: --ctx detect 冇 local 但有 global 時 output status: "use_global"，提示建立 local
• Variable names: 單字母改為 readable 全名
• 顏色變數: 刪除（未用過）
• Cache: 完全移除 CACHE_FILE / CACHE_TTL / get_cache / set_cache
• Duplicate line: 刪除重複嘅 PROFILE= assignment