Agent Skills 工程技能包

# Agent Skills：安装说明

这个工具包里只有安装说明，由 Mindket 编写。技能、命令、角色和清单要从 Addy Osmani 的仓库安装，地址是 https://github.com/addyosmani/agent-skills

这些说明不是 Addy Osmani 写的，也没有得到他的认可。Mindket 在 2026 年 11 月 3 日读了制作方的 README 和文档。README 把这个项目称为“Production-grade engineering skills for AI coding agents.”，意思是：给 AI 编程智能体用的、可用于生产的工程技能。它还说这些技能“encode the workflows, quality gates, and best practices that senior engineers use when building software.”，意思是：把资深工程师做软件时用的工作流、质量关卡和最佳做法写了下来。README 在 https://github.com/addyosmani/agent-skills/blob/main/README.md

许可证：MIT。LICENSE 文件（https://github.com/addyosmani/agent-skills/blob/main/LICENSE）写的是“Copyright (c) 2025 Addy Osmani”。

## 制作方怎么说它是什么

每个技能都是一个叫 `SKILL.md` 的 Markdown 文件。入门页说技能“are not reference docs”，也就是不是参考文档：它们是智能体照着做的分步流程，带验证步骤、要避开的反模式和结束条件。来源：https://github.com/addyosmani/agent-skills/blob/main/docs/getting-started.md

仓库里有：

- `skills/`：技能，一个技能一个文件夹，README 把它们分成 Meta、Define、Plan、Build、Verify、Review 和 Ship。
- 生命周期斜杠命令：`/spec`、`/plan`、`/build`、`/test`、`/constraints`、`/review`、`/webperf`、`/code-simplify` 和 `/ship`。它们是 Claude Code 的命令，一些其他宿主有封装。
- `agents/`：审查角色，`code-reviewer`、`test-engineer`、`security-auditor` 和 `web-performance-auditor`。
- `references/`：技能需要时会引用的清单，比如完成的定义、测试模式和安全清单。
- Claude Code（`.claude/commands/`、`.claude-plugin/`、`hooks/`）、Gemini CLI（`.gemini/commands/`）、Antigravity CLI（`commands/` 和 `plugin.json`）、Codex（`.codex-plugin/`、`.agents/plugins/`）和 GitHub Copilot CLI（根目录的 `plugin.json`）的适配文件，另有校验脚本、路由评测和 CI。

## 事先需要准备

- 你选的智能体。每个智能体的安装说明在 setup/ 里。
- Claude Code 途径需要一个能用 `/plugin` 的会话。市场通过 SSH 克隆仓库，所以要在 GitHub 上配好 SSH 密钥，或者用 setup/claude-code.md 里的 HTTPS 写法。
- Codex 途径需要 Codex CLI v0.122 或更高版本。来源：https://github.com/addyosmani/agent-skills/blob/main/docs/codex-setup.md
- 一条命令的途径需要 `npx`，它运行开放的 skills CLI（https://github.com/vercel-labs/skills）。README 链接了这个 CLI，没有说明它的设置。
- `git`，用于先克隆仓库的那些途径。

## 安装命令

README 里最快的途径适用于 skills CLI 支持的任何智能体。它能装进 Claude Code、Cursor、Codex、Copilot、Cline 等：

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

安装前先浏览：

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

来源：https://github.com/addyosmani/agent-skills/blob/main/README.md

大多数智能体也有自己的原生途径，原样抄在 setup/ 下它自己的文件里。Kiro 的部分，README 只给了一个文件夹和一个链接。

## 各智能体的说明

- setup/claude-code.md：市场插件、命令和角色
- setup/codex.md：Codex 插件
- setup/cursor.md：`.cursor/skills/` 里的技能和一条简短的规则
- setup/gemini-cli.md：原生技能、`GEMINI.md` 和命令封装
- setup/antigravity.md：`agy plugin install` 和命令的限制
- setup/github-copilot.md：VS Code 里的 Copilot 和 Copilot CLI
- setup/opencode.md：`.opencode/skills/` 里的技能和你自己的 `AGENTS.md`
- setup/windsurf.md：一个 `.windsurfrules` 文件
- setup/command-code.md：`cmd skills add`
- setup/other-agents.md：skills CLI、Kiro，以及制作方列出、但维护者还没有在当前版本上运行过的宿主
- setup/rolling-out.md：先加载哪些技能，新项目和老项目各怎么做

## 更新或卸载

README 和文档都没有给插件安装的卸载命令。Antigravity CLI 指南给了 `agy update`，用来更新 CLI 或检查插件新版本。Command Code 的文档给的是：更新用 `cmd skills add addyosmani/agent-skills --force`，卸载一个技能用 `cmd skills remove spec-driven-development`，用户范围的技能再加 `--global`。手工复制的途径，更新就是再复制一遍，setup/cursor.md 里有示范。

## 数据

技能是你的智能体去读的 Markdown 文件。这些命令会让智能体动手：`/build` 和 `/test` 会运行你的测试套件，`/build` 还会运行构建并逐个任务提交；`/constraints` 会按你选的每个维度安装对应的检查工具，比如 Semgrep、gitleaks、osv-scanner、axe-core、Lighthouse、size-limit、dependency-cruiser 和 Stryker，在 package.json 里加上 `check:fast`、`check:task` 和 `check:full`，并在 CLAUDE.md 里加一行。`/webperf` 的 Deep 模式可以用一份 Lighthouse 报告或一份 CrUX API 的响应，后者需要 `CRUX_API_KEY` 或 `GOOGLE_API_KEY`。Gemini CLI 指南说它在启用匹配的技能前会先征求你的许可，Antigravity CLI 指南说它在执行技能前会提示你授权。README 和 Mindket 读过的文档都没有提到这套技能自己的服务器或遥测。skills CLI 和各个智能体有自己的设置。

## 报告问题

CONTRIBUTING.md 里有一节 Reporting Issues。它请你在某个技能给出错误或过时的指导时开一个 issue，并链接了一个 Skill gap 的 issue 表单：https://github.com/addyosmani/agent-skills/blob/main/CONTRIBUTING.md

## 来源

- README：https://github.com/addyosmani/agent-skills/blob/main/README.md
- 入门页：https://github.com/addyosmani/agent-skills/blob/main/docs/getting-started.md
- 采用指南：https://github.com/addyosmani/agent-skills/blob/main/docs/adoption-guide.md
- 智能体角色页：https://github.com/addyosmani/agent-skills/blob/main/docs/agents.md
- 其他宿主：https://github.com/addyosmani/agent-skills/blob/main/docs/other-hosts.md
- 技能结构：https://github.com/addyosmani/agent-skills/blob/main/docs/skill-anatomy.md
- using-agent-skills：https://github.com/addyosmani/agent-skills/blob/main/skills/using-agent-skills/SKILL.md
- LICENSE：https://github.com/addyosmani/agent-skills/blob/main/LICENSE

README.md  6 KB
setup/antigravity.md  3 KB
setup/claude-code.md  3 KB
setup/codex.md  2 KB
setup/command-code.md  2 KB
setup/cursor.md  3 KB
setup/gemini-cli.md  3 KB
setup/github-copilot.md  5 KB
setup/opencode.md  3 KB
setup/other-agents.md  4 KB
setup/rolling-out.md  4 KB
setup/windsurf.md  1 KB