Agent Skills 是 Google Cloud AI Director Addy Osmani 在 2026 年 4 月初 发布到 GitHub 的开源项目。

• 项目热度：到 2026 年 4 月 23 日，这个仓库在不到三周时间里已经拿到约 21.4k stars 和 2.6k forks。
• 当前版本：最新 release 为 0.5.0，发布时间是 2026-04-10。
• 开源地址：github.com/addyosmani/agent-skills

项目的定位是 面向 AI coding agent 的生产级工程技能库。它把软件工程中的工作流、质量门禁和最佳实践，整理成一组可以被 agent 直接执行的 skill，让 agent 在不同开发阶段按一致方式工作。整个流程划分为六个阶段：Define、Plan、Build、Verify、Review、Ship。

命令层设计

项目提供 7 个与开发流程对应的命令：

系统也会根据当前任务类型自动激活相关 skill，例如设计 API 时触发 api-and-interface-design，构建前端界面时触发 frontend-ui-engineering。

核心技能库

仓库包含 20 个核心 skill，按开发生命周期组织。每个 skill 都对应一个明确的工程动作，目标不是提供泛化建议，而是约束 Agent 在特定阶段采用可验证、可回滚、可审查的工作方式。

Define（定义）

• idea-refine：通过发散、收敛与假设验证，将模糊想法转化为明确的问题定义、目标用户、MVP 范围和不做事项。
• spec-driven-development：在编码前建立规格说明，明确目标、边界、技术约束、验收标准和测试方式，避免 Agent 基于隐含假设直接实现。

Plan（计划）

• planning-and-task-breakdown：将规格拆解为小型、可排序、可验证的任务单元，明确依赖、验收条件和检查点，降低大任务失控风险。

Build（构建）

• incremental-implementation：以薄切片方式逐步交付，每个增量都需实现、测试、验证后再扩展，保持系统始终处于可工作状态。
• test-driven-development：以失败测试定义预期行为，再实现使其通过；修复 bug 时先复现再修复，将测试作为完成证据。
• context-engineering：按任务阶段裁剪上下文，控制 Agent 看到的信息范围与顺序，减少幻觉、遗漏和无关上下文干扰。
• source-driven-development：对框架和库相关实现优先查证官方文档，基于当前版本和权威来源决策，避免使用过时或臆测模式。
• frontend-ui-engineering：面向生产级 UI 构建组件、状态、响应式、可访问性和交互细节，避免默认化、模板化的 AI 界面输出。
• api-and-interface-design：以契约优先设计 API、模块边界和公共接口，关注输入输出、错误语义、兼容性和可扩展性，降低误用成本。

Verify（验证）

• browser-testing-with-devtools：通过真实浏览器运行时数据验证 UI，包括 DOM、控制台、网络请求、截图、性能和可访问性，而非依赖静态推断。
• debugging-and-error-recovery：按复现、定位、缩小范围、修复和防回归的顺序排障，避免基于猜测连续改动。

Review（审查）

• code-review-and-quality：从正确性、可读性、架构、安全和性能等维度审查变更，确认代码整体健康度提升后再合并。
• code-simplification：在行为不变的前提下降低复杂度，以理解成本而非行数作为简化标准，并控制重构范围。
• security-and-hardening：将不可信输入、认证授权、敏感数据、依赖、密钥和外部集成纳入默认安全约束。
• performance-optimization：先测量再优化，通过指标、profiling 和瓶颈定位驱动改动，避免无证据的提前优化。

Ship（发布）

• git-workflow-and-versioning：通过短分支、原子提交、清晰提交信息和保存点管理变更，使 Agent 产出保持可审查、可追踪、可回滚。
• ci-cd-and-automation：用自动化流水线执行 lint、类型检查、测试、构建、安全扫描和部署门禁，将质量控制前移。
• deprecation-and-migration：将废弃、迁移和删除旧系统作为正式流程处理，要求替代方案、迁移路径、使用量验证和最终清理。
• documentation-and-adrs：记录架构决策、约束、权衡和替代方案，补足代码无法表达的背景与原因。
• shipping-and-launch：通过上线清单、灰度发布、feature flag、监控和回滚预案完成发布，确保变更可观察、可逆、可分阶段推进。

整个 skill 的特点是把先想清楚再动手写成了明确规则，并把假设暴露、边界约束、阶段审查和可验证交付都前置到了编码之前。

例如 spec-driven-development 这个 skill，其明确禁止 agent 在需求模糊时直接进入编码，而是先把任务整理成一份结构化 spec。这个 spec 不只是功能说明，还必须覆盖目标、执行命令、项目结构、代码风格、测试策略、边界和成功标准；对于不明确的地方，agent 需要先显式列出自己的假设，而不是默认补全。规则还要求把模糊表述改写成可验证的成功条件，并通过 Specify → Plan → Tasks → Implement 四个阶段推进：先确认规格，再生成技术方案，再拆成带验收条件和验证方式的任务，最后才进入实现。

项目支持 Claude Code、Cursor、Gemini CLI、Windsurf、OpenCode、GitHub Copilot 等工具；本质上它是一组 Markdown skill 文件，因此任何支持规则文件、系统提示或 instruction file 的 agent 工具都可以接入。大家快去上手试试吧！