Agent Skills

为 AI 编程助手提供的生产级工程技能（Engineering Skills）。

这些技能库封装了资深工程师在软件开发中所采用的工作流、质量守门员（quality gates）及最佳实践。通过这些技能包，AI 智能体可以在开发的每一个阶段都始终如一地遵循这些标准。

---

命令（Commands）

7 个映射到开发生命周期的斜杠命令（Slash commands）。每一个命令都会自动激活相应的技能。

开发阶段	命令	核心原则
定义构建需求	/spec	先有规格，后有代码
规划构建方案	/plan	原子化小任务
增量构建	/build	每次只完成一个切片
验证实现	/test	测试即证明
合并前审查	/review	改善代码健康度
代码简化	/code-simplify	清晰优于巧妙
生产环境发布	/ship	快即是稳

技能也会根据你的操作自动激活——例如，设计 API 时会触发 api-and-interface-design，构建 UI 时会触发 frontend-ui-engineering，依此类推。

---

快速入门（Quick Start）

Claude Code (推荐)

通过 Marketplace 安装:

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

SSH 错误？ Marketplace 通过 SSH 克隆仓库。如果你的 GitHub 未配置 SSH 密钥，请添加 SSH 密钥，或者使用完整的 HTTPS URL 来强制使用 HTTPS 克隆：

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

本地 / 开发:

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

Cursor

将任意 SKILL.md 文件复制到 .cursor/rules/ 中，或引用整个 skills/ 目录。详见 docs/cursor-setup.md。

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 和 skill 工具使用智能体驱动的技能执行。

详见 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 / 其他智能体

技能以纯 Markdown 格式编写——它们适用于任何支持系统提示词（system prompts）或指令文件的智能体。详见 docs/getting-started.md。

---

全部 23 项技能

上述命令是入口点。该技能包总共包含 23 项技能——22 项生命周期技能加上 using-agent-skills 元技能。每项技能都是一个结构化的工作流，包含步骤、验证关卡（verification gates）以及反合理化表格（anti-rationalization tables）。你也可以直接引用任何一项技能。

元技能 (Meta) - 发现适用的技能

技能	功能	使用场景
using-agent-skills	将收到的工作映射到正确的工作流，并定义共享操作规则	开始会话时，或需要决定使用哪项技能时

定义 (Define) - 明确构建内容

技能	功能	使用场景
interview-me	逐一提问，挖掘用户真实需求（而非预期需求），直至达到约 95% 的确认度	需求未明确，或用户输入 "interview me" / "grill me" 时
idea-refine	通过结构化的发散/收敛思维，将模糊的想法转化为具体方案	当你有一个需要探索的初步概念时
spec-driven-development	在编写代码前，撰写包含目标、命令、结构、代码风格、测试及边界的 PRD	开始新项目、新特性或重大变更时

规划 (Plan) - 任务拆解

技能	功能	使用场景
planning-and-task-breakdown	将规格说明书拆解为具有验收标准和依赖顺序的小型可验证任务	当你已有规格说明书并需要实施时