Workspace 管理

概述

ekkorn-doc 的 workspace/ 目錄是全域 AI 規範與共用設定的 Single Source of Truth。透過 deploy-config.sh 部署至開發者的本地工作目錄，確保所有人使用一致的規範。

部署對照表

Source（git 管理）	Target（部署結果）
workspace/CLAUDE.md	$EKKORN_WORK_DIR/CLAUDE.md
workspace/GEMINI.md	~/.gemini/GEMINI.md
workspace/docs/	$EKKORN_WORK_DIR/docs/（rsync --delete）
workspace/.claude/commands/	$EKKORN_WORK_DIR/.claude/commands/（rsync --delete）

--delete 行為說明

deploy-config.sh 對 docs/ 和 .claude/commands/ 使用 rsync --delete，意味著不在 workspace/ 中的檔案會被清除。這是刻意行為：

• $EKKORN_WORK_DIR/docs/ 由本腳本全權管理
• 個人 Skills 應放 ~/.claude/commands/，不受影響
• 個人工作區 $EKKORN_WORK_DIR/.agent/ 不受影響

deploy-config.sh

將 workspace/ 部署到本地工作目錄。EKKORN_WORK_DIR 環境變數可指定目標目錄，預設為 ekkorn-doc 上層目錄。

# 預設部署
bash scripts/deploy-config.sh

# 指定目標目錄
EKKORN_WORK_DIR=/path/to/work bash scripts/deploy-config.sh

git-fetch-all.sh

依據 repos.yml 清單，對工作目錄下所有已 clone 的 repo 執行 git fetch --prune。未 clone 的 repo 會印出警告並略過。

bash scripts/git-fetch-all.sh

常見工作流程

詳細流程與步驟見 workspace/docs/workspace-sync.md。摘要：

• 修改設定：編輯 workspace/ → PR → 合併 → deploy-config.sh
• 拉取最新：git pull ekkorn-doc → deploy-config.sh
• 日常開始：git-fetch-all.sh → 檢查 ekkorn-doc 更新 → 若有則 pull + deploy

AI Agent 注意事項

• 禁止直接修改 $EKKORN_WORK_DIR/CLAUDE.md、$EKKORN_WORK_DIR/docs/、$EKKORN_WORK_DIR/.claude/commands/
• 需修改上述檔案時，必須修改 ekkorn-doc/workspace/ 下的對應檔案
• .agent/ 為本地工作區，可正常讀寫