wehub-resource-sync
7215a5e5e3
Code Quality / Python (ruff + ty) (push) Has been cancelled
Code Quality / Markdown (markdownlint-cli2) (push) Has been cancelled
Validate / Cross-harness generation + validation (push) Has been cancelled
Validate / Real-CLI smoke test (OpenCode + Gemini) (push) Has been cancelled
Code Quality / JSON / TOML / YAML syntax (push) Has been cancelled
Validate / Validate JSON files (push) Has been cancelled
Validate / plugin-eval pytest (push) Has been cancelled
Validate / tools pytest (adapters + validators + gardener) (push) Has been cancelled
168 lines
8.5 KiB
Markdown
168 lines
8.5 KiB
Markdown
<!-- WEHUB_ZH_README -->
|
||
> [!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 <name>` (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)
|