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

Commands

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

| 你正在做什么 | 命令 | 核心原则 | |---|---|---| | 定义要构建什么 | /spec | 先写规格，再写代码 | | 规划如何构建 | /plan | 小而原子化的任务 | | 增量构建 | /build | 一次一个切片 | | 证明它能工作 | /test | 测试即证明 | | 设定质量标准 | /constraints | 一次决定，处处执行 | | 合并前审查 | /review | 改善代码健康度 | | 审计 Web 性能 | /webperf | 先测量，再优化 | | 简化代码 | /code-simplify | 清晰胜于聪明 | | 发布到生产环境 | /ship | 更快即更安全 |

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

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

Quick Start

最快的方式——任何代理，一条命令。开放的 skills CLI 可安装到 70 多个代理中（Claude Code、Cursor、Codex、Copilot、Cline 等）：

npx skills add addyosmani/agent-skills              # install all 25 skills
npx skills add addyosmani/agent-skills --list       # browse before installing

或者获取单个技能：

npx skills add addyosmani/agent-skills --skill code-review-and-quality   # five-axis review before merge
npx skills add addyosmani/agent-skills --skill interview-me              # requirements interrogation, one question at a time
npx skills add addyosmani/agent-skills --skill test-driven-development   # red-green-refactor, enforced

只安装一个技能？按技能执行 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

如果 /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 中——不要将完整技能粘贴到规则中。参见 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，并使用内置的 skill 工具进行代理驱动的执行。可选的斜杠命令可以添加到 .opencode/commands/ 下。参见 docs/opencode-setup.md。

GitHub Copilot

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

使用独立的 copilot CLI？将其作为插件安装——参见 docs/copilot-cli-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 克隆