wshobson--agents/README.md

Note

本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

Agentic 插件市场

生产就绪的智能体（agentic）工作流构建块：92 个插件、199 个智能体、 162 项技能、106 条命令 —— 面向 Claude Code 构建，并由单一 Markdown 源原生供 OpenAI Codex CLI、Cursor、OpenCode、Gemini CLI 和 GitHub Copilot 使用。

Note

单一事实来源（plugins/），五种工具链（harness）。每种工具链都会获得符合其习惯、 原生于该工具链的产物 —— 而非最低公分母的翻译。 能力矩阵见 docs/harnesses.md。

快速开始

选择你的工具链：

Claude Code

/plugin marketplace add wshobson/agents
/plugin install python-development          # or any of 92 plugins

→ Claude Code 完整设置、故障排查与插件目录

Codex CLI · Cursor · OpenCode · Gemini CLI · Copilot

Codex 和 Cursor 可从已提交的注册表原生安装（注册表指向源 plugins/）：

npx codex-marketplace add wshobson/agents        # Codex; then install individual plugins
# Cursor: add the marketplace, then `/plugin install <name>` (reads .cursor-plugin/ + source)

Gemini 和 OpenCode 通过克隆 + 生成安装（转换后的目录树已加入 gitignore）：

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。Gemini 专属设置：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/agents.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、部署、内容

→ 模型配置详情

多工具链支持

本市场从单一 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 模型

make generate-all                        # all five
make validate                            # structural checks
make garden                              # drift / dead-link / cap detection

Codex 和 Cursor 通过已提交的注册表从源安装；Gemini 和 OpenCode 通过克隆 + make 安装。

→ 完整能力矩阵与各工具链深入说明

质量评估

plugin-eval 是用于衡量 和认证插件/技能质量的三层评估框架：

• Static（静态） —— 确定性结构分析（<2s，免费）
• LLM Judge（LLM 评判） —— 跨 4 个维度的语义评估（约 30s，Haiku + Sonnet）
• Monte Carlo（蒙特卡洛） —— 通过 50–100 次模拟运行进行统计可靠性验证（约 2–5 分钟）

uv run plugin-eval score path/to/skill --depth quick
uv run plugin-eval certify path/to/skill

→ PluginEval 框架文档

文档地图

详细内容位于 docs/。建议按以下顺序阅读：

• docs/plugins.md —— 全部 92 个插件的完整目录
• docs/agents.md —— 按类别列出的全部 199 个智能体
• docs/agent-skills.md —— 162 项技能及渐进式披露说明
• docs/usage.md —— 命令、工作流、示例
• docs/architecture.md —— 设计原则
• docs/harnesses.md —— 跨工具链能力矩阵
• docs/authoring.md —— 可移植内容风格指南
• docs/plugin-eval.md —— 质量评估框架
• docs/round-trip-results.md —— 真实 CLI 验证方案

Gemini 专属设置：GEMINI.md。其他所有工具链的设置、能力差异和注意事项见 docs/harnesses.md。

贡献指南：CONTRIBUTING.md · 创作指南：docs/authoring.md

外部记忆集成

Pensyve 作为外部 git-subdir 条目包含在 Claude Code 中。Pensyve 还为该市场支持的其他工具链维护直接上游集成。

工具链	Pensyve 集成
Claude Code	来自本市场的 /plugin install pensyve（integrations/claude-code）
Codex CLI	integrations/codex-plugin
Cursor	integrations/cursor
OpenCode	integrations/opencode-plugin
Gemini CLI	gemini extensions install https://github.com/major7apps/pensyve
Copilot	仓库根目录的 .copilot/ 或通过 make install-copilot 使用 ~/.copilot/

许可证

MIT —— 见 LICENSE。

Star 历史