wshobson/agents · 上手攻略
- 仓库：wshobson/agents
- 链接：https://github.com/wshobson/agents
- 分类：agent, skill, workflow
- 作者：Jay
- 更新：2026-07-08
这是什么
wshobson/agents 是一个面向 AI 编程 Agent 的插件式市场（Plugin Marketplace），特点是从一份 Markdown 源码同时生成五套主流 Agent 平台的原生插件包：一套源码，Claude Code / Codex CLI / Cursor / OpenCode / Gemini CLI / GitHub Copilot 五个 harness 全部覆盖。
截至 2026 年，仓库包含：
| 类别 | 数量 | 说明 |
|---|---|---|
| Plugins | 88 | 独立安装单元，含 agents / commands / skills |
| Agents | 194 | 各领域专家（架构、前端、后端、安全、数据、ML 等） |
| Skills | 158 | 模块化知识包，按需加载 |
| Commands | 106 | 斜杠命令（脚手架、扫描、测试生成、基础设施等） |
| Orchestrators | 16 | 多 Agent 协调工作流 |
定位是让 AI Agent 真正具备生产级技能——不是通用聊天，而是装了什么插件就是什么专家。
解决什么问题
主流 AI 编程 Agent（Claude Code、Cursor、Codex CLI 等）默认能力是通用的，缺少专业领域的深度知识和工作流。比如： - 没有专门的 Python/JS 项目脚手架 - 没有 TDD 测试流程 - 没有安全扫描流程 - 没有全栈多 Agent 协调能力
传统的做法是给 Agent 写长 System Prompt，既不稳定又难以复用。wshobson/agents 的思路是把专业能力做成可安装的插件，像 VS Code 装插件一样，给 AI Agent 装插件。
核心价值：一份源码，同时服务 5 个 Agent 平台，不需要维护多套插件。
快速安装
⚠️ 以下以 Claude Code 为主要 harness，其他平台见 docs/harnesses.md。
前置要求
- Node.js ≥ 18（部分 harnesses 需要）
- Claude Code 已安装并登录
- Git
Claude Code 安装（推荐方式）
# 添加市场
/plugin marketplace add wshobson/agents
# 安装单个插件
/plugin install python-development
/plugin install backend-development
/plugin install debugging-toolkit
/plugin install unit-testing
# 查看所有可用插件
/plugin
📌 安装插件后，agents / commands / skills 会自动加载到 Claude Code 的上下文中，不需要重启。
Codex CLI
npx codex-marketplace add wshobson/agents
# 然后在 Codex CLI 中 /plugin install <name>
Cursor
在 Cursor 设置中添加 marketplace，然后 /plugin install <name>。
Gemini CLI + OpenCode（需 clone + generate）
gh repo clone wshobson/agents ~/agents && cd ~/agents
# Gemini
make generate HARNESS=gemini && gemini extensions install .
# OpenCode
make install-opencode
全部生成（高级用户）
make generate-all # 生成五个 harness 的全部插件
make validate # 结构检查
make garden # drift / dead-link / cap 检测
核心用法
1. 使用斜杠命令（最直观）
插件安装后，Claude Code 中直接敲斜杠命令：
/backend-development:feature-development
/unit-testing:test-generate
/tdd-workflows:tdd-cycle
/git-pr-workflows:create-pr
/security-auditor:owasp-scan
/incident-response:incident-response
用
/plugin可列出所有已安装的命令。
2. 自然语言调用 Agent
"用 backend-architect 设计一个认证 API"
"让 security-auditor 扫描这个项目的 OWASP 漏洞"
"请 performance-engineer 优化这条 SQL 查询"
Claude Code 会自动判断调用哪个 Agent 并协调工作。
3. 安装完整领域包（推荐起步）
# Python 全栈开发
/plugin install python-development
# JavaScript/TypeScript 全栈
/plugin install javascript-typescript
# 全栈协调（后端+前端+测试+安全+部署一条龙）
/plugin install full-stack-orchestration
# 安全与运营
/plugin install cloud-infrastructure
/plugin install incident-response
4. Agent 模型分级策略
| 层级 | 模型 | 用途 |
|---|---|---|
| T0 | Fable 5 | 超长周期自主任务（大型迁移、数小时运行，需付费） |
| T1 | Opus | 架构、安全、代码审查、生产级关键任务 |
| T2 | inherit（用户自选） | 后端、前端、AI/ML、专业领域 |
| T3 | Sonnet | 文档、测试生成、调试、API 参考 |
| T4 | Haiku | 快速操作任务、SEO、部署、内容生成 |
详见 docs/agents.md#model-configuration。
5. 质量评估框架（plugin-eval）
# 快速评分
uv run plugin-eval score path/to/skill --depth quick
# 完整认证
uv run plugin-eval certify path/to/skill
三层评估：静态分析（<2s）→ LLM Judge（~30s）→ Monte Carlo（~2-5min，50-100 次模拟运行）。
典型适用场景
| 场景 | 推荐插件 |
|---|---|
| 从零启动 Python 项目 | python-development + unit-testing |
| 从零启动 JS/TS 项目 | javascript-typescript + frontend-mobile-development |
| TDD 开发流程 | tdd-workflows 全套命令 |
| 生产安全审计 | security-auditor |
| 完整功能开发（后端→前端→测试→部署） | full-stack-orchestration |
| 事故应急响应 | incident-response |
| 云架构设计 | cloud-infrastructure |
坑与注意
- Codex 8KB Skill 限制：Codex CLI 有 8KB skill 内容上限，市场已处理但注意不要自己改大；超过上限的部分会自动截断。
- Gemini CLI / OpenCode 需手动 generate：这两个平台不直接从 committed registry 安装，必须 clone 后
make generate HARNESS=gemini，生成的目录在.gitignore中。 - 插件按需安装：不需要一次性装 88 个插件——装需要的领域即可，Claude Code 每次只加载当前会话中涉及的组件。
- Fable 5 需付费：T0 模型（Fable 5）是商业化的，超长任务才需要，日常开发 T1~T3 足够。
- 外部 git-subdir 插件：Pensyve、qa-orchestra、storymap-skill 是外部仓库引用，更新频率由上游控制。
- Windows 兼容性：Claude Code 和 Codex 对 Windows 支持较好，但 OpenCode 在 Windows 上偶有路径问题（建议 WSL2）。
- 并发限制：多 Agent 协调场景（如
full-stack-orchestration）会同时调用多个模型，注意 API Rate Limit 和预算。
与同类对比
| 项目 | 定位 | 优势 | 劣势 |
|---|---|---|---|
| wshobson/agents | Agent 插件市场 | 一源码五平台、194 个 Agent、质量评估框架 | 非国内项目、文档英文为主 |
| Claude Code 原生 Skills | Agent 技能系统 | 官方支持、稳定性高 | 只能用于 Claude Code |
| Cursor Rules | Agent 规则集 | 与编辑器深度集成 | 只能用于 Cursor |
| awesome-claude-skills | Claude Skills 精选列表 | 收录广 | 质量参差，无跨平台保证 |
| Composio | Agent 工具/动作集成 | 工具生态丰富 | 偏向工具调用，非 Agent 知识/工作流 |
核心差异：wshobson/agents 是目前跨 Agent 平台覆盖最广的插件市场，一份内容同时服务 5 个主流平台，适合在多个 Agent 产品间切换或有跨平台需求的团队。
一句话推荐结论
如果你用 Claude Code（或 Codex CLI、Cursor 等），想让它具备真实的 Python 开发、安全审计、TDD 流程等生产级能力，直接装这个市场的对应插件——比写长 System Prompt 稳定得多，一个命令搞定。