Chops 开发环境配置技能
让 AI 代理快速帮新开发者完成 Chops macOS 应用的环境搭建、构建与代码库入门。
项目自身的开发环境搭建指南（macOS 前置条件检查、Xcode 项目生成），服务于该项目新贡献者。
这个 Skill 能做什么，适合哪些场景？
这是 Chops 仓库（一个管理 AI 编码代理技能的 macOS 应用）自带的 setup 技能，位于 .claude/skills/setup/。它指导 AI 代理完成四步流程：检查前提条件、用 xcodegen 生成 Xcode 工程、构建运行应用，以及讲解代码库架构。它本质是一份面向代理的结构化上手文档，适合想为 Chops 本身贡献代码的开发者。注意它不是通用入门技能——所有前提条件和构建命令都绑定于 macOS 15+ 与 Xcode 工具链。
技能会指导代理：1) 逐项验证前提条件（通过 sw_vers、xcode-select -p、which brew、which xcodegen 等命令），缺项时告知用户并停止；2) 运行 xcodegen generate 从 project.yml 生成 Chops.xcodeproj，并强调不可直接编辑 .xcodeproj；3) 通过 xcodebuild -scheme Chops -configuration Debug build 构建，或打开 Xcode 按 Cmd+R 运行；4) 输出架构导览，包括入口文件 ChopsApp.swift、AppState 状态管理、SwiftData 模型（Skill、Collection、ToolSource）、服务层（SkillScanner、FileWatcher、SkillParser、SearchService）以及三栏 NavigationSplitView 界面结构，并列出五个工具（Claude Code、Cursor、Windsurf、Codex、Amp）的扫描路径。
- 为 Chops 贡献代码的开发者，第一次克隆仓库后需要搭建本地构建环境
- 使用 Claude Code 等代理的工程师，希望代理自动检查并修复缺失的开发前提条件（如 xcodegen 未安装）
- 接手维护 Chops 的工程师，需要快速理解 SwiftData 模型、服务层和视图结构再动手改代码
- 想在 Chops 中新增一个受支持编码工具（往 ToolSource 枚举加 case）的开发者，需要了解扩展入口
- 团队新成员入职，借助代理按步骤完成从克隆到运行的全流程
这个 Skill 有哪些优点和局限？
- 上手步骤完整且可执行：前提检查、工程生成、构建命令全部给出确切命令
- 架构导览详细到文件级，代理能据此准确定位代码（模型、服务、视图各自路径明确）
- 明确了关键设计约束（project.yml 为唯一事实来源、无沙箱、无测试套件），避免代理做出错误操作
- 附带常见开发任务指引（新增工具、修改解析、改 UI），降低贡献门槛
- 仅适用于 Chops 这一个项目，且硬性要求 macOS 15+ 与 Xcode 工具链，无法在其他环境使用
- 项目本身没有自动化测试套件，改动只能靠手动验证
- 前提检查失败时代理会直接停止，需要用户手动补齐依赖
- 仓库许可证标记为 NOASSERTION，README 中为 FSL-1.1-MIT，采用前需自行确认许可条款
如何安装这个 Skill？
该技能随 Chops 仓库分发。克隆仓库后技能位于 .claude/skills/setup/SKILL.md，Claude Code 会自动识别。其他兼容 Agent Skills 标准的工具可手动把 setup 文件夹复制到各自的技能目录（如 ~/.claude/skills/ 或 ~/.codex 等对应路径）。克隆命令：git clone https://github.com/Shpigford/chops.git。仓库许可证为 FSL-1.1-MIT。
如何使用这个 Skill？
在已克隆的 Chops 仓库内，向 Claude Code（或其他支持的代理）提出如"帮我搭建这个项目的开发环境"的请求，代理会按技能逐步执行：先检查 macOS 15+、Xcode CLI 工具、Homebrew 和 xcodegen 是否就绪（缺失时会提示安装并停止），再运行 xcodegen generate 生成工程，然后构建运行。若修改了 project.yml，需重新运行 xcodegen generate。注意该技能没有自动测试——仓库明确说明无测试套件，改动需手动构建运行验证。