setup

此設定技能專為加入 Chops 程式碼庫的開發人員設計，Chops 是一款為管理 AI 代理技能與配置而打造的原生 macOS 應用程式。此技能可自動化環境驗證流程，確保系統符合嚴格要求，例如執行 macOS 15+，並安裝了必要的工具（如 Homebrew、Xcode 命令列工具與 xcodegen）。本技能為建立本地建置環境、管理 Xcode 專案生命週期以及理解應用程式核心架構元件提供了結構化的路徑。

• 自動檢查 macOS 環境合規性、Xcode CLI 可用性以及必要的 Homebrew 套件。

• 使用 xcodegen 協調 Chops.xcodeproj 檔案的生成，確保 project.yml 作為 Xcode 設定的唯一真實來源。

• 提供清晰的應用程式架構概述，包含 SwiftData 模型層、AppState 單例模式，以及如 SkillScanner、FileWatcher 與 SkillParser 等服務層。

• 解釋基於符號連結（symlink）的去重機制，用於管理 Claude Code、Cursor、Windsurf、Codex 與 Amp 等多個平台的技能。

• 詳細說明應用程式的沙盒架構，特別強調為了監控與修改使用者主目錄中的點檔案（dotfiles）所必要的無沙盒限制設計。

• 概述標準開發流程，包含手動測試策略，因為該專案不依賴傳統的自動化測試套件。

• 使用者應確保擁有適當的檔案系統存取權限，因為應用程式需要對隱藏配置目錄進行無限制的讀寫存取。

• 建置流程完全依賴 xcodegen；手動修改生成的 .xcodeproj 檔案將會被覆蓋。

• 開發人員應將 project.yml 的變更視為調整建置設定、方案或依賴項的主要方式。

• 由於應用程式使用 SwiftUI 與 SwiftData 編寫，貢獻者應熟悉 @Observable 狀態模式與現代原生 macOS 開發實踐。

• 所有貢獻均透過手動建置與執行進行驗證，因為專案強調觀察與直接驗證，而非單元測試。