Shpigford/chops

Your AI agent skills, finally organized. A macOS app to browse, edit, and manage skills across Claude Code, Cursor, Codex, Windsurf, and Amp.

agentsaimacosskillsswiftui

GAI 中文摘要

Chops 是一款专为 macOS 设计的生产力工具，旨在帮助开发者统一管理和维护各种 AI 编程助手（如 Claude Code、Cursor、Windsurf 等）的技能与代理配置。通过提供图形化的集中式界面，它解决了以往需手动深入 dotfiles 文件寻找及编辑代码片段的繁琐问题。

支持 Claude Code、Cursor、Windsurf 及 Aider 等多种主流 AI 开发工具的技能聚合管理。

提供内置代码编辑器，支持实时预览、编辑及基于 Frontmatter 的配置解析。

具备自动化的文件系统监听功能，能够通过 FSEvents 实时检测并同步磁盘上的技能更新。

支持自定义创建技能与代理，并提供模板化的样板代码生成功能。

支持通过远程服务器发现、浏览并安装社区提供的第三方技能。

该应用非常适合深度使用 AI 辅助编程工具、频繁切换不同开发环境或需要管理大量自定义指令集的软件工程师，是优化 AI 编码工作流的理想管理助手。

⭐

990

Stars

🔱

Forks

👁

Watchers

📋

Issues

SwiftMIT创建于 2026/3/18更新于今天

在 GitHub 上查看访问主页

README

由 Gemini 翻译整理

Chops

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

下载 · 网站 · @Shpigford

这是一款 macOS 应用程序，用于发现、组织和编辑 Claude Code、Cursor、Codex、Windsurf 和 Amp 等工具中的编程 Agent 技能与 Agent。从此告别在各种配置文件（dotfiles）中翻找的日子。

功能特性

多工具支持 — 支持 Claude Code、Cursor、Codex、Windsurf、Copilot、Aider 和 Amp
技能与 Agent 管理 — 从各工具的目录中自动发现技能和 Agent
内置编辑器 — 支持等宽字体编辑器，具备 Cmd+S 保存功能及 Frontmatter 解析功能
合集功能 — 在不修改源文件的情况下对技能和 Agent 进行归类管理
实时文件监控 — 基于 FSEvents，磁盘变动时实时更新
全文搜索 — 支持按名称、描述和内容进行搜索
创建新技能与 Agent — 为每个工具生成正确的模板文件
远程服务器 — 连接到 OpenClaw 等服务器，以发现、浏览和安装技能

前置要求

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 — 已发现的技能或 Agent 文件
│   ├── 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/               # 工具筛选、技能/Agent 列表、合集
│   ├── Detail/                # 技能编辑器、元数据展示
│   ├── Settings/              # 偏好设置及更新 UI
│   └── Shared/                # 可重用组件 (ToolBadge, NewSkillSheet)
├── Resources/                 # 资源目录 (工具图标、配色)
└── Chops.entitlements         # 禁用沙盒 (刻意为之)

project.yml          # xcodegen 配置 — Xcode 项目设置的唯一来源
scripts/             # 发布流程脚本 (release.sh)
site/                # 营销网站 (Astro 6)

架构说明

SwiftUI + SwiftData，纯原生 macOS 应用，无任何 WebView。

应用生命周期

ChopsApp 初始化 SwiftData ModelContainer（持久化存储 Skill 和 SkillCollection）。
后台启动 Sparkle 更新程序。
创建 AppState 并注入 SwiftUI 环境。
ContentView 开始渲染并调用 startScanning()。
SkillScanner 探测所有工具目录并将发现的技能写入数据库。
FileWatcher 添加 FSEvents 监听器 — 任何文件变动都会触发扫描器重新运行。

关键设计决策

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

状态管理

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

UI 布局

采用三栏式 NavigationSplitView：

侧边栏 (Sidebar) — 工具筛选和合集
列表 (List) — 过滤/搜索后的技能列表
详情 (Detail) — 技能编辑器（封装 NSTextView 以实现原生文本编辑）