addyosmani agent-skills

Agent Skills

面向 AI 编码代理的生产级工程技能。技能编码了资深工程师在构建软件时使用的工作流程、质量门禁和最佳实践。这些技能被打包，使 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

命令

8 个映射到开发生命周期的斜杠命令。每个命令自动激活相应的技能。

| 你正在做什么 | 命令 | 关键原则 | |---|---|---| | 定义要构建什么 | /spec | 先写规格，再写代码 | | 规划如何构建 | /plan | 小规模、原子化任务 | | 增量构建 | /build | 一次只做一个切片 | | 证明它能工作 | /test | 测试即证明 | | 合并前审查 | /review | 提升代码健康度 | | 审计 Web 性能 | /webperf | 先测量，再优化 | | 简化代码 | /code-simplify | 清晰胜过巧妙 | | 发布到生产环境 | /ship | 更快更安全 |

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

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

快速开始

最快路径——任何代理，一条命令。开源 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 # 红-绿-重构，强制执行

只安装一个技能？按技能执行的 npx 安装只复制 skills//，不会复制仓库级别的 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

如果在 Windows 或 macOS 上 /plugin install 仍然失败并显示 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 中——不要将完整技能粘贴到规则中。参见 docs/cursor-setup.md。

Antigravity CLI

作为原生插件安装技能、子代理和斜杠命令。参见 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

通过 AGENTS.md 和技能工具使用代理驱动的技能执行。参见 docs/opencode-setup.md。

GitHub Copilot

使用 agents/ 中的代理定义作为 Copilot 角色，并将技能内容放在 .github/copilot-instructions.md 中。参见 docs/copilot-setup.md。

Kiro IDE & CLI

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

Codex

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

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

第一条命令注册 marketplace；第二条命令安装插件。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。

其他代理

技能是平台无关的——它们只是带结构化 frontmatter 的 Markdown 文件。任何能读取 SKILL.md 文件的代理都可以使用它们。