addyosmani/agent-skills：给 AI 编码 Agent 准备的工程技能包

addyosmani/agent-skills 把工程流程结构化——先明确目标，再拆任务、小步实现，最后用测试、审查和发布检查证明结果可靠。

agent-skills 是什么？

addyosmani/agent-skills 是一组面向 AI 编码 Agent 的工程技能和命令，把需求定义、计划、实现、测试、审查和发布拆成可复用工作流，让 Agent 更接近真实工程团队的工作节奏。

项目地址：github.com/addyosmani/agent-skills

它解决什么问题

AI 编码工具常见的问题不是完全不会写代码，而是容易跳过工程步骤：

• 需求还没说清楚，就开始写代码。
• 没有计划，直接改一大堆文件。
• 实现完不验证，只凭感觉认为可用。
• 不做代码审查，留下复杂度和安全隐患。
• 发布前没有检查清单，也没有回滚方案。

agent-skills 的思路，是把这些步骤做成显式工作流。Agent 不只是回答问题，而是在 /spec、/plan、/build、/test、/review、/ship 等阶段里执行不同技能。

七个命令对应开发生命周期

项目提供 7 个 slash commands，对应软件开发主要阶段：

这套设计的价值在于给 Agent 建立「阶段感」。写代码不是唯一动作，明确需求、拆任务、验证、审查和发布同样重要。

技能覆盖范围

README 提到该包包含 24 个技能，其中包括 23 个生命周期技能和一个 using-agent-skills 元技能。

覆盖范围大致包括：

• 需求访谈和想法细化。
• Spec 驱动开发。
• 计划与任务拆分。
• 增量实现。
• 测试驱动开发。
• 上下文工程。
• 源码驱动开发。
• 怀疑驱动开发。
• 前端 UI 工程。
• API 和接口设计。
• 浏览器调试。
• 错误恢复。
• 代码审查。
• 代码简化。
• 安全加固。
• 性能优化。
• Git 工作流。
• CI/CD 和自动化。
• 迁移与废弃。
• 文档和 ADR。
• 可观测性。
• 发布和上线。

它还提供一些 Agent personas，例如 code reviewer、test engineer、security auditor、web performance auditor，用于从不同专业视角审查工作。

和普通提示词有什么区别

普通提示词通常是一次性描述，例如「请认真写代码」「请加测试」「请像高级工程师一样审查」。这类提示有用，但不够稳定。

agent-skills 更像把工程方法沉淀成可执行流程：

• 每个技能有步骤。
• 每个阶段有质量门槛。
• 过程里有常见偷懒理由和反驳。
• 结束时需要证据，例如测试通过、构建结果、运行时数据。
• 支持渐进式加载，避免一次把所有背景塞进上下文。

对 AI Agent 来说，问题往往不是不知道「最佳实践」，而是在压力下会省略它们。把最佳实践变成检查点，比只写一句「请遵守最佳实践」更可靠。

适合哪些人

这个项目适合已经认真使用 AI 编码工具的人，尤其是希望 Agent 不只是写代码，而是参与完整工程流程的人。

适合场景包括：

• 新功能从需求到发布的完整流程。
• 多文件改动，需要拆成小任务。
• 前端页面、API、后端逻辑等跨模块实现。
• 希望 Agent 先写 spec 和 plan，再开始改代码。
• 想让 Agent 做代码审查、安全检查或性能检查。
• 团队希望统一 AI 编码助手的工作方式。

如果只是问一个很小的语法问题，这套技能包可能显得重。但如果让 AI 长时间参与真实项目，它的价值会更明显。

支持哪些工具

README 列出多个接入方式，包括：

• Claude Code。
• Cursor。
• Antigravity CLI。
• Gemini CLI。
• Windsurf。
• OpenCode。
• GitHub Copilot。
• Kiro。
• Codex。
• 其他支持规则文件或技能目录的 Agent。

Claude Code 可通过 marketplace 安装：

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

也可以本地克隆后指定插件目录：

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

Gemini CLI 示例：

gemini skills install https://github.com/addyosmani/agent-skills.git --path skills

对 Codex 或其他 Agent 来说，这些技能本质上是 Markdown 指令文件。只要工具支持系统提示、规则文件或技能目录，就可以参考使用。

使用注意点

这类技能包的价值是规范 Agent，但它不能代替你理解项目。使用时建议：

1. 不要一次把所有技能都塞进上下文。
2. 让元技能或当前任务决定该用哪个技能。
3. 对高风险改动，优先使用 spec、plan、test、review 组合。
4. 对前端和安全相关任务，单独调用 UI、security、performance 相关技能。
5. 不要让 Agent 只输出计划，真正修改代码时仍要跑测试或构建。

技能不是魔法，更像一套工作纪律：让 Agent 少跳步、少自我合理化、少在没有证据时宣布完成。

推荐使用方式

可以把它当成一套 AI 工程流程：

1. 用 /spec 明确目标、范围和验收标准。
2. 用 /plan 拆成可执行的小任务。
3. 用 /build 小步实现，避免一次改太多。
4. 用 /test 收集证据。
5. 用 /review 检查复杂度、安全、可维护性和回归风险。
6. 必要时用 /code-simplify 降低复杂度。
7. 用 /ship 做发布前检查。

这比「让 AI 从头写到尾」更容易控制质量。

总结

addyosmani/agent-skills 的价值不在于提供更多提示词，而在于把工程流程结构化。它让 AI 编码 Agent 在真实项目中更少跳步：先明确目标，再拆任务，再小步实现，最后用测试、审查和发布检查证明结果可靠。

如果你已经在用 Claude Code、Codex、Cursor、Gemini CLI 或类似工具做真实项目，这个仓库值得研究。