القائمة
Branch Worktree Guardian - Git 分支和 Worktree 管理工具。Use for: (1) 新開發需求時建立隔離分支, (2) 使用 worktree 機制避免分支衝突, (3) 驗證當前工作分支正確性, (4) 預防在錯誤分支上開發
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
broken-link 偵測工具。掃描 .claude/ 目錄所有 Markdown 文件中的路徑引用，偵測失效連結。Use for: (1) 一次性掃描所有 broken links, (2) 搭配 /loop 定期監控, (3) 修改規則/方法論/代理人文件後驗證路徑完整性。Use when: user runs /broken-link-check, 或搭配 /loop 定期執行, 或發現 broken link 錯誤後。
Dart/Flutter copyWith 收窄判準與 entity 不變式設計。Use when designing or reviewing copyWith, entity classes, value objects, freezed models, domain invariants, or state transition methods (markAsX/completeY).
全量掃描硬編碼中文字串並生成 i18n 修正建議。檢測所有層（Model/Service/Domain/UI）中文硬編碼，生成 ARB 鍵值建議，支援批量替換工作流程。Use for: (1) 檢查專案全部硬編碼中文（不只 UI 層）, (2) 進行大規模 i18n 修復, (3) 生成 ARB 鍵值建議, (4) i18n 技術債務評估
Riverpod Provider 架構設計規範 - 確保正確的依賴注入、介面隔離和測試可行性。Use for: (1) 設計新的 ViewModel/Notifier 類別, (2) 審查 Provider 依賴注入是否正確, (3) 測試中配置 ProviderScope.overrides, (4) 發現 ref.read/watch 使用錯誤時。Use when: 程式碼涉及 Riverpod Provider、Notifier、ViewModel 設計或出現 ref 操作問題時。
Performs security review for Flutter/Dart code. Use when implementing authentication, handling user input, working with API keys or secrets, managing permissions, storing sensitive data locally, or integrating third-party APIs. Provides Flutter-specific security checklists and patterns.
Style Guardian - Unified Design System Enforcement Tool. Use for: (1) Preventing hardcoded styles (colors, spacing, typography), (2) Preventing hardcoded text (i18n violations), (3) Guiding unified configuration usage, (4) Detecting and fixing style violations
| name | branch-worktree-guardian |
| description | Branch Worktree Guardian - Git 分支和 Worktree 管理工具。Use for: (1) 新開發需求時建立隔離分支, (2) 使用 worktree 機制避免分支衝突, (3) 驗證當前工作分支正確性, (4) 預防在錯誤分支上開發 |
Git 分支和 Worktree 管理工具，用於預防在錯誤分支上開發的問題。
在多 AI Agent 同時開發或複雜的分支管理場景中，容易發生以下問題：
# 標準流程
1. 確認 main 分支為最新
2. 創建 feature 分支
3. 創建 worktree 到獨立目錄
4. 切換到 worktree 目錄開發
保護分支列表：
mainmasterdeveloprelease/*在這些分支上嘗試編輯時，Hook 會詢問是否繼續或建立新分支。
格式：{project-name}-{branch-short-name}
範例：
book_overview_app-5w1h-skillbook_overview_app-branch-worktreebook_overview_app-ui-unification# 1. 確保 main 是最新的
git checkout main
git pull origin main
# 2. 創建 feature 分支
git checkout -b feat/your-feature-name
# 3. 創建 worktree（在專案同級目錄）
git worktree add ../project-name-feature-name feat/your-feature-name
# 4. 切換到 worktree 目錄
cd ../project-name-feature-name
# 5. 確認分支正確
git branch --show-current
git worktree list
# 移除 worktree（保留分支）
git worktree remove /path/to/worktree
# 移除 worktree 並刪除分支（謹慎使用）
git worktree remove /path/to/worktree
git branch -d branch-name
# 使用 SKILL 腳本
python .claude/skills/branch-worktree-guardian/scripts/verify_branch.py
# 手動檢查
git branch --show-current
git worktree list | grep $(pwd)
創建新的 feature 分支和對應的 worktree。
# 基本用法
python .claude/skills/branch-worktree-guardian/scripts/create_feature_worktree.py \
--branch feat/new-feature \
--worktree ../project-new-feature
# 從特定基礎分支創建
python .claude/skills/branch-worktree-guardian/scripts/create_feature_worktree.py \
--branch feat/new-feature \
--worktree ../project-new-feature \
--base develop
驗證當前分支是否適合編輯。
# 檢查當前目錄
python .claude/skills/branch-worktree-guardian/scripts/verify_branch.py
# 檢查指定目錄
python .claude/skills/branch-worktree-guardian/scripts/verify_branch.py --path /path/to/project
在 Edit 或 Write 工具執行前自動檢查：
Session 啟動時提醒：
常見的分支管理和 worktree 操作場景包括：
詳見：常見情境處理 (common-scenarios.md)
Hook 整合和分支保護規則的配置說明：
Last Updated: 2026-03-18 Version: 1.0.0
重要：本 skill 透過
uv tool install安裝為獨立 CLI，source（本目錄）與 installed（~/.local/share/uv/tools/<package>/）是兩份獨立 Python package。修改 source 後若未 reinstall，CLI 仍使用 stale installed 版本，新增的函式會 AttributeError 或被 hasattr 包裝靜默吞掉（W11-037 根因）。
修復指令：
cd .claude/skills/<本 skill 目錄> && uv tool install . --force --reinstall
自動偵測：每次 SessionStart 由 uv-tool-staleness-check-hook 比對 source vs installed SHA256，偵測 stale 時提示修復指令。對應 ticket-skill 本身另有 ticket-reinstall-hook 自動 reinstall。