内容
<div align="center">
<img src="assets/banner.svg" alt="Loadout — 为您的项目装备 Claude Code，只需一条命令" width="100%">
<br/>
### Loadout 会检查您的项目并为其自动设置 Claude Code。
它会找出哪些 **MCP 服务器、钩子和技能** 真正适合您的技术栈，显示一个简短的排名列表，并附上每个的理由，然后 **安装您选择的内容** — 为您编写配置。只需一条命令，而不是手动阅读包含 500 个条目的“awesome”列表并复制安装命令。
**适用于多个代理：** 完整的 Claude Code 设置，以及 **Codex、Cursor、opencode、Gemini CLI 和 OpenClaw** 的 MCP 服务器。
[English](README.md) · [한국어](README.ko.md)
</div>
---
> **一句话：** 指向一个仓库 → 它为该仓库推荐合适的 Claude Code 扩展 → 它应用这些扩展。
## 问题
Claude Code 生态系统拥有数千种技能、MCP 服务器、钩子和插件 — 分散在数十个“awesome”列表中。但每一个都是 **发现列表**：您需要阅读数百个条目，并猜测哪些适用于您。社区表示，*“awesome 列表的问题在于，它们被当作安装列表 — 它们实际上是发现列表。”*
没有人问过一个显而易见的问题：**给定 *我的* 项目，我应该安装什么 — 可以为我做吗？**
这就是 Loadout 的用途。
## Loadout 的功能
<p align="center"><img src="assets/demo.svg" alt="Loadout 在行动：检测技术栈、推荐负载、选择并应用到 .mcp.json 和 settings.json" width="92%"></p>
```text
$ npx claude-loadout
🎯 Loadout — 为该项目装备 Claude Code
检测到：package.json, next, react, tailwind, prettier, playwright
最佳领域：前端 / Web UI, 通用 / 任意项目
推荐的负载：
1 Playwright（浏览器自动化） [MCP 服务器]
通过可访问性快照驱动真实浏览器 — 导航、点击、断言、截图。
原因：匹配 react, next, playwright
2 自动格式化 JS/TS（Prettier） [钩子/设置]
在 Claude 编辑文件后，对其运行 Prettier，以确保差异始终干净。
原因：匹配 package.json, prettier, react
3 Context7（最新文档） [MCP 服务器]
拉取数千个库的版本准确文档到上下文 — 消除幻觉 API。
...
安装哪些？输入编号（例如 1,3,4）· 'a' = 所有 · 回车 = 跳过：1,2,3
✅ 应用：
.mcp.json + playwright, context7
.claude/settings.json + format-js-on-edit
```
它 **扫描** 您的项目（语言、框架、CI、现有配置），**匹配** 到一个或多个领域，**排名** 一个简短的负载列表，并附上每个条目的理由，让您 **选择**，并 **写入** 配置 — 合并到 `.mcp.json` 和 `.claude/settings.json`，绝不覆盖，并标记您仍需填写的令牌。
## 使用 Loadout 的两种方式
### 1. 在 Claude Code 内（推荐）
添加市场后，推荐器就是一个斜杠命令：
```text
/plugin marketplace add sukoji/loadout
/plugin install loadout@loadout
/loadout:recommend # 分析此仓库，推荐负载，并应用您的选择
/loadout:browse # 仅浏览目录，无需更改
```
`/loadout:recommend` 以人为的方式读取您的仓库，然后使用 `AskUserQuestion` 让您检查您想要的项目 — 并原地应用它们。
### 2. 作为独立的 CLI
```bash
cd your-project
npx claude-loadout # 交互式
npx claude-loadout --dry-run # 仅显示推荐
npx claude-loadout --all # 应用整个推荐负载
npx claude-loadout doctor # 审核令牌、钩子依赖、安全性漏洞（只读）
npx claude-loadout --help # 完整的标志列表
```
零依赖，~1 秒扫描/推荐，无需全局安装。
### CLI 标志
| 标志 | 功能 |
| :-- | :-- |
| *(无)* | 交互式 — 按编号选择项目 |
| `--dry-run` / `-d` | 仅显示推荐；不写入任何内容 |
| `--all` / `-a` / `-y` | 在不提示的情况下应用顶级推荐 |
| `--discover` | 还会显示 **未经验证** 的社区技能 |
| `--target <id>` | 为 `cursor`、`codex`、`gemini`、`opencode`、`openclaw` 或 `all` 编写 MCP 配置 |
| `--list-targets` | 列出代理和配置文件路径 |
| `doctor` | 只读审核：未填充的令牌、缺少的钩子工具、`.env` 保护、建议的漏洞 |
**非交互式 shell**（CI、管道）：使用 `--dry-run` 或 `--all` — 否则 Loadout 打印推荐并退出，而不挂起输入。
### Loadout 自动应用的内容与您需要执行的内容
| 类型 | Loadout 编写？ | 您仍然需要... |
| :-- | :-- | :-- |
| MCP 服务器 | ✅ 合并到 `.mcp.json`（或代理 MCP 文件） | 填写 API 密钥；托管服务器首次使用 OAuth |
| 钩子和设置 | ✅ 合并到 `.claude/settings.json` | 安装钩子依赖（`jq`、`ruff`...）；在 Windows 上使用 Git Bash/WSL 进行 shell 钩子 |
| 内置技能（`/init`、`/code-review`） | ❌ 已在 Claude Code 中 | 在您需要时运行斜杠命令 |
| 市场插件（Exa、Superpowers...） | ❌ 打印 `/plugin install ...` | 在 Claude Code 中运行这些命令 |
随时运行 `npx claude-loadout doctor` 以查看未填充的占位符和缺少的 PATH 工具。
## 与您的代理配合使用 — 不仅限于 Claude Code
MCP 服务器适用于当今的代理；只有配置文件和格式有所不同。Loadout 会为每个代理编写正确的配置文件。技能和钩子是 Claude Code 特有的，因此对于其他代理，Loadout 会应用 MCP 服务器并告诉您哪些是 Claude 特有的。
```bash
npx claude-loadout --target codex # 编写 ~/.codex-style .codex/config.toml
npx claude-loadout --target cursor # 编写 .cursor/mcp.json
npx claude-loadout --target claude,cursor # 同时应用于多个
npx claude-loadout --target all # 所有支持的代理
npx claude-loadout --list-targets # 查看所有代理
```
| 目标（`--target`） | 代理 | 配置文件 | MCP 格式 |
| :-- | :-- | :-- | :-- |
| `claude` *(默认)* | Claude Code | `.mcp.json` + `.claude/settings.json` | `mcpServers` + 技能/钩子 |
| `cursor` | Cursor | `.cursor/mcp.json` | `mcpServers` |
| `gemini` | Gemini CLI | `.gemini/settings.json` | `mcpServers` |
| `opencode` | opencode | `opencode.json` | `mcp` (`type: local`) |
| `codex` | Codex CLI | `.codex/config.toml` | `[mcp_servers.*]` (TOML) |
| `openclaw` | OpenClaw | `~/.openclaw/openclaw.json` | `mcp.servers` |
如果您不传递 `--target`，Loadout 会以 Claude Code 为目标，并指出它在项目中检测到的其他代理。
## 为什么 Loadout 不同
| 其他人 | Loadout |
| :-- | :-- |
| 一个您需要自己阅读和筛选的平面列表 | 分析 *您的* 仓库并为您推荐 |
| “这里有 500 个东西” | “这里有 6 个您需要的东西，以及原因” |
| 手动复制安装命令 | 为您编写 `.mcp.json` / `settings.json` |
| 仅发现 | 发现 **+ 应用**，一步到位 |
它也是一个 **插件市场** 和一个 **可浏览的目录** — 因此发现、推荐和安装都集中在一个地方。
## 覆盖范围 — 三个层级（不仅仅是一个固定的列表）
Loadout 从三个层级中提取，因此它涵盖了整个生态系统，而不会盲目地应用未经验证的内容：
- **精选（37）** — 人工验证的 MCP 服务器、钩子和技能。安全自动应用；每个 npx 包都经过检查，以确保在 npm 上解析 (`npm run verify:mcp`)，并在发布检查中启动烟雾测试 (`npm run test:mcps`)。
- **官方市场（~240）** — Anthropic 的官方插件目录，自动提取。当它们与您的技术栈匹配时显示，通过 `/plugin` 安装。
- **社区（`--discover`）** — 知名的社区技能，如 [caveman](https://github.com/JuliusBrussee/caveman)（令牌保存器）。仅在您请求时显示，标记为 **⚠ 未验证**，并且 **从不自动应用**。
```bash
npx claude-loadout # 精选 + 匹配的官方插件
npx claude-loadout --discover # 还会显示社区技能（在安装前请自行检查）
```
## 领域
Loadout 通过您正在进行的项目类型来组织其精选目录：
| 领域 | 适用于 |
| :-- | :-- |
| [前端 / Web UI](docs/domains/frontend.md) | React, Vue, Svelte, Next — 浏览器中的任何内容 |
| [后端 / API](docs/domains/backend-api.md) | 服务器、API、数据库 |
| [数据 / 机器学习 / 笔记本](docs/domains/data-ml.md) | Python 数据工作、训练、分析 |
| [研究 / 学术](docs/domains/research.md) | 文献综述、笔记本、论文、实验 |
| [DevOps / 基础设施](docs/domains/devops.md) | CI/CD、Docker、Terraform、Kubernetes |
| [移动](docs/domains/mobile.md) | iOS、Android、React Native、Flutter |
| [安全敏感](docs/domains/security.md) | 身份验证、支付、PII |
| [文档 / 编写 / 办公](docs/domains/docs-writing.md) | 文档和实际的 Word/Excel/PDF/PPT 交付成果 |
| [通用 / 任意项目](docs/domains/general.md) | 始终有用的基准 |
完整的可浏览索引：[docs/domains/](docs/domains/README.md)。
## 工作原理
```
您的仓库 ──▶ 扫描（信号） ──▶ 匹配领域 ──▶ 排名负载 ──▶ 您选择 ──▶ 应用
package.json, 前端 + 按信号强度 多选 .mcp.json
requirements.txt, 通用 排名 选择 .claude/settings.json
Dockerfile, .env… + 安装命令
```
- **目录** (`plugins/loadout/catalog/*.json`) 是单一的真实来源 — MCP 服务器、技能和钩子，每个都标记了它们匹配的领域和信号。技能和 CLI 读取相同的数据。
- **推荐器** 按每个领域中出现的信号数量为每个领域评分，将顶级领域的负载联合起来，删除您已经拥有的内容，并对剩余的内容进行排名。
- **应用** 深度合并到您的配置中。钩子附加到正确的事件数组；MCP 服务器位于 `mcpServers` 下；技能打印确切的 `/plugin` 或内置命令以运行。
## 贡献目录条目
目录旨在随着社区的发展而增长。将条目添加到 `plugins/loadout/catalog/` 中的相关文件中，用 `domains` 和 `signals` 标记，运行检查并打开 PR：
```bash
npm run validate # 目录完整性：唯一 ID、必填字段、领域引用
npm run build:docs # 从目录中重新生成 docs/domains/
```
在 [CONTRIBUTING.md](CONTRIBUTING.md) 中查看条目模式。
## 路线图
- [x] 将 `claude-loadout` 发布到 npm 以供 `npx` 使用
- [x] `loadout doctor` — 审核现有设置并建议缺少的内容
- [ ] 更多领域（游戏开发、嵌入式、浏览器扩展、Rust 系统）
- [ ] 社区投票的相关信号
- [ ] 团队负载 — 通过单个文件共享项目负载
## 许可证
MIT © sukoji。目录链接到由各自作者拥有的第三方工具；Loadout 仅策划和配置它们。
