# Addy Osmani 的工程技能

Canonical: https://cqbase.net/zh/entry/agent-skills
Chinese: https://cqbase.net/zh/entry/agent-skills
English: https://cqbase.net/en/entry/agent-skills

> 面向编码代理的一组工程技能，强调可维护的实现而不是一次性生成。

Addy Osmani 把一些他认为编码代理该具备的工程习惯收成技能，仓库说明写的是面向生产的工程技能，MIT 许可。主题围绕怎么让代理写出能留下来的代码，而不是只求一次生成通过。

用法是挑和你技术栈接近的技能，看它要求代理先检查什么，再决定要不要放进自己的技能目录。把它当成检查清单的来源，而不是整库安装。

## 解决什么问题

[addyosmani/agent-skills](https://github.com/addyosmani/agent-skills) 是 Addy Osmani 等人维护的一组面向编码代理的工程技能，仓库说明把它定位为可在开发各阶段复用的工作流和检查项。主题覆盖从写规格、拆任务、按测试实现，到代码评审和发布。配套站点是 [skills.addy.ie](https://skills.addy.ie)。仓库用 MIT 许可发布，并未归档。

核验日期为 2026-11-16（Asia/Shanghai）。GitHub Releases 的最新正式版是 [0.6.16](https://github.com/addyosmani/agent-skills/releases/tag/0.6.16)，发布时间是 2026-11-14 04:33 UTC，换算为 2026-11-14 12:33（Asia/Shanghai）。当前 README 写明整包共 25 项技能，并提供 9 条与开发周期对应的斜杠命令（如 `/spec`、`/plan`、`/build`、`/test`、`/review`、`/ship`）。它不是「必须整库一次性装完」的产品；官方同时提供按单项技能安装的方式。

## 适合谁

适合已经在使用 Claude Code、Cursor、Codex 或其他支持技能的编码工具，并希望代理先把规格和验证标准说清楚，再改代码的人。若你只想临时让代理改一个小文件，不必先装整包。

仓库另有一份 [比较说明](https://github.com/addyosmani/agent-skills/blob/main/docs/comparison.md)，用来对照 Superpowers 等其他技能包。选择前请自己阅读，不要只根据星标或转述做决定。安装前先读你打算启用的那一项 `SKILL.md`，确认它要求代理先检查什么。

## 怎么装

命令来自 2026-11-16 查阅的仓库 [README](https://github.com/addyosmani/agent-skills/blob/main/README.md)。官方把 [vercel-labs/skills](https://github.com/vercel-labs/skills) 这条 CLI 当作可覆盖多种代理的快捷方式。建议先浏览再决定装哪些，而不是默认装全部 25 项：

```bash
npx skills add addyosmani/agent-skills --list
npx skills add addyosmani/agent-skills --skill test-driven-development
```

若你确认要装整包，官方命令是：

```bash
npx skills add addyosmani/agent-skills
```

**Claude Code**

README 把 Claude Code 标为推荐集成之一。先登记市场，再安装插件：

```text
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
```

若克隆时出现 SSH 错误，官方建议改用完整 HTTPS 地址：

```text
/plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills
```

Claude Code 里如果某条内置命令重名（README 明确举了 `/review`），应使用带命名空间的形式，例如 `/agent-skills:review`。

**Cursor**

官方说明是把工作流技能放到项目的 `.cursor/skills/`（从仓库的 `skills/` 同步），把简短策略放到 `.cursor/rules/*.mdc`，不要把整份技能正文贴进 rules。本仓库本身不带 `.cursor/` 目录，细节见 [docs/cursor-setup.md](https://github.com/addyosmani/agent-skills/blob/main/docs/cursor-setup.md)。

**Codex CLI**

README 要求 Codex CLI v0.122 或更新：

```bash
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills
```

其他工具（Gemini CLI、OpenCode、Copilot 等）各有单独文档，请以 README 里对应链接为准。

## 一个实际例子

下面以官方示例里的 `test-driven-development` 为起点，只在一个很小的练习任务上启用单项技能。本次没有实跑，因此不编造测试输出或代理对话。

1. 先执行 `npx skills add addyosmani/agent-skills --list`，确认该技能的当前名称，再按上一节安装这一项（或在 Claude Code 里用官方插件命令后，只调用与测试相关的技能）。
2. 在一个可丢弃的练习目录里，给代理一个范围很小的任务，例如「为已有函数补一个失败测试，再写刚好让它通过的实现」。提示词示例：`Use the test-driven-development skill. Add a failing unit test for the existing function that parses a date string, then write the minimum code to make it pass. Do not refactor unrelated files.`
3. 预期效果（来自技能定位，不是实测）：代理应先补测试并确认失败，再改实现，而不是先改生产代码。
4. 请自己查看 diff 和测试命令。若技能引用了仓库级 `references/` 清单却找不到文件，先看下一节，不要反复重装。

## 常见坑

- 一上来就执行「安装全部 25 项」。整包会同时引入规格、测试、评审等多条工作流，可能和你已有的项目约定冲突。先读 `SKILL.md`，先装一项。
- 只按单项 `npx skills add ... --skill` 安装时，当前 README 仍写明：这种方式只复制 `skills/<name>/`，不会带上仓库级的 `references/` 共享清单；技能还能用，但补充清单不可用。README 把这个问题指向 [issue #361](https://github.com/addyosmani/agent-skills/issues/361)。该 issue 已于 2026-08-03 20:14 UTC（2026-08-04 04:14 Asia/Shanghai）关闭，关闭原因为 completed。本次没有重跑 `npx` 来核实缺口是否已经完全消失，因此仍按当前 README 的建议处理：改用整库集成、克隆仓库，或把需要的清单复制进已安装的技能目录。
- 在 Claude Code 里输入 `/review`，结果调用的不是本包的评审技能。官方已提醒使用 `/agent-skills:review`。
- 在 Windows 或 macOS 上用默认 SSH 地址登记市场，遇到 `Permission denied (publickey)`。先改用 README 给出的 HTTPS 写法，而不是反复重试同一条 SSH 命令。
- 在 Cursor 里把整份 `SKILL.md` 粘贴进 rules。官方明确不建议这样做。

## FAQ

### 必须一次安装全部 25 项技能吗？

不必。官方同时提供 `--list` 浏览和 `--skill` 按项安装。更稳妥的做法是先装一项与当前任务相关的技能，确认它的检查项适合你的仓库后再扩展。

### Claude Code 的安装命令是什么？

2026-11-16 的 README 写的是：先 `/plugin marketplace add addyosmani/agent-skills`，再 `/plugin install agent-skills@addy-agent-skills`。若遇 SSH 问题，改用 README 中的 HTTPS 仓库地址。

### 为什么技能提到的共享清单找不到？

当前 README 仍说明：按单项安装时不会复制仓库级 `references/`。它引用的 [issue #361](https://github.com/addyosmani/agent-skills/issues/361) 已经关闭。本次没有实跑验证该行为在 0.6.16 上是否变化，请以当前 README 的安装说明为准。

### 它和 Superpowers 有什么不同？

二者都是给编码代理用的技能包，侧重点和触发方式并不相同。请直接阅读仓库的 [comparison.md](https://github.com/addyosmani/agent-skills/blob/main/docs/comparison.md)，本文不把第三方评测写成结论。

### 许可证和当前版本是什么？

仓库为 MIT 许可，见 [LICENSE](https://github.com/addyosmani/agent-skills/blob/main/LICENSE)。2026-11-16 查阅的最新正式版是 0.6.16（2026-11-14 12:33 Asia/Shanghai）。商用或再分发前请自行阅读许可全文。

## 来源与许可

仓库 [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills) 使用 MIT 许可。本文依据 2026-11-16 查阅的 README、[0.6.16 发版说明](https://github.com/addyosmani/agent-skills/releases/tag/0.6.16)、[Cursor 安装文档](https://github.com/addyosmani/agent-skills/blob/main/docs/cursor-setup.md) 以及 [issue #361](https://github.com/addyosmani/agent-skills/issues/361)，用自己的话写成，供 CQBase 上下文库使用。若安装命令有变，以仓库 README 为准。

## 收录信息

- 作者: addyosmani
- 许可证: MIT
- 来源: https://github.com/addyosmani/agent-skills
- 收录: 2026-11-15
- GitHub 星标: 117708（采集 2026-11-15）

