一套插件库复用到多种 AI 编程助手
wshobson/agents 为 Claude Code、Codex、Cursor 等工具提供共享的插件、Agent、技能与命令,覆盖开发、审查、测试和基础设施任务。目录包含 94 个插件,各工具可用组件和安装方式有所差异。
完整中文译文
在 Claude Code、OpenAI Codex CLI、Cursor、OpenCode、Antigravity CLI、GitHub Copilot 和 Pi 中,使用同一套 plugin、Agent、skill 和命令。harness 指负责加载和运行这些组件的编程工具。plugin 涵盖 Python 和 JavaScript 开发、代码审查、测试、基础设施、安全等工作。
目录中共有 94 个 plugin,包括 92 个本地 plugin 和 2 个外部条目。本地源码包含 202 个 Agent、185 个 skill 和 105 个命令。这些组件共用一套 Markdown 源文件,并针对各个 harness 适配安装方式和能力。
多 harness 支持
选择你使用的 harness,并按照对应的流程进行配置。可用组件取决于安装方式和 harness 的能力。
模型映射、工具权限、hook 和安装方式的差异,请参阅能力矩阵。
如果只需要单个 skill,可以使用仅安装 skill 的安装器,并选择你的编程工具。
根据你的工作选择 plugin:
全部 94 个 plugin 请参阅 plugin 目录,命令和示例请参阅使用指南。
在 Claude Code 内运行以下命令,注册 marketplace 并安装 Python 开发 plugin:
/plugin marketplace add wshobson/agents
/plugin install python-development@claude-code-workflows
然后让 Claude 使用 Python Agent 完成你的任务,或者运行该 plugin 的项目脚手架命令:
/python-development:python-scaffold Create a FastAPI service with tests
使用当前版本的 Codex CLI,在终端中运行以下命令:
codex plugin marketplace add wshobson/agents
codex plugin add python-development@claude-code-workflows
Codex 原生 manifest 提供对源码中 skill 的访问。生成的 TOML Agent 和由命令转换而来的 skill 则使用单独的适配器路径。原生安装也会读取原始 skill 正文,而生成的副本会将过长的正文拆分到参考文件中,以满足 8 KB 的大小限制。选择安装方式之前,请先参阅 Codex 配置详情。
Cursor 使用仓库中已提交的 plugin marketplace 注册表。请按照 Cursor 配置说明添加 marketplace 并安装 plugin。
使用 GitHub CLI 的 gh skill 命令或 npx skills 安装器,可以安装单个 skill。出现提示时,选择你的编程工具。这两种安装器都会直接从 GitHub 读取 skill,无须克隆仓库,安装时也不会附带 plugin 中的 Agent、命令或 hook。
gh skill install wshobson/agents python-testing-patterns
npx skills add wshobson/agents --skill python-testing-patterns
gh skill 要求 GitHub CLI 2.90 或更高版本。npx 命令要求安装 Node.js 和 npm。其他 Agent、安装范围和版本固定方式,请参阅仅安装 skill 的说明。
对于 OpenCode、Antigravity CLI、GitHub Copilot 和 Pi,需要克隆仓库并使用对应 harness 的安装器。请安装 uv、Python 3.12 或更高版本,以及你想使用的编程工具。以下克隆命令使用 GitHub CLI:
gh repo clone wshobson/agents ~/agents
cd ~/agents
运行与你的工具对应的命令。每个 target 都会生成产物,并将所有本地 plugin 链接到该工具的用户配置中:
make install-opencode
make install-antigravity
make install-copilot
make install-pi
Pi 的 Agent 需要其参考 subagent 扩展,或兼容的扩展。配置路径和卸载命令请参阅全局安装指南。
Agent、skill 和命令的数量统计仅涵盖本地源文件。外部 plugin 提供各自的组件,并有各自的安装要求。
一个 plugin 会将相关的 Agent、skill 和命令组织在 plugins/ 目录下。例如,python-development 包含三个 Agent、十六个 skill 和一个项目脚手架命令。所选 harness 会按照自身的发现和调用规则,加载已安装的组件。
贡献者只需维护一套采用 Claude Code plugin 格式的 Markdown 源文件。在支持的情况下,原生注册表会直接指向这些源文件,适配器则负责生成各个 harness 所需的格式。命令可能被转换成 skill 或 prompt 模板,Agent 格式、模型选择和工具权限也会因 harness 而异。
源文件中的 Agent 会指定 opus、sonnet、haiku、fable 或 inherit 等模型别名。适配器会将这些别名映射到各个 harness 的模型设置,其中部分 inherit 条目会使用固定的默认值。详情请参阅模型配置和适配器映射。
仓库会校验 plugin 结构、生成产物和文档。贡献者可以在仓库根目录运行以下检查:
make generate-all
make validate STRICT=1
make garden
plugin-eval 还提供无须调用模型的静态 skill 检查。例如:
uv run --project plugins/plugin-eval plugin-eval score plugins/python-development/skills/python-testing-patterns --depth quick
LLM 评审和 Monte Carlo 层仍处于实验阶段,尚未使用人工标注进行验证。它们的分数反映的是模型评估和重复模拟的结果,不能证明某项任务能在项目中成功完成。它们需要安装可选的 llm 依赖。如果设置了 ANTHROPIC_API_KEY,模型调用就会使用该密钥,费用计入对应的 API 账户;否则会使用你的 Claude Code 登录身份。配置方法和限制请参阅评估指南。
如需提出修改,请参阅 CONTRIBUTING.md;如需编写 plugin 内容,请参阅编写规范。
外部记忆集成
Pensyve 仍是可选的外部 Claude Code marketplace 条目。Pensyve 由 Major7 Apps 维护,而本仓库维护者是 Major7 Apps 的创始人。它的开源运行时可以在本地或你自己的服务器上运行。Pensyve Cloud 已于 2026 年 10 月 1 日关闭,其 dashboard、API 和托管 MCP 端点均已不可用。配置运行时时,请使用自托管指南。
本仓库采用 MIT 许可证。外部 plugin 使用各自的许可证。