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 开发实践。

• 所有贡献均通过手动构建与执行进行验证，因为项目强调观察与直接验证，而非单元测试。