addyosmani/agent-skills · 上手攻略

• 仓库：addyosmani/agent-skills
• 链接：https://github.com/addyosmani/agent-skills
• 分类：AI/Agent · Dev Tools
• 作者：Tom
• 更新：2026-08-05

这是什么

addyosmani/agent-skills 是 Google Chrome 工程总监 Addy Osmani 主导维护的生产级 AI 编码 Agent 工程技能包。它将资深工程师在软件开发全生命周期中的工作流程、质量门禁和最佳实践封装为可被 AI Agent 理解并一致执行的 Markdown 技能文件（.md）。

该仓库提供 24 个结构化技能，覆盖从"定义要做什么"到"发布上线"的完整开发周期。每个技能包含：步骤清单（steps）、验证门禁（verification gates）和反理性化表（anti-rationalization tables，防止 Agent 在证据不足时仍然自信推进）。同时提供 8 个斜杠命令（/spec、/plan、/build、/test、/review、/webperf、/code-simplify、/ship），分别对应开发生命周期的关键节点。

一句话定位：让 AI Agent 的工程输出从"能跑但不经审视"进化到"有节奏、有门禁、可复用"。

解决什么问题

AI 编码 Agent 擅长生成代码，但缺乏： - 一致的开发节奏：今天按这个顺序做，明天换另一个顺序，不形成习惯。 - 质量门禁：不会主动在写完代码后跑测试、做 code review、量性能指标。 - 工程纪律：遇到不确定的地方倾向于"先跑起来再说"，而不是停下来核实。

addyosmani/agent-skills 通过把资深工程师的工作流程结构化为技能文件，让 Agent 在每一步都执行预期的验证动作，而非靠"感觉"决定是否继续。

快速安装

⚠️ 前提：Node.js 18+（用于 skills CLI）；各 Agent 工具（Claude Code / Cursor / Codex 等）需单独安装

方式一：skills CLI（推荐，最快）

支持 Claude Code、Cursor、Codex、Copilot、Cline 等 70+ Agent。

# 安装全部 24 个技能
npx skills add addyosmani/agent-skills

# 先浏览再决定安装
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 test-driven-development
npx skills add addyosmani/agent-skills --skill interview-me

方式二：Claude Code Marketplace

# Marketplace 安装
/claude
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

# 如遇 SSH 错误，改用 HTTPS：
/plugin marketplace add https://github.com/addyosmani/agent-skills.git

# Windows/macOS 永久修复 SSH→HTTPS 改写：
git config --global url."https://github.com/".insteadOf git@github.com:

方式三：Codex CLI

# Codex CLI v0.122+ 原生插件
codex plugin marketplace add addyosmani/agent-skills
# 在对话中用 @ 引用技能，如 @spec-driven-development

方式四：本地克隆

git clone https://github.com/addyosmani/agent-skills.git
# 根据你的 Agent 类型参考对应文档：
# docs/codex-setup.md
# docs/cursor-setup.md
# docs/copilot-setup.md
# docs/gemini-cli-setup.md
# docs/windsurf-setup.md
# docs/opencode-setup.md
# docs/antigravity-setup.md

核心用法

斜杠命令速查

自动化触发

技能支持按上下文自动激活，无需手动调用： - 当对话涉及 API 设计 → 自动触发 api-and-interface-design - 当涉及前端 UI 构建 → 自动触发 frontend-ui-engineering - 当涉及测试 → 自动触发 test-driven-development

/build auto 模式

# 在 Claude Code 中
/build auto
# Agent 自动：生成计划 → 实现每个任务 → 逐个跑测试并提交
# 遇到失败或风险步骤会暂停等待人工确认

增量采纳（适合已有项目）

# 不是所有技能都要一次装完
# 从 review 和 test 开始，再逐步引入 plan、build
npx skills add addyosmani/agent-skills --skill code-review-and-quality
npx skills add addyosmani/agent-skills --skill test-driven-development

典型适用场景

• 团队引入 AI 编码 Agent：需要统一工程纪律，防止 Agent 输出不一致或跳过关键验证步骤。
• Code Review 自动化：让 Agent 在每次 PR 前执行结构化 review，不遗漏安全/性能/可维护性等维度。
• TDD 落地：帮助不熟悉测试优先开发的团队，通过 Agent 强制执行 red-green-refactor 节奏。
• 多 Agent 协作规范：在团队有多人使用不同 Agent（Claude Code / Cursor / Codex）时，共享同一套技能定义保证输出质量基线一致。
• onboarding 新工程师：技能文件本身即是最佳实践文档，新人可以直接阅读 skills/ 目录理解团队开发规范。

坑与注意

1. 单独技能安装的路径问题：用 npx skills add ... --skill xxx 安装单个技能时，复制的是 skills/<name>/ 目录，但缺少 references/ 目录（存放共享清单），路径引用会失效。完整安装或手动复制 references/ 进去可解决。详见 issue #361。
2. SSH Key 要求：Claude Code Marketplace 安装依赖 SSH（git@github.com），无 SSH Key 的用户会遇到 Permission denied (publickey)，需先配置或强制 HTTPS 改写。
3. 不是所有 Agent 都支持所有功能：skills CLI 支持 70+ Agent，但部分技能（如 /webperf）依赖特定工具生态，在纯 CLI Agent 中可能降级。
4. 技能不等于知识：技能文件定义的是"流程和门禁"，不是"领域知识"——Agent 仍然需要正确的上下文（代码库状态、业务背景）才能正确执行。
5. /build auto 的自主性边界：虽然 /build auto 会自动运行任务链，但它在失败或高风险步骤时会暂停等人确认——不是完全无人值守，适合人在回路的工作流。
6. 版本同步：仓库活跃更新（Stars 81k+），建议定期 npx skills add addyosmani/agent-skills 更新技能版本，避免使用已废弃的步骤定义。

与同类对比

核心差异：大多数方案定义"做什么"，addyosmani/agent-skills 额外定义了"做到什么程度才允许继续"——质量门禁是它最独特的价值。

一句话推荐结论

如果你在团队里引入 AI 编码 Agent 但苦于输出质量参差不齐，addyosmani/agent-skills 是目前覆盖最完整、质量最高的生产级技能包——从 /spec 到 /ship 都有结构化门禁，值得作为团队 AI 工程规范的基础层。

原始 commit：https://github.com/addyosmani/agent-skills/commits/main 原始 issue/PR 链接：https://github.com/addyosmani/agent-skills/issues