Skill 说明
agent-skills 是什么
agent-skills 是一套面向 AI 编码 Agent 的「生产级工程技能」,由 Addy Osmani 开源。它把资深工程师实际在用的工作流、质量关卡和最佳实践打包成技能,让 Agent 在开发的每个阶段都按同一套规矩走,而不是每次自由发挥。
整个体系是一条六阶段流水线:定义 → 规划 → 构建 → 验证 → 评审 → 上线。每个阶段对应一个斜杠命令,命令会自动激活该阶段该用的技能。除了手动敲命令,技能也会按你正在做的事自动触发——设计 API 会拉起 api-and-interface-design,写界面会拉起 frontend-ui-engineering。
| 命令 | 你在做什么 | 关键原则 |
|---|---|---|
/spec | 定义要建什么 | 规格先于代码 |
/plan | 规划怎么建 | 小而原子化的任务 |
/build | 增量构建 | 一次只做一片 |
/test | 证明它确实能用 | 测试就是证据 |
/constraints | 设定质量线 | 决策一次,处处执行 |
/review | 合并前评审 | 提升代码健康度 |
/webperf | 审计网页性能 | 先测量再优化 |
/code-simplify | 简化代码 | 清晰优先于聪明 |
/ship | 发布到生产 | 更快才更安全 |
还提供一个 /build auto:规格写完后一次性批准计划,它会自动生成计划并逐个实现所有任务。它省掉的是人在任务之间来回切换,不是验证——每个任务仍然是测试驱动、单独提交,遇到失败或高风险步骤会停下来。
agent-skills 怎么安装
最快的方式是用开源的 skills CLI,它支持 70 多个 Agent(Claude Code、Cursor、Codex、Copilot、Cline 等):
npx skills add addyosmani/agent-skills # 装全部 25 个技能
npx skills add addyosmani/agent-skills --list # 先浏览有哪些
npx skills add addyosmani/agent-skills --skill code-review-and-quality
Claude Code 可以走插件市场:
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
如果走市场时遇到 SSH 报错(git@github.com: Permission denied (publickey)),可以改用完整 HTTPS 地址添加,或一次性把 GitHub 的 SSH 地址重写成 HTTPS:
git config --global url."https://github.com/".insteadOf git@github.com:
注意一个已知限制:如果只单装某一个技能(--skill <name>),CLI 只复制 skills/<name>/,不会带仓库级的 references/ 目录。技能本身还能跑,但里面指向共享检查清单的路径会失效,需要整仓安装、克隆仓库,或手动把清单复制进去。
agent-skills 怎么使用
- 装好后照常写代码,需要哪个阶段就敲对应命令,比如先
/spec把需求写成规格,再/plan拆成任务。 - 在 Claude Code 里,如果内置命令同名(例如
/review),用带命名空间的形式调用:/agent-skills:review。 - 规格写完后想少点人工步骤,用
/build auto一次批准跑完;它会逐任务测试驱动并单独提交,失败或高风险处暂停等你。 - 质量线用
/constraints定一次,之后所有改动都按这条线检查,不用每次重复交代。 - 很多技能会自动激活,不必刻意调用——你只要专心动手上做的事。
agent-skills 适合谁用
- 日常用 Claude Code、Cursor、Codex、Copilot 写项目的开发者,想让 Agent 的输出稳定在可评审、可上线的水准。
- 团队想在多人多 Agent 协作下统一质量线和评审标准。
- 厌倦了每次新开会话都要重新教一遍工程规范的人。
- 需要「先出规格再动手」这种纪律约束的复杂项目。
- 只想让 AI 补几行代码片段、不需要完整工程流程的场景,用不上这套东西。
agent-skills 项目地址
- GitHub 仓库:https://github.com/addyosmani/agent-skills
- 技能介绍页:https://skills.addy.ie
- skills CLI:https://github.com/vercel-labs/skills
- Cursor 配置说明:https://github.com/addyosmani/agent-skills/blob/main/docs/cursor-setup.md
- 已知问题(单技能安装):https://github.com/addyosmani/agent-skills/issues/361