Agent之Skills：addyosmani/agent-skills的简介、安装和使用方法、案例应用之详细攻略

从 README 的描述来看，这个项目的核心目标，是让 AI 代理在软件开发的各个阶段都遵守明确的工程纪律：先定义、再规划、再实现、再验证、再评审，最后再交付。仓库主页用一条生命周期图把这条路线写得非常清楚：DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP，对应 /spec、/plan、/build、/test、/review、/ship 等命令。

docs/getting-started.md 进一步说明，agent-skills 适用于任何接受 Markdown 指令的 AI coding agent；每个技能都是一个 SKILL.md 文件，里面写的是一个具体工程工作流，加载进上下文后，代理会按流程执行，而不是把它当参考文档随便浏览。

Github地址 ：GitHub - addyosmani/agent-skills: Production-grade engineering skills for AI coding agents. · GitHub

1、特点

|-----------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 把软件开发拆成标准化、可执行的技能 | 仓库把开发生命周期拆成 24 个技能，其中包括 23 个生命周期技能和 1 个元技能 using-agent-skills。每个技能都围绕一个明确的任务阶段设计，例如定义需求、任务拆解、增量实现、测试、评审、简化代码、发布上线。 |
| 强调"验证"而不是"感觉正确" | README 明确提出：测试结果、构建输出、运行时行为、人工复核等"具体证据"才算完成；"看起来对"并不够。docs/getting-started.md 也写到，技能包含 verification steps、exit criteria，以及反模式和红旗项。 |
| 内置"反合理化"机制 | 每个 skill 都带有 Common Rationalizations 和 Red Flags。README 说明，这些内容是为了阻止代理跳过规格、测试、评审等关键步骤，避免它用"这次太简单了""测试以后再补"等理由绕开流程。 |
| 支持渐进式加载，节省上下文 | 项目强调 Progressive disclosure 和 Context-aware loading：不要一开始把所有 skills 都塞进上下文，而是根据当前任务按需加载。README 和 getting-started 都明确提醒，更多上下文并不总是更好，应该只加载当前阶段相关的技能。 |
| 通过命令触发对应技能 | 仓库提供了 7 个核心 slash commands，把常见开发动作映射到对应技能：/spec、/plan、/build、/test、/review、/code-simplify、/ship。其中 /build auto 还能在一次批准后自动生成计划并执行全部任务，但仍然保留测试驱动和失败暂停机制。 |
| 支持不同 AI 工具链 | README 明确列出该仓库可与 Claude Code、Cursor、Antigravity CLI、Gemini CLI、Windsurf、OpenCode、GitHub Copilot、Kiro IDE & CLI、Codex / Other Agents 等工具配合使用；docs/getting-started.md 也说明它适用于任何支持 Markdown 指令的 agent。 |
| 带有专门的 agent persona 和参考清单 | 仓库的 agents/ 目录中提供了预配置角色，例如 code-reviewer.md、test-engineer.md、security-auditor.md、web-performance-auditor.md；references/ 目录则提供了测试、性能、安全、可访问性等补充清单。 |
| 强调工程纪律而不是抽象空话 | README 写得很直接：AI coding agents 天生倾向最短路径，因此容易跳过规格、测试、安全审查等环节；Agent Skills 的意义，就是把这些"真正让软件可靠"的实践固化成可重复执行的工作流。仓库还提到，它吸收了 Google 工程文化中的一些方法，例如 API 设计、测试金字塔、代码评审、trunk-based development、feature flags 等。 |

addyosmani/agent-skills的安装和使用方法

1、安装

1）通用使用方式

docs/getting-started.md 给出的通用流程非常清楚：先克隆仓库，再从 skills/ 目录中选择一个技能，然后把对应的 SKILL.md 内容加载到 agent 的 system prompt、rules file 或当前对话中。README 也强调，skills 本质上是 Markdown 文件，不依赖单一平台。

2）快速开始：克隆仓库

通用起步命令是：

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

克隆后，你就可以浏览 skills/ 目录，每个子目录都包含一个 SKILL.md。

2、使用方法

1）把技能加载到你的 agent

仓库建议三种加载方式：把 skill 内容贴到会话开始处的 system prompt；写入项目规则文件，例如 CLAUDE.md、.cursorrules 之类；或者在交互时直接引用该技能，并要求 agent 按它执行。

2）先加载元技能做路由

using-agent-skills 是入口型元技能。README 说明，它会把当前任务映射到最合适的技能；getting-started.md 也建议先加载它，再让它决定该启用哪条工作流。

3）Claude Code 的安装

README 给出 Claude Code 推荐安装方式：

/plugin marketplace add addyosmani/agent-skills

