用一条命令为所有 AI Coding Agent 安装 Skills
目录
同时维护多个 AI coding 工具是越来越常见的选择。我本地同时使用 Claude Code、GitHub Copilot、Gemini CLI、Qwen 和 OpenCode。
每个工具在正式使用前通常都需要一定的配置，让它了解你的工作方式——比如"先写测试再写实现"，或者"遇到 bug 先系统排查再动手改代码"。
问题在于，每个工具的配置文件格式各不相同：
- Claude Code 读取
CLAUDE.md - GitHub Copilot 读取
.github/copilot-instructions.md - Gemini CLI 读取
GEMINI.md - OpenCode 读取
OPENCODE.md
这意味着同一套工作方式的描述，需要在多个文件里重复维护。有没有更省事一点的方式？
背景：多 agent 的配置碎片化问题#
想象你希望所有 AI 工具都遵循 TDD（测试驱动开发）——先写失败的测试，再写最小实现，再重构。
在以前，你需要把这套描述分别写入每个工具的配置文件。一旦你想调整措辞或补充细节，就得同步修改多处。更麻烦的是，这些配置不太方便和别人共享，也不容易直接复用社区里整理好的工作流配置。
Skills 生态系统可以在一定程度上缓解这个问题。
Skills 生态：统一的能力扩展标准#
Skills 是一套开放的约定：将 AI agent 的工作方式描述为 Markdown 文件，统一存放在项目的 .agents/skills/ 目录下。支持这套约定的工具通常会按约定读取这个目录，因此不需要为每个工具分别维护一套格式。
这套标准由三个部分组成：
- skills.sh — 公共 skills 目录，可以浏览和搜索社区发布的 skills
- npx skills CLI — 命令行工具，用于发现、安装和管理 skills
- 本地
.agents/skills/目录 — skills 的实际存储位置，可以通过 Git 提交和共享
常用命令：
| 操作 | 命令 |
|---|---|
| 搜索 skills | npx skills find <keywords> |
| 安装 skill 包 | npx skills add <owner/repo> |
| 列出已安装的 skills | npx skills list |
| 移除 skill | npx skills remove <skill-name> |
因为 skills 以文件形式存储在项目里，它们可以通过 Git 版本管理，团队成员共享同一套配置，也可以从公共仓库安装他人发布的 skills 包。
Superpowers 是什么#
Superpowers 是由 Adam Wiggins（obra）维护的一组 skills，里面整理了他长期使用的一套 AI 工作方式。
安装后，你的 AI agent 将具备以下能力（部分）：
| Skill | 作用 |
|---|---|
test-driven-development |
强制 TDD 工作流：先写失败测试，再写实现 |
systematic-debugging |
遇到 bug 时系统排查，而不是直接猜测修改 |
brainstorming |
在实现前先探索需求和设计方案 |
writing-plans |
将复杂任务分解为带 checkbox 的实现计划 |
verification-before-completion |
在声称"完成"前先运行验证命令 |
finishing-a-development-branch |
功能完成后引导合并、PR 或清理流程 |
dispatching-parallel-agents |
多个独立任务时并行派发 subagent |
这些 skills 不是具体的功能扩展，而是定义了 AI agent 的工作方式——让它更严谨、更系统，减少"我以为没问题"类的错误。
一条命令安装#
安装 superpowers 只需要一条命令：
npx skills add https://github.com/obra/superpowers
安装完成后，skills 会存放在用户主目录的 .agents/skills/ 目录下：
支持 skills 约定的 AI 工具通常会自动读取这个目录，不需要再为每个工具单独补一层配置。
各 Agent 如何读取 Skills#
不同工具读取 skills 的路径约定各不相同：
| Agent | Skills 路径 | 项目指令文件 |
|---|---|---|
| Claude Code | ~/.claude/skills/ |
CLAUDE.md |
| Qwen Code | ~/.qwen/skills/ |
QWEN.md / AGENTS.md |
| OpenCode | ~/.agents/skills/（原生支持） |
AGENTS.md |
| GitHub Copilot | — | .github/copilot-instructions.md |
| Gemini CLI | — | GEMINI.md |
npx skills add 的工作方式是：首先将 skills 安装到通用的 ~/.agents/skills/ 目录。对于原生支持这个路径的 agent（如 OpenCode），直接生效。
对于不支持 .agents/skills/ 的 agent（如 Claude Code、Qwen），CLI 会交互式询问你使用哪个 code agent，然后在对应的目录（如 ~/.claude/skills/ 或 ~/.qwen/skills/）额外生成一份 skills 文件。
这意味着运行一次命令，按提示选择你用的所有 agent，即可完成全部配置。
总结#
按我的使用体验，Skills 把 AI 工具的提示词配置变成了更容易复用、分享的模块。通过 npx skills add，通常可以：
- 一次安装后，支持的 agent 可以统一接入
- 复用社区分享的工作流配置（比如 superpowers）
- 通过 Git 管理和共享团队配置
如果你也同时使用多个 AI coding 工具，skills 生态也许值得拿来试一下，看看能不能把碎片化配置收拢到一起。
npx skills add https://github.com/obra/superpowers
延伸阅读：
- skills.sh — 浏览公共 skills 目录
- obra/superpowers — Superpowers 仓库