> [!NOTE] > 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。 > [English](./README.en.md) · [原始项目](https://github.com/wshobson/agents) · [上游 README](https://github.com/wshobson/agents/blob/HEAD/README.md) > 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。 # Agentic 插件市场 > 生产就绪的智能体（agentic）工作流构建块：**92 个插件**、**199 个智能体**、 > **162 项技能**、**106 条命令** —— 面向 Claude Code 构建，并由单一 Markdown 源原生供 > OpenAI Codex CLI、Cursor、OpenCode、Gemini CLI 和 GitHub Copilot 使用。 [](#claude-code) [](docs/harnesses.md) [](docs/harnesses.md) [](docs/harnesses.md) [](GEMINI.md) [](docs/harnesses.md) > [!NOTE] > 单一事实来源（`plugins/`），五种工具链（harness）。每种工具链都会获得符合其习惯、 > 原生于该工具链的产物 —— 而非最低公分母的翻译。 > 能力矩阵见 [docs/harnesses.md](docs/harnesses.md)。 ## 快速开始 选择你的工具链： ### Claude Code ```bash /plugin marketplace add wshobson/agents /plugin install python-development # or any of 92 plugins ``` [→ Claude Code 完整设置、故障排查与插件目录](docs/usage.md) ### Codex CLI · Cursor · OpenCode · Gemini CLI · Copilot Codex 和 Cursor 可从已提交的注册表原生安装（注册表指向源 `plugins/`）： ```bash npx codex-marketplace add wshobson/agents # Codex; then install individual plugins # Cursor: add the marketplace, then `/plugin install ` (reads .cursor-plugin/ + source) ``` Gemini 和 OpenCode 通过克隆 + 生成安装（转换后的目录树已加入 gitignore）： ```bash gh repo clone wshobson/agents ~/agents && cd ~/agents make generate HARNESS=gemini && gemini extensions install . # Gemini make install-opencode # OpenCode (runs generate + symlinks) ``` 设置详情及各工具链注意事项：[docs/harnesses.md](docs/harnesses.md)。Gemini 专属设置：[GEMINI.md](GEMINI.md)（也会由 Gemini CLI 自动加载）。 ## 内容概览 | | 数量 | 说明 | |---|---:|---| | **Plugins（插件）** | 92 | 细粒度、单一用途的可安装单元（88 个本地 + 4 个通过 git-subdir 引入的外部插件） | | **Agents（智能体）** | 199 | 领域专家（架构、语言、基础设施、安全、数据、ML、文档、业务、SEO） | | **Skills（技能）** | 162 | 模块化知识包，支持渐进式披露（激活时加载） | | **Commands（命令）** | 106 | 斜杠命令：脚手架、安全扫描、测试生成、基础设施设置 | | **Orchestrators（编排器）** | 16 | 多智能体协调工作流（全栈、安全、ML、事件响应） | 浏览目录：[docs/plugins.md](docs/plugins.md) · [docs/agents.md](docs/agents.md) · [docs/agent-skills.md](docs/agent-skills.md) ## 工作原理 每个插件相互隔离且可组合：智能体、命令和技能会根据目录结构自动发现。 **安装插件时，仅将其组件加载到上下文中** —— 而非整个市场。 ``` plugins/python-development/ ├── .claude-plugin/plugin.json ├── agents/ # 3 Python agents (python-pro, django-pro, fastapi-pro) ├── commands/ # 1 scaffolding command └── skills/ # 16 specialized skills (async, testing, packaging, …) ``` 分层模型策略： | 层级 | 模型 | 用途 | |---|---|---| | 0 | Fable 5 | 最长时程的自主工作 —— 大型迁移、数小时运行（可选，高级费用） | | 1 | Opus | 架构、安全、代码审查、生产关键任务 | | 2 | inherit | 用户自选 —— 后端、前端、AI/ML、专项领域 | | 3 | Sonnet | 文档、测试、调试、API 参考 | | 4 | Haiku | 快速运维任务、SEO、部署、内容 | [→ 模型配置详情](docs/agents.md#model-configuration) ## 多工具链支持 本市场从单一 Markdown 源分发至五种智能体工具链。每个适配器 会生成原生于该工具链的产物（而非最低公分母的翻译）： | 工具链 | 生成内容 | 说明 | |---|---|---| | **Claude Code** | （事实来源） | 原生 `marketplace.json` + `plugins/` | | **Codex CLI** | `.agents/plugins/marketplace.json` + `plugins/*/.codex-plugin/plugin.json`（已提交）；`.codex/skills/`、`.codex/agents/`（gitignored） | 遵守 8 KB 技能上限；命令 → 技能 | | **Cursor** | `.cursor-plugin/`、`.cursor/rules/` | 轻量市场 + 精选规则；复用 `.claude/` | | **OpenCode** | `.opencode/agents/`、`.opencode/commands/`、`.opencode/skills/` | 来自 `tools:` 白名单的 `permission:` 块；OpenCode 安全的技能命名 | | **Gemini CLI** | `skills/`、`agents/`、`commands/`（TOML） | 原生技能 + 子智能体（2026 年 4 月规范） | | **Copilot** | `.copilot/agents/`、`.copilot/skills/`、`.copilot/commands/` | Markdown 智能体配置 + SKILL.md 技能 + 命令即技能；模型映射到原生 Claude 模型 | ```bash make generate-all # all five make validate # structural checks make garden # drift / dead-link / cap detection ``` Codex 和 Cursor 通过已提交的注册表从源安装；Gemini 和 OpenCode 通过克隆 + `make` 安装。 [→ 完整能力矩阵与各工具链深入说明](docs/harnesses.md) ## 质量评估 [`plugin-eval`](plugins/plugin-eval/) 是用于衡量 和认证插件/技能质量的三层评估框架： - **Static（静态）** —— 确定性结构分析（<2s，免费） - **LLM Judge（LLM 评判）** —— 跨 4 个维度的语义评估（约 30s，Haiku + Sonnet） - **Monte Carlo（蒙特卡洛）** —— 通过 50–100 次模拟运行进行统计可靠性验证（约 2–5 分钟） ```bash uv run plugin-eval score path/to/skill --depth quick uv run plugin-eval certify path/to/skill ``` [→ PluginEval 框架文档](docs/plugin-eval.md) ## 文档地图 详细内容位于 `docs/`。建议按以下顺序阅读： - **[docs/plugins.md](docs/plugins.md)** —— 全部 92 个插件的完整目录 - **[docs/agents.md](docs/agents.md)** —— 按类别列出的全部 199 个智能体 - **[docs/agent-skills.md](docs/agent-skills.md)** —— 162 项技能及渐进式披露说明 - **[docs/usage.md](docs/usage.md)** —— 命令、工作流、示例 - **[docs/architecture.md](docs/architecture.md)** —— 设计原则 - **[docs/harnesses.md](docs/harnesses.md)** —— 跨工具链能力矩阵 - **[docs/authoring.md](docs/authoring.md)** —— 可移植内容风格指南 - **[docs/plugin-eval.md](docs/plugin-eval.md)** —— 质量评估框架 - **[docs/round-trip-results.md](docs/round-trip-results.md)** —— 真实 CLI 验证方案 Gemini 专属设置：[GEMINI.md](GEMINI.md)。其他所有工具链的设置、能力差异和注意事项见 [docs/harnesses.md](docs/harnesses.md)。 贡献指南：[CONTRIBUTING.md](CONTRIBUTING.md) · 创作指南：[docs/authoring.md](docs/authoring.md) ## 外部记忆集成 [Pensyve](https://github.com/major7apps/pensyve) 作为外部 `git-subdir` 条目包含在 Claude Code 中。Pensyve 还为该市场支持的其他工具链维护直接上游集成。 | 工具链 | Pensyve 集成 | |---|---| | Claude Code | 来自本市场的 `/plugin install pensyve`（`integrations/claude-code`） | | Codex CLI | [integrations/codex-plugin](https://github.com/major7apps/pensyve/tree/main/integrations/codex-plugin) | | Cursor | [integrations/cursor](https://github.com/major7apps/pensyve/tree/main/integrations/cursor) | | OpenCode | [integrations/opencode-plugin](https://github.com/major7apps/pensyve/tree/main/integrations/opencode-plugin) | | Gemini CLI | `gemini extensions install https://github.com/major7apps/pensyve` | | Copilot | 仓库根目录的 `.copilot/` 或通过 `make install-copilot` 使用 `~/.copilot/` | ## 许可证 MIT —— 见 [LICENSE](LICENSE)。 ## Star 历史 [](https://www.star-history.com/#wshobson/agents&type=date&legend=top-left)