wehub/wshobson--agents
1
0
Fork 0
Code Issues Pull Requests Actions 4 Deployments Models Agent Notes Packages Projects Releases Wiki Activity

docs: make Chinese README the default
Code Quality / Python (ruff + ty) (push) Waiting to run
Details
Code Quality / Markdown (markdownlint-cli2) (push) Waiting to run
Details
Code Quality / JSON / TOML / YAML syntax (push) Waiting to run
Details
Validate / Validate JSON files (push) Waiting to run
Details
Validate / plugin-eval pytest (push) Waiting to run
Details
Validate / Real-CLI smoke test (OpenCode + Gemini) (push) Waiting to run
Details
Validate / tools pytest (adapters + validators + gardener) (push) Waiting to run
Details
Validate / Cross-harness generation + validation (push) Waiting to run
Details

Browse Source
This commit is contained in:
wehub-resource-sync
2026-07-13 10:26:36 +00:00
parent cbe5c11ef4
commit 7215a5e5e3
1 changed files with 79 additions and 75 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+79 -75
View File
@@ -1,19 +1,25 @@
# Agentic Plugin Marketplace
<!-- 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 文件为准。
> Production-ready agentic workflow building blocks: **92 plugins**, **199 agents**,
> **162 skills**, **106 commands** — built for Claude Code and consumed natively by
> OpenAI Codex CLI, Cursor, OpenCode, Gemini CLI, and GitHub Copilot from a single Markdown source.
# Agentic 插件市场
> 生产就绪的智能体（agentic）工作流构建块：**92 个插件**、**199 个智能体**、
> **162 项技能**、**106 条命令** —— 面向 Claude Code 构建，并由单一 Markdown 源原生供
> OpenAI Codex CLI、Cursor、OpenCode、Gemini CLI 和 GitHub Copilot 使用。
[![Claude Code](https://img.shields.io/badge/Claude%20Code-native-blueviolet)](#claude-code) [![Codex CLI](https://img.shields.io/badge/Codex%20CLI-supported-black)](docs/harnesses.md) [![Cursor](https://img.shields.io/badge/Cursor-supported-purple)](docs/harnesses.md) [![OpenCode](https://img.shields.io/badge/OpenCode-supported-green)](docs/harnesses.md) [![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-supported-blue)](GEMINI.md) [![Copilot](https://img.shields.io/badge/Copilot-supported-lightgrey)](docs/harnesses.md)
> [!NOTE]
> One source-of-truth (`plugins/`), five harnesses. Each harness gets idiomatic,
> harness-native artifacts — not lowest-common-denominator translations.
> See [docs/harnesses.md](docs/harnesses.md) for the capability matrix.
> 单一事实来源（`plugins/`），五种工具链（harness）。每种工具链都会获得符合其习惯、
> 原生于该工具链的产物 —— 而非最低公分母的翻译。
> 能力矩阵见 [docs/harnesses.md](docs/harnesses.md)。
## Quick start
## 快速开始
Pick your harness:
选择你的工具链：
### Claude Code
@@ -22,18 +28,18 @@ Pick your harness:
/plugin install python-development # or any of 92 plugins
```
[→ Full Claude Code setup, troubleshooting, and plugin catalog](docs/usage.md)
[→ Claude Code 完整设置、故障排查与插件目录](docs/usage.md)
### Codex CLI · Cursor · OpenCode · Gemini CLI · Copilot
Codex and Cursor install natively from the committed registries (which point at the source `plugins/`):
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 and OpenCode install via clone + generate (the transformed trees are gitignored):
Gemini 和 OpenCode 通过克隆 + 生成安装（转换后的目录树已加入 gitignore）：
```bash
gh repo clone wshobson/agents ~/agents && cd ~/agents
@@ -41,25 +47,24 @@ make generate HARNESS=gemini && gemini extensions install . # Gemini
make install-opencode # OpenCode (runs generate + symlinks)
```
Setup details and per-harness gotchas: [docs/harnesses.md](docs/harnesses.md). Gemini-specific setup: [GEMINI.md](GEMINI.md) (also auto-loaded by Gemini CLI).
设置详情及各工具链注意事项：[docs/harnesses.md](docs/harnesses.md)。Gemini 专属设置：[GEMINI.md](GEMINI.md)（也会由 Gemini CLI 自动加载）。
## What's inside
## 内容概览
| | Count | What it is |
| | 数量 | 说明 |
|---|---:|---|
| **Plugins** | 92 | Granular, single-purpose installable units (88 local + 4 external via git-subdir) |
| **Agents** | 199 | Domain experts (architecture, languages, infra, security, data, ML, docs, business, SEO) |
| **Skills** | 162 | Modular knowledge packages with progressive disclosure (load when activated) |
| **Commands** | 106 | Slash commands: scaffolding, security scans, test gen, infrastructure setup |
| **Orchestrators** | 16 | Multi-agent coordination workflows (full-stack, security, ML, incident response) |
| **Plugins（插件）** | 92 | 细粒度、单一用途的可安装单元（88 个本地 + 4 个通过 git-subdir 引入的外部插件） |
| **Agents（智能体）** | 199 | 领域专家（架构、语言、基础设施、安全、数据、ML、文档、业务、SEO） |
| **Skills（技能）** | 162 | 模块化知识包，支持渐进式披露（激活时加载） |
| **Commands（命令）** | 106 | 斜杠命令：脚手架、安全扫描、测试生成、基础设施设置 |
| **Orchestrators（编排器）** | 16 | 多智能体协调工作流（全栈、安全、ML、事件响应） |
Browse the catalog: [docs/plugins.md](docs/plugins.md) · [docs/agents.md](docs/agents.md) · [docs/agent-skills.md](docs/agent-skills.md)
浏览目录：[docs/plugins.md](docs/plugins.md) · [docs/agents.md](docs/agents.md) · [docs/agent-skills.md](docs/agent-skills.md)
## How it works
## 工作原理
Each plugin is isolated and composable: agents, commands, and skills are auto-discovered
from directory structure. **Installing a plugin loads only its components into
context** — not the whole marketplace.
每个插件相互隔离且可组合：智能体、命令和技能会根据目录结构自动发现。
**安装插件时，仅将其组件加载到上下文中** —— 而非整个市场。
```
plugins/python-development/
@@ -69,31 +74,31 @@ plugins/python-development/
└── skills/ # 16 specialized skills (async, testing, packaging, …)
```
Tiered model strategy:
分层模型策略：
| Tier | Model | Use |
| 层级 | 模型 | 用途 |
|---|---|---|
| 0 | Fable 5 | Longest-horizon autonomous work — large migrations, multi-hour runs (opt-in, premium cost) |
| 1 | Opus | Architecture, security, code review, production-critical |
| 2 | inherit | User-chosen — backend, frontend, AI/ML, specialized |
| 3 | Sonnet | Docs, testing, debugging, API references |
| 4 | Haiku | Fast operational tasks, SEO, deployment, content |
| 0 | Fable 5 | 最长时程的自主工作 —— 大型迁移、数小时运行（可选，高级费用） |
| 1 | Opus | 架构、安全、代码审查、生产关键任务 |
| 2 | inherit | 用户自选 —— 后端、前端、AI/ML、专项领域 |
| 3 | Sonnet | 文档、测试、调试、API 参考 |
| 4 | Haiku | 快速运维任务、SEO、部署、内容 |
[→ Model configuration details](docs/agents.md#model-configuration)
[→ 模型配置详情](docs/agents.md#model-configuration)
## Multi-harness support
## 多工具链支持
This marketplace ships to five agentic harnesses from one Markdown source. Each adapter
emits harness-native artifacts (not lowest-common-denominator translations):
本市场从单一 Markdown 源分发至五种智能体工具链。每个适配器
会生成原生于该工具链的产物（而非最低公分母的翻译）：
| Harness | Generates | Notes |
| 工具链 | 生成内容 | 说明 |
|---|---|---|
| **Claude Code** | (source-of-truth) | Native `marketplace.json` + `plugins/` |
| **Codex CLI** | `.agents/plugins/marketplace.json` + `plugins/*/.codex-plugin/plugin.json` (committed); `.codex/skills/`, `.codex/agents/` (gitignored) | 8 KB skill cap respected; commands → skills |
| **Cursor** | `.cursor-plugin/`, `.cursor/rules/` | Thin marketplace + curated rules; reuses `.claude/` |
| **OpenCode** | `.opencode/agents/`, `.opencode/commands/`, `.opencode/skills/` | `permission:` block from `tools:` allowlist; OpenCode-safe skill names |
| **Gemini CLI** | `skills/`, `agents/`, `commands/` (TOML) | Native skills + subagents (April 2026 spec) |
| **Copilot** | `.copilot/agents/`, `.copilot/skills/`, `.copilot/commands/` | Markdown agent profiles + SKILL.md skills + commands-as-skills; model maps to native Claude models |
| **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
@@ -101,63 +106,62 @@ make validate # structural checks
make garden # drift / dead-link / cap detection
```
Codex and Cursor install from source via committed registries; Gemini and OpenCode install via clone + `make`.
Codex 和 Cursor 通过已提交的注册表从源安装；Gemini 和 OpenCode 通过克隆 + `make` 安装。
[→ Full capability matrix and per-harness deep-dives](docs/harnesses.md)
[→ 完整能力矩阵与各工具链深入说明](docs/harnesses.md)
## Quality evaluation
## 质量评估
[`plugin-eval`](plugins/plugin-eval/) is a three-layer evaluation framework for measuring
and certifying plugin/skill quality:
[`plugin-eval`](plugins/plugin-eval/) 是用于衡量
和认证插件/技能质量的三层评估框架：
- **Static** — deterministic structural analysis (<2s, free)
- **LLM Judge** — semantic evaluation across 4 dimensions (~30s, Haiku + Sonnet)
- **Monte Carlo** — statistical reliability via 50-100 simulated runs (~2-5 min)
- **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 framework documentation](docs/plugin-eval.md)
[→ PluginEval 框架文档](docs/plugin-eval.md)
## Documentation map
## 文档地图
Detail lives in `docs/`. Read in this order:
详细内容位于 `docs/`。建议按以下顺序阅读：
- **[docs/plugins.md](docs/plugins.md)** — full catalog of all 92 plugins
- **[docs/agents.md](docs/agents.md)** — all 199 agents by category
- **[docs/agent-skills.md](docs/agent-skills.md)** — 162 skills with progressive disclosure
- **[docs/usage.md](docs/usage.md)** — commands, workflows, examples
- **[docs/architecture.md](docs/architecture.md)** — design principles
- **[docs/harnesses.md](docs/harnesses.md)** — cross-harness capability matrix
- **[docs/authoring.md](docs/authoring.md)** — portable-content style guide
- **[docs/plugin-eval.md](docs/plugin-eval.md)** — quality evaluation framework
- **[docs/round-trip-results.md](docs/round-trip-results.md)** — real-CLI verification recipes
- **[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-specific setup: [GEMINI.md](GEMINI.md). All other harness setup, capability deltas, and gotchas live in [docs/harnesses.md](docs/harnesses.md).
Gemini 专属设置：[GEMINI.md](GEMINI.md)。其他所有工具链的设置、能力差异和注意事项见 [docs/harnesses.md](docs/harnesses.md)。
Contributing: [CONTRIBUTING.md](CONTRIBUTING.md) · Authoring: [docs/authoring.md](docs/authoring.md)
贡献指南：[CONTRIBUTING.md](CONTRIBUTING.md) · 创作指南：[docs/authoring.md](docs/authoring.md)
## External Memory Integration
## 外部记忆集成
[Pensyve](https://github.com/major7apps/pensyve) is included as an external
`git-subdir` entry for Claude Code. Pensyve also maintains direct upstream
integrations for this marketplace's other supported harnesses.
[Pensyve](https://github.com/major7apps/pensyve) 作为外部
`git-subdir` 条目包含在 Claude Code 中。Pensyve 还为该市场支持的其他工具链维护直接上游集成。
| Harness | Pensyve integration |
| 工具链 | Pensyve 集成 |
|---|---|
| Claude Code | `/plugin install pensyve` from this marketplace (`integrations/claude-code`) |
| 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/` in repo root or `~/.copilot/` via `make install-copilot` |
| Copilot | 仓库根目录的 `.copilot/` 或通过 `make install-copilot` 使用 `~/.copilot/` |
## License
## 许可证
MIT — see [LICENSE](LICENSE).
MIT —— 见 [LICENSE](LICENSE)。
## Star history
## Star 历史
[![Star History Chart](https://api.star-history.com/svg?repos=wshobson/agents&type=date&legend=top-left)](https://www.star-history.com/#wshobson/agents&type=date&legend=top-left)