夜雨聆风AI 写代码很快，但它总是走最短路径——跳过规格、跳过测试、跳过安全审查，写出来的东西"看着对"却经不起生产环境 review。今天介绍的这个开源项目，专门治这个病。
本文导览
一、翻车现场：AI 助手的"最短路径"陷阱
用过 Claude Code、Cursor、Copilot 的人，大概率都遇到过这种场面：
这正是 Addy Osmani 在项目 README 里点出的问题——AI agent 默认走最短路径。而资深工程师工作中真正值钱的部分，恰恰是那些不出现在 diff 里的工作：写 spec、拆任务、先写测试、做 code review、控制变更范围。
二、agent-skills 是什么
一句话定位：给 AI 编码 Agent 装上"资深工程师纪律"的生产级工程能力库。
它不是一个新的 IDE，也不是一个模型，更不是一组 Prompt 模板。它更像是给 AI 编码助手准备的一套"工程作业指导书"——把结构化的工程流程以 Markdown 文件的形式提供给 Agent，Agent 在处理对应任务时读取这些文件，按照其中定义的步骤和检查点执行，而不是凭直觉走最短路径。
三、作者：Addy Osmani 是谁
这个项目能在一周内涨到 76k+ Star、日增约 2.6k，跟作者本人在工程圈的号召力分不开。但更值得关注的是它代表的一个变化：AI 编码工具正在从"补全代码片段"，转向"带着工程规范、检查清单和执行流程来协作"。
四、六阶段生命周期 + 8 个命令
Agent Skills 把开发过程拆成六个阶段，每个阶段对应一组 skill，用户通过 slash command 触发对应流程：
DEFINE PLAN BUILD VERIFY REVIEW SHIP ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ Idea │ ───▶ │ Spec │ ───▶ │ Code │ ───▶ │ Test │ ───▶ │ QA │ ───▶ │ Go │ │Refine│ │ PRD │ │ Impl │ │Debug │ │ Gate │ │ Live │ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ /spec /plan /build /test /review /ship
技能还会根据你的实际任务自动激活——比如设计 API 会触发 api-and-interface-design，构建 UI 会触发 frontend-ui-engineering。
五、全部 24 个技能一览
官方 README 当前列出 24 个技能（1 个元技能 + 23 个生命周期技能），覆盖从需求澄清到上线的全流程：
Define · 定义阶段
Plan · 规划阶段
Build · 构建阶段
Verify · 验证阶段
Review · 审查阶段
Ship · 发布阶段
六、三个设计亮点：为什么它不是 Prompt 合集
① 是流程，不是散文
技能是代理遵循的工作流，不是参考文档。每个都有步骤、检查点和退出标准。Agent 不是"读一读参考"，而是"照着走"。
② 反合理化表（Anti-Rationalization）
每个技能都包含一个常见借口表格及有据可查的反驳论点。专门对付 Agent 找借口跳过步骤：
"我以后再加测试"
→ 没有测试的代码就是未完成的工作。"以后"永远不会来。
"这个改动很小，不需要 spec"
→ 小改动也需要明确边界。没有 spec 就没有"完成"的定义。
"看起来能跑就行"
→ "Seems right" 永远不够。每个技能都以证据要求结束——测试通过、构建输出、运行时数据。
③ 验证不可妥协
每个技能都以证据要求结束——测试通过、构建输出、运行时数据。"看起来对"永远不够。这是它和普通 Prompt 库最本质的区别。
七、4 个专家角色 + 7 个参考清单
4 个预配置专家角色
7 个参考检查清单
技能在需要时才加载这些清单（渐进式披露），保持 token 使用最小化。
八、怎么装：5 分钟接入你的工具
通用快速安装（兼容 70+ 种代理）
# 装全部 24 个技能
npx skills add addyosmani/agent-skills
# 安装前先浏览
npx skills add addyosmani/agent-skills --list
# 只装单个技能
npx skills add addyosmani/agent-skills --skill test-driven-development
npx skills add addyosmani/agent-skills --skill code-review-and-quality
npx skills add addyosmani/agent-skills --skill interview-me注意：单个技能安装时仅复制
skills/<name>/，不包含仓库级references/目录。技能仍可工作，但补充共享检查清单的路径不可用。
Claude Code（推荐）
# Marketplace 安装
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
# 本地 / 开发模式
git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills遇到 SSH 权限问题，用完整 HTTPS URL：/plugin marketplace add https://github.com/addyosmani/agent-skills.git
Cursor
把工作流技能放在 .cursor/skills/（从 agent-skills/skills/ 同步），把简短策略放在 .cursor/rules/*.mdc——不要把完整技能粘贴到规则里。
Codex（v0.122+）
codex plugin marketplace add addyosmani/agent-skills安装后用 @ 调用技能，例如 @spec-driven-development。
Gemini CLI
# 从仓库安装
gemini skills install https://github.com/addyosmani/agent-skills.git --path skills
# 从本地克隆安装
gemini skills install ./agent-skills/skills/GitHub Copilot / Windsurf / 其他
Copilot：用 agents/ 作为角色，技能内容放 .github/copilot-instructions.md。Windsurf：加入 rules 配置。其他工具同理——技能是纯 Markdown，适用于任何接受系统提示或指令文件的代理。
九、嵌入的 Google 工程文化
这些技能吸收了不少 Google 工程文化里的硬核概念，不是抽象原则，而是直接嵌入到 AI 要跟着走的步骤里：
十、该不该用？谁该用？
另外，项目官方提供了与 Superpowers 和 Matt Pocock's skills 的诚实对比（docs/comparison.md），包括一个受控的对比实验链接，值得先看看再决定用哪个。
过去十年，"资深"约等于"会写复杂代码"。但当代码本身越来越便宜，资深的真正价值就剩下了那些不出现在 diff 里的部分。agent-skills 把这些不可见的工作变成了 agent 必经的工作流——它是一份"AI 时代下，好工程师怎么工作"的活规范。
本文基于 Addy Osmani 的 agent-skills 项目（MIT 协议）官方文档整理
作者：Addy Osmani · 协作者：Federico Bartoli、Joan León
项目地址：github.com/addyosmani/agent-skills