Chops

你的 AI 技能与智能体，终于井井有条了。

下载 · 网站 · @Shpigford

一款 macOS 原生应用，用于发现、组织和编辑 Claude Code、Cursor、Codex、Windsurf 和 Amp 等工具中的编码智能体技能与代理。无需再在繁琐的配置文件（dotfiles）中翻找。

功能特性

• 多工具支持 — 支持 Claude Code, Cursor, Codex, Windsurf, Copilot, Aider, Amp
• 技能 + 智能体 — 自动发现各工具目录下的技能（Skills）与智能体（Agents）
• 内置编辑器 — 支持等宽字体编辑、Cmd+S 保存以及 Frontmatter 解析
• 收藏集 — 无需修改源文件即可对技能和智能体进行归类
• 实时文件监控 — 基于 FSEvents，磁盘变更即刻同步
• 全文搜索 — 支持按名称、描述和内容进行全局搜索
• 创建新技能与智能体 — 为各工具自动生成标准的样板代码
• 远程服务器 — 连接至运行 OpenClaw、Hermes 或其他布局的服务器，以发现、浏览和安装技能

前置要求

• macOS 15 (Sequoia) 或更高版本
• Xcode 及命令行工具 (xcode-select --install)
• Homebrew (brew.sh)
• xcodegen — brew install xcodegen

Sparkle（自动更新框架）是唯一的外部依赖，由 Xcode 通过 Swift Package Manager 自动拉取，无需手动配置。

快速上手

git clone https://github.com/Shpigford/chops.git
cd chops
brew install xcodegen    # 如已安装可跳过
xcodegen generate        # 从 project.yml 生成 Chops.xcodeproj
open Chops.xcodeproj     # 在 Xcode 中打开

然后按下 Cmd+R 进行构建并运行。

注意： Xcode 项目由 project.yml 生成。如果你修改了 project.yml，请重新运行 xcodegen generate。请勿直接编辑 .xcodeproj 文件。

CLI 构建（无需 Xcode GUI）

xcodebuild -scheme Chops -configuration Debug build

项目结构

Chops/
├── App/
│   ├── ChopsApp.swift        # @main 入口 — SwiftData ModelContainer + Sparkle
│   ├── AppState.swift         # @Observable 单例 — 管理过滤、选择、搜索状态
│   └── ContentView.swift      # 三列布局 NavigationSplitView，启动扫描任务
├── Models/
│   ├── Skill.swift            # @Model — 发现的技能或智能体文件模型
│   ├── Collection.swift       # @Model — 用户创建的技能分组
│   └── ToolSource.swift       # 枚举类型，定义支持的工具及其路径和图标
├── Services/
│   ├── SkillScanner.swift     # 探测工具目录，将技能写入 SwiftData
│   ├── SkillParser.swift      # 分发至 FrontmatterParser 或 MDCParser
│   ├── FileWatcher.swift      # FSEvents 监听器，检测到变更时触发重扫描
│   └── SearchService.swift    # 内存全文搜索服务
├── Utilities/
│   ├── FrontmatterParser.swift  # 从 .md 文件中提取 YAML frontmatter
│   └── MDCParser.swift          # 解析 Cursor 的 .mdc 文件
├── Views/
│   ├── Sidebar/               # 工具过滤、技能/智能体列表、收藏集
│   ├── Detail/                # 技能编辑器、元数据展示
│   ├── Settings/              # 偏好设置与更新 UI
│   └── Shared/                # 可复用组件 (ToolBadge, NewSkillSheet)
├── Resources/                 # 资源目录 (工具图标、颜色)
└── Chops.entitlements         # 禁用沙盒配置 (有意为之)

project.yml          # xcodegen 配置 — Xcode 项目设置的事实来源
scripts/             # 发布流水线 (release.sh)
site/                # 营销网站 (Astro 6)

架构设计

SwiftUI + SwiftData，纯原生 macOS 应用，无任何 Web 视图。

应用生命周期

1. ChopsApp 初始化 SwiftData ModelContainer（持久化存储 Skill 和 SkillCollection）
2. 在后台启动 Sparkle 更新程序
3. 创建 AppState 并注入 SwiftUI 环境
4. ContentView 渲染并调用 startScanning()
5. SkillScanner 探测所有工具目录并更新发现的技能
6. FileWatcher 挂载 FSEvents 监听器 —— 一旦发生任何变动，扫描器会自动重新运行

关键设计决策

• 无沙盒模式。 应用需要不受限制的文件系统访问权限，以读取 ~/ 下的各个配置文件。这是核心功能所必需的，因此在 entitlements 文件中显式禁用了应用沙盒。
• 通过符号链接去重。 技能通过其解析后的符号链接路径进行唯一识别。如果同一个文件被链接到多个工具目录中，它将显示为一个带有多个工具徽标的单一技能。
• 无测试套件。 采用手动验证 —— 构建、运行、触发修改的功能并观察结果。

状态管理

AppState 是一个 @Observable 类，用于持有所有 UI 状态：选中的工具过滤器、选中的技能、搜索文本、侧边栏过滤模式。它通过 @Environment 注入，可在任何视图中访问。

UI 布局

采用三列式 NavigationSplitView：

• 侧边栏 (Sidebar) — 工具过滤器和收藏集
• 列表 (List) — 过滤/搜索后的技能列表