addyosmani/agent-skills：AI 编程代理的生产级工程技能

面向 AI 编程代理（AI coding agents）的生产级工程技能。

技能（Skills）把资深工程师构建软件时使用的工作流、质量关卡和最佳实践编码下来。这些技能被打包，使 AI 代理在开发的每个阶段都能一致地遵循它们。

 DEFINE     PLAN      BUILD      VERIFY     REVIEW     SHIP
 ┌──────┐   ┌──────┐  ┌──────┐   ┌──────┐   ┌──────┐  ┌──────┐
 │ Idea │ ─▶│ Spec │ ─▶│ Code │ ─▶│ Test │ ─▶│  QA  │ ─▶│  Go  │
 │Refine│   │ PRD  │  │ Impl │   │Debug │   │ Gate │  │ Live │
 └──────┘   └──────┘  └──────┘   └──────┘   └──────┘  └──────┘
  /spec      /plan     /build     /test      /review    /ship

命令#

9 个映射到开发生命周期的斜杠命令。每个命令会自动激活正确的技能。

在 Claude Code 中，这些会作为插件命令安装。如果某个内置命令名称相同，例如 /review，请使用命名空间形式：/agent-skills:review。

规格存在后，想减少手动步骤？/build 会自动生成计划，并在一次获批的流程中实现每个任务——你批准一次计划，然后它自主运行。它移除的是任务之间的人工切换，而不是验证：每个任务仍然测试驱动、单独提交，并在失败或高风险步骤时暂停。

技能也会根据你正在做的事情自动激活——设计 API 会触发 api-and-interface-design，构建 UI 会触发 frontend-ui-engineering，等等。

快速开始#

最快路径——任何代理，一条命令。开放技能 CLI 可安装到 70 多个代理（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 # 合并前的五轴审查
npx skills add addyosmani/agent-skills --skill interview-me # 需求质询，一次一个问题
npx skills add addyosmani/agent-skills --skill test-driven-development # 红-绿-重构，强制执行

只安装一个技能？按技能执行 npx 安装只会复制 skills/<name>/，而不会复制仓库级的 references/ 目录。技能仍然可用，但指向补充共享检查清单的路径将不可用。请使用整仓集成、克隆仓库，或把所需的检查清单复制到已安装技能内的 references/ 目录。此可移植性缺口记录在 #361 中。

更喜欢原生集成？在下面选择你的工具。

Claude Code（推荐）#

Marketplace 安装：

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

SSH 错误？Marketplace 通过 SSH 克隆仓库。如果你没有在 GitHub 上设置 SSH 密钥，请添加 SSH 密钥，或在 marketplace-add 步骤中使用完整 HTTPS URL 强制通过 HTTPS 克隆：

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

如果 /plugin install 在 Windows 或 macOS 上仍因 git@github.com: Permission denied (publickey) 失败，推荐的解决方法是一次性配置 Git，为子进程克隆把 GitHub SSH URL 重写为 HTTPS：

git config --global url."https://github.com/".insteadOf git@github.com:

本地 / 开发：

git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills

Cursor#

