wshobson-agents

wshobson/agents 快速入门

多 Harness Agentic 插件市场，统一 Markdown 源，一套配置适配六大 AI 编程工具

⭐ 评分: 8.5/10 💰 价格: 开源免费 🏢 维护者: wshobson 🌐 仓库: github.com/wshobson/agents

这是什么？

wshobson/agents 是一个多 Harness 的 AI Agent 插件市场，核心创新是「一次编写，到处运行」的统一 Markdown 源格式。你用同一套 Markdown 文件定义 Agent、Skill 和命令，它会自动适配到 Claude Code、Codex CLI、Cursor、OpenCode、Gemini CLI、GitHub Copilot 等六大 AI 编程工具。

项目规模：94 个插件、203 个 Agent、175 个 Skills、109 个命令，37.9k Stars，4k Forks。

适合谁：使用多个 AI 编程工具的开发者、想在不同工具间共享 Agent 配置的团队、需要在多个 Harness 间切换但不想重复配置的用户。

准备工作

• 至少一个支持的 AI 编程工具（Claude Code / Codex CLI / Cursor / OpenCode / Gemini CLI / GitHub Copilot）
• Git 和 Node.js 环境
• 10 分钟了解 Markdown 插件格式

三步快速上手

第一步：克隆仓库

git clone https://github.com/wshobson/agents.git
cd agents

第二步：选择你的 Harness

根据你使用的 AI 编程工具，将对应配置文件复制到工具目录：

• Claude Code: 复制 claude/ 目录到 ~/.claude/
• Codex CLI: 复制 codex/ 目录到 ~/.codex/
• Cursor: 复制 cursor/ 目录到项目 .cursor/
• Gemini CLI: 复制 gemini/ 目录到 ~/.gemini/

第三步：使用 Agent

在 AI 编程工具中直接调用已安装的 Agent：

使用 code-reviewer Agent 审查当前 PR
使用 test-generator Skill 为这个模块生成测试

核心特性

• 统一 Markdown 源：一套 .md 文件定义所有 Agent/Skill/Command
• 六 Harness 适配：Claude Code / Codex CLI / Cursor / OpenCode / Gemini CLI / GitHub Copilot
• 插件市场丰富：94 插件 + 203 Agent + 175 Skill + 109 命令
• 社区驱动：37.9k Stars，MIT 开源，活跃维护

常见踩坑

1. Harness 配置文件路径不同 — 每个工具的配置目录不同，需仔细核对文档
2. 部分 Agent 依赖特定 API Key — 使用前检查 Agent 文档中的依赖声明
3. 更新后旧配置可能冲突 — 建议先备份再更新
4. 自定义 Agent 和内置 Agent 命名冲突 — 使用唯一命名前缀避免
5. 多 Harness 切换时注意环境变量 — 不同工具的 API Key 环境变量名可能不同

常见问题 FAQ

Q1: 和 claude-skills 有什么区别？

A: wshobson/agents 是多 Harness 架构，支持六大 AI 编程工具。claude-skills 是 Claude Code 专用。wshobson 的优势在于跨工具兼容。

Q2: 如何贡献自己的 Agent？

A: Fork 仓库 → 按 Markdown 格式创建 Agent 文件 → 提交 PR。格式参考仓库中的 CONTRIBUTING.md。

Q3: 自定义 Agent 能在所有 Harness 中运行吗？

A: 是的。只要遵循统一 Markdown 格式，自定义 Agent 会自动适配所有六种 Harness。

Q4: 更新频率如何？

A: 社区活跃，每周有多个 PR 合并。建议定期 git pull 获取最新 Agent。

Q5: 是否支持私有 Agent 配置？

A: 支持。可在本地 .agents/ 目录创建私有 Agent，不会被 git 追踪。

参考链接

• 官方仓库
• Markdown 格式文档