Agent Skills 是一套面向 AI 编码智能体的生产级工程技能。它将资深工程师在开发软件时使用的工作流、质量门禁和最佳实践打包成结构化技能，让 AI 智能体在开发的每个阶段都能一致地遵循这些规范。
它解决什么问题
AI 编码智能体默认会走最短路径，常常跳过规格说明、测试、安全审查等环节，导致产出质量停留在原型水平。Agent Skills 通过强制性的流程和验证门禁，让智能体像资深工程师一样工作：先定义再计划，先测试再交付。
主要能力
项目提供 8 个斜杠命令，对应开发生命周期的不同阶段：
| 当前任务 | 命令 | 核心原则 |
| --- | --- | --- |
| 定义要构建什么 | /spec | 先写规格再写代码 |
| 规划实现方式 | /plan | 小步原子任务 |
| 增量构建 | /build | 一次一个切片 |
| 证明它能工作 | /test | 测试即证据 |
| 合并前审查 | /review | 改善代码健康度 |
| 审计 Web 性能 | /webperf | 先测量再优化 |
| 简化代码 | /code-simplify | 清晰优于取巧 |
| 发布到生产 | /ship | 更快更安全 |
当规格确定后，/build auto 可以自动生成计划并实施所有任务，只要求人工审批一次计划，之后自动运行，但每个任务仍然是测试驱动并单独提交，遇到失败或风险步骤会暂停。
除了斜杠命令，技能也会根据当前工作自动触发，例如设计 API 时触发 api-and-interface-design，构建 UI 时触发 frontend-ui-engineering。
整个包共包含 24 个技能（23 个生命周期技能加 1 个元技能），每个技能都是结构化工作流，包含步骤、验证门禁和反合理化表格。项目还提供了 4 个专家人设（如代码审查员、安全审计员）和 7 个参考清单。
如何安装使用
最快的路径是使用开源 skills CLI，支持 70+ 智能体（Claude Code、Cursor、Codex、Copilot、Cline 等）：
npx skills add addyosmani/agent-skills # 安装全部 24 个技能
npx skills add addyosmani/agent-skills --list # 安装前浏览
或者只安装单个技能：
npx skills add addyosmani/agent-skills --skill code-review-and-quality # 合并前五维审查
npx skills add addyosmani/agent-skills --skill interview-me # 逐个问题的需求盘问
npx skills add addyosmani/agent-skills --skill test-driven-development # 强制红-绿-重构
Claude Code 推荐使用市场安装：
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
如果遇到 SSH 错误，可以配置 Git 重写 URL：
git config --global url."https://github.com/".insteadOf git@github.com:
其他工具（Cursor、Antigravity、Gemini CLI、Codex、Command Code 等）的安装方式详见项目文档。技能的格式是纯 Markdown，任何接受系统提示或指令文件的智能体都可以使用。
需要留意：如果只安装单个技能，npx 命令只复制 skills/<name>/ 目录，不包括仓库级的 references/ 目录。技能仍能工作，但引用共享清单的路径会不可用。解决办法是使用整仓集成、克隆仓库，或将需要的检查清单复制到已安装技能内的 references/ 目录。
技能设计特点
- 流程而非文章：技能是智能体遵循的工作流，有步骤、检查点和退出标准。
- 反合理化：每个技能都包含一个表格，列出智能体常用来跳过步骤的借口以及对应的反驳。
- 验证不可妥协：每个技能都以证据要求结束，例如测试通过、构建输出、运行时数据。「看起来没问题」永远不够。
- 渐进式披露：
SKILL.md是入口，相关参考资料仅在需要时加载，以控制 token 消耗。