把工作流技能放在 .cursor/skills/ 下（从 agent-skills/skills/ 同步），把简短策略放在 .cursor/rules/*.mdc 中——不要把完整技能粘贴到规则里。这两个目录都位于你的项目中；本仓库不附带 .cursor/ 文件夹。参见 docs/cursor-setup.md。

Antigravity CLI#

安装为原生插件，用于技能和子代理。在受影响的 Antigravity CLI 版本中，旧版命令 TOML 报告为已转换，但其包装命令无法被发现；请直接调用底层的命名空间技能。参见 docs/antigravity-setup.md。

从仓库安装：

agy plugin install https://github.com/addyosmani/agent-skills.git

从本地克隆安装：

git clone https://github.com/addyosmani/agent-skills.git
agy plugin install ./agent-skills

Gemini CLI#

安装为原生技能以自动发现，或添加到 GEMINI.md 以获得持久上下文。参见 docs/gemini-cli-setup.md。

从仓库安装：

gemini skills install https://github.com/addyosmani/agent-skills.git --path skills

从本地克隆安装：

gemini skills install ./agent-skills/skills/

Windsurf#

把技能内容添加到你的 Windsurf 规则配置中。参见 docs/windsurf-setup.md。

OpenCode#

把技能复制到 .opencode/skills/（或 ~/.config/opencode/skills/），添加项目本地的 AGENTS.md，并使用内置技能工具进行代理驱动执行。可选的斜杠命令可以添加到 .opencode/commands/ 下。参见 docs/opencode-setup.md。

GitHub Copilot#

使用 agents/ 中的代理定义作为 Copilot 角色，并使用 .github/copilot-instructions.md 中的技能内容。生命周期斜杠命令（/spec、/plan、/build、/test、/review、/ship）是 Claude Code 命令，不会出现在 Copilot 中；请改为按名称调用技能（/spec-driven-development 等）。参见 docs/copilot-setup.md。

使用独立 copilot CLI？把它安装为插件——参见 docs/copilot-cli-setup.md。

Kiro IDE 与 CLI#

Kiro 的技能位于 .kiro/skills/ 下，可以存储在项目级或全局级。Kiro 也支持 Agents.md。参见 https://kiro.dev/docs/skills/ 的 Kiro 文档。

Codex#

安装为原生 Codex 插件（Codex CLI v0.122+）：

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

第一条命令注册市场；第二条安装插件。Codex 通过 .codex-plugin/plugin.json 直接读取根 skills/ 目录。安装后，在聊天中使用 @ 调用技能（例如 @spec-driven-development）。有关本地安装和故障排除，参见 docs/codex-setup.md。

Command Code#

使用内置 cmd skills 命令原生安装。Command Code 会克隆仓库、发现每个 SKILL.md，并安装到 .commandcode/skills/：

cmd skills add addyosmani/agent-skills          # 选择要安装的技能（项目级）
cmd skills add addyosmani/agent-skills --global # 为所有项目安装（~/.commandcode/skills/）
cmd skills add addyosmani/agent-skills -s spec-driven-development # 安装特定技能

已安装的技能会显示在 TUI 斜杠菜单中，例如 /spec-driven-development。参见 docs/commandcode-setup.md。

其他代理#

技能就是纯 Markdown——它们适用于任何接受系统提示或指令文件的代理。参见 docs/getting-started.md。安装了该包但未在上方列出的宿主见 docs/other-hosts.md。

采用#

已经安装？如何推广这个包取决于你的代码库。采用指南涵盖两条路径：从第一天起为绿地项目使用完整生命周期，或对既有代码库进行增量式、验证优先的推广。

全部 25 个技能#

上面的命令是入口点。该包总共包含 25 个技能——24 个生命周期技能加上 using-agent-skills 元技能。每个技能都是一个结构化工作流，包含步骤、验证关卡和反合理化表格。你也可以直接引用任何技能。

元技能——发现哪个技能适用#

定义——明确要构建什么#

规划——拆解任务#

构建——编写代码#

验证——证明它有效#

审查——合并前的质量关卡#

发布——有把握地部署#

代理角色#

为定向审查预配置的专家角色：

有关决策矩阵、编排规则，以及角色如何与技能和斜杠命令组合，参见 docs/agents.md。

参考检查清单#

技能在需要时引入的快速参考资料：

技能如何工作#

每个技能都遵循一致的结构：

┌─────────────────────────────────────────────────┐
│ SKILL.md                                         │
│                                                  │
│  ┌─ Frontmatter ─────────────────────────────┐  │
│  │ name: lowercase-hyphen-name                │  │
│  │ description: Guides agents through [task]. │  │
│  │ Use when…                                  │  │
│  └────────────────────────────────────────────┘  │
│  Overview       → 这个技能做什么                  │
│  When to Use    → 触发条件                        │
│  Process        → 逐步工作流                      │
│  Rationalizations → 借口 + 反驳                   │
│  Red Flags      → 出问题的迹象                    │
│  Verification   → 证据要求                        │
└─────────────────────────────────────────────────┘

关键设计选择：

• 流程，而非散文。 技能是代理遵循的工作流，而不是供其阅读的参考文档。每个技能都有步骤、检查点和退出标准。
• 反合理化。 每个技能都包含一张常见借口表（例如“我稍后补测试”），并附有有据可查的反驳。
• 验证不可协商。 每个技能都以证据要求结束——测试通过、构建输出、运行时数据。“看起来没问题”永远不够。
• 渐进式披露。 SKILL.md 是入口点。支持性参考资料仅在需要时加载，从而将 token 使用降到最低。

项目结构#

可移植核心保留在共享目录中。宿主特定路径是原生发现约定，而不是品牌别名；重命名或合并它们会破坏扫描这些确切位置的工具。

没有签入适配器目录的工具，会把共享的 skills/ 核心安装或复制到自己的原生位置。快速开始部分链接了每个受支持宿主的设置指南。

为什么需要 Agent Skills？#

AI 编程代理默认走最短路径——这通常意味着跳过规格、测试、安全审查以及让软件可靠的实践。Agent Skills 为代理提供结构化工作流，强制执行资深工程师在生产代码中带来的同等纪律。

每个技能都编码了来之不易的工程判断：何时写规格、测试什么、如何审查、何时发布。这些不是通用提示——它们是那种有主见、流程驱动的工作流，把生产质量的工作与原型质量的工作区分开来。

技能融入了 Google 工程文化的最佳实践——包括来自《Software Engineering at Google》和 Google 工程实践指南的概念。你会在 API 设计中发现 Hyrum 定律，在测试中发现 Beyonce 规则和测试金字塔，在代码审查中发现变更规模与审查速度规范，在简化中发现切斯特顿栅栏，在 Git 工作流中发现主干开发，在 CI/CD 中发现左移和功能开关，以及一个专门的弃用技能，把代码视为负债。这些不是抽象原则——它们直接被嵌入代理遵循的逐步工作流中。

与其他方案比较#

想知道这与 Superpowers 或 Matt Pocock 的技能相比如何？参见 docs/comparison.md，以诚实、并排的方式了解三者的不同形态以及何时使用哪一个——其中包括一个受控头对头实验的链接。

贡献#

技能应当具体（可操作步骤，而非模糊建议）、可验证（有明确退出标准和证据要求）、经过实战检验（基于真实工作流）且最小化（只包含指导代理所需的内容）。

格式规范参见 docs/skill-anatomy.md，指南参见 CONTRIBUTING.md，关于如何在不破坏可移植 SKILL.md 前言的情况下应用模型路由、工具限制和其他按代理运行时控制，参见 docs/advanced-per-agent-configuration.md。

团队#

agent-skills 由以下人员构建和维护：

许可证#

MIT——可在你的项目、团队和工具中使用这些技能。