/plugin install agent-skills@addy-agent-skills

如果遇到 SSH 问题，还可以使用 HTTPS 方式安装，或先自行配置 GitHub SSH key。也支持本地 clone 后通过 claude --plugin-dir /path/to/agent-skills 使用。

4）其他平台的安装与接入

仓库还为不同工具提供了安装方式或接入方式，例如：Antigravity CLI 可以用 agy plugin install https://github.com/addyosmani/agent-skills.git；Gemini CLI 可以用 gemini skills install ... --path skills；Cursor 可将 SKILL.md 复制到 .cursor/rules/ 或引用整个 skills/ 目录；GitHub Copilot 可使用 agents/ 里的定义和 .github/copilot-instructions.md；Windsurf、OpenCode、Kiro 也都有对应的说明。

5）推荐的最小配置

docs/getting-started.md 给出"Minimal（Start here）"方案：在规则文件里先放三个核心技能，分别是 spec-driven-development、test-driven-development、code-review-and-quality。仓库认为这三项最能覆盖 AI 辅助开发中最关键的质量缺口。

6）按开发阶段加载技能

完整生命周期的推荐方式，是按阶段逐步加载：项目启动时用 spec-driven-development → planning-and-task-breakdown；开发时用 incremental-implementation + test-driven-development；合并前用 code-review-and-quality + security-and-hardening；发布前用 shipping-and-launch。

7）命令与技能的对应关系

README 和 getting-started.md 都给出了命令与技能的对应关系。比如 /spec 对应 spec-driven-development，/plan 对应 planning-and-task-breakdown，/build 对应 incremental-implementation + test-driven-development，/test 对应 test-driven-development，/review 对应 code-review-and-quality，/code-simplify 对应 code-simplification，/ship 对应 shipping-and-launch。

addyosmani/agent-skills的案例应用

1）新项目或新功能开发

仓库把 spec-driven-development 作为"开始一个项目、功能或重大变更"的首选技能；docs/getting-started.md 也建议任何非平凡工作都先从规格开始。这个场景很适合从需求定义、边界约束、代码风格和测试标准一开始就固定下来。

2）需求不清楚时的澄清式访谈

interview-me 技能被描述为"一次只问一个问题"的结构化访谈，目标是挖出用户真正想要的东西，直到代理对需求达到较高把握度。它适合需求模糊、表述不完整、容易误解的场景。

3）把一个大任务拆成可执行计划

planning-and-task-breakdown 的用途，是把规格拆成小而可验证的任务，并按依赖顺序排列。这非常适合已经拿到 PRD 或需求文档，但还不知道怎么落到工程实施的情况。

4）多文件改动的渐进式实现

incremental-implementation 适合任何"会碰到多个文件"的变更。仓库把它定义为"thin vertical slices"，即每次只实现、测试、验证并提交一小片功能，强调安全默认值、可回滚改动和特性开关。

5）代码写完后的验证与评审

test-driven-development、code-review-and-quality、security-and-hardening 这一类技能，分别用于证明实现有效、在合并前提升代码健康度、以及在发布前补足安全防线。README 明确把"验证"设成每条工作流的终点，不让"差不多"成为结束条件。

6）前端页面和 Web 应用优化

仓库专门列出 frontend-ui-engineering 和 web-performance-auditor。前者适合 UI 工作，后者是 web apps 专用的性能审计代理，并通过 /webperf 命令调用。由此可见，它对前端实现、性能检查、可访问性清单等场景都有明确支持。

7）调试与错误恢复

docs/getting-started.md 明确把 debugging-and-error-recovery 列为"当你在调试时应加载的技能"。这说明该项目并不只关注开发前期，也覆盖故障排查和错误恢复阶段。

8）CI/CD 与发布上线

仓库提到 ci-cd-and-automation 适合设置持续集成/持续交付，shipping-and-launch 适合发布前阶段；在 README 的生命周期图里，最后一步就是 SHIP。这说明它把"上线"视为一个单独阶段，而不是开发结束后的附属动作。

9）写文档、维护 ADR 和知识沉淀

仓库有专门的文档技能，例如 documentation-and-adrs，其验证项包括：重大架构决策都有 ADR、README 覆盖快速开始和命令、API 参数和返回值文档完整、常见坑点已就地说明等。这个场景很适合项目规范整理和知识沉淀。

10）把技能作为团队共享规范

docs/getting-started.md 说明，spec 和 plan 命令会生成 SPEC.md、tasks/plan.md、tasks/todo.md 这些"活文档"，建议在开发过程中纳入版本控制，作为人和代理共享的单一事实来源。对于团队协作、交接、评审，这一套尤其实用。