引言“AI agents are only as good as the workflows they follow.”这是一天一个开源项目系列的第94篇文章。今天带你了解的项目是Agent Skills。如果说上一篇的Symphony解决了如何在规模上运行 AI 代理的问题那么Agent Skills解决的则是更基本的问题如何让一个 AI 编码助手真正具备一名高级工程师的工程素养这个项目来自 Google Chrome 的工程总监Addy Osmani——前端工程界的传奇人物《Learning JavaScript Design Patterns》的作者。他用一个简洁的洞察描述了 AI 工具的现状AI 会走捷径。它会跳过写 spec、跳过测试、跳过安全审查只要能交出一份看起来能运行的代码就算完成任务。而 Agent Skills 的使命就是通过 20 套精心设计的工作流从根本上改变这一现状。你将学到什么什么是结构化工作流它如何改变 AI 代理的行为模式Agent Skills 如何通过反理由化Anti-Rationalization设计消除常见的 AI 偷懒借口7 个 Slash Command 如何贯穿开发全生命周期如何在 Claude Code、Cursor 等主流工具中安装并使用与其他 AI 编码提升方案的对比前置知识日常使用过 Claude Code、Cursor 等 AI 编码工具对软件工程的基本流程需求 → 设计 → 编码 → 测试 → 上线有基本了解无需任何特定编程语言背景项目背景项目简介Agent Skills 是一个纯文本Markdown的工程工作流集合。它不是一个框架、不是一个 SDK而是一套可被 AI 工具直接加载的思维规程。当你在 Claude Code 或 Cursor 中加载这套技能后AI 不再会随意开始写代码——它会先问我们有 spec 吗任务分解了吗测试通过了吗核心理念来自 Google 内部的工程文化Hyrum’s Law接口的隐性依赖会被滥用、测试金字塔、主干开发Trunk-based Development以及最关键的——把代码视为负担而非资产。作者/团队介绍作者Addy Osmani身份Google Chrome 工程总监知名前端工程师代表作《Learning JavaScript Design Patterns》、Lighthouse 性能工具核心贡献者、众多前端最佳实践规范的奠基人创建动机在日常使用 AI 编码工具时Addy 发现 AI 会系统性地跳过麻烦但必要的工程步骤于是将他多年积累的工程规范编码成 AI 可直接执行的工作流项目数据⭐ GitHub Stars:30,800 Forks:3,600 Watchers:219 Commits:162 License: MIT 仓库: addyosmani/agent-skills主要功能核心作用Agent Skills 的核心价值在于把隐性的工程纪律变成显性的、AI 可执行的步骤清单。一个普通的 AI 助手被要求修复一个 bug时它会直接写代码然后说完成了。而一个加载了 Agent Skills 的 AI 助手会依次经历问题确认 → 根因分析 → 最小化复现 → 修复 → 测试覆盖 → 代码审查 → 文档更新每一步都有明确的验证标准。使用场景个人开发者提升 AI 协作质量为 Claude Code 或 Cursor 加载工作流让 AI 帮你从头完整做一个功能而不是只写代码主体扔给你收拾边角料。团队统一 AI 使用规范在团队的代码仓库中放置项目级的工作流配置让所有成员的 AI 助手遵循一致的工程标准。AI 代理流水线的质量门控在自动化 CI/CD 中使用 Agent Skills 作为 AI 生成代码的审查框架防止低质量代码进入主干。AI 编码教育与培训通过观察 AI 在工作流约束下如何处理各类工程问题学习最佳实践。快速开始方法 1Claude Code 插件市场推荐# 在 Claude Code 会话中执行/plugin marketplaceaddaddyosmani/agent-skills /plugininstallagent-skillsaddy-agent-skills安装后直接使用 Slash Command# 定义需求/spec 我需要一个用户认证功能支持 OAuth2.0# 规划任务/plan# 开始实现/build# 验证功能/test# 代码审查/review# 化繁为简/code-simplify# 部署上线/ship方法 2本地克隆适用于所有工具# 克隆仓库gitclone https://github.com/addyosmani/agent-skills.git# 在 Claude Code 中加载claude --plugin-dir /path/to/agent-skills# 在 Gemini CLI 中加载gemini skillsinstallhttps://github.com/addyosmani/agent-skills.git--pathskills方法 3直接在 CLAUDE.md 中引用# CLAUDE.md Load the following skills for this project: - skills/build/incremental-implementation - skills/verify/test-driven-development - skills/review/code-review-and-quality核心特性20 个专业技能Skills覆盖 Define、Plan、Build、Verify、Review、Ship 六个开发阶段每个技能都有明确的触发条件、执行步骤和验证标准。7 个 Slash Command/spec、/plan、/build、/test、/review、/code-simplify、/ship将复杂工作流压缩为单个命令。3 个专家角色Agent Personascode-reviewer代码审查专家、test-engineer测试工程师、security-auditor安全审计员——让 AI 以专业角色的视角审视你的代码。反理由化Anti-Rationalization设计每个技能文件内置借口与反驳表预先堵住 AI 常用的偷懒借口例如“需求还没确认先写代码吧” → “不先用/spec锁定需求”。验证优先Verification-First每个步骤完成后必须提供可验证的证据测试通过截图、构建产物、运行时数据而不是主观判断应该没问题了。工具无关性同一套技能支持 Claude Code、Cursor、Gemini CLI、Windsurf、OpenCode、GitHub Copilot、Kiro IDE 等所有主流 AI 编码工具。4 份参考检查表测试模式、安全规范、性能优化、无障碍访问——提供随时可调用的专业检查清单。项目优势对比项Agent Skills普通 System PromptRules 文件 (.cursorrules)结构化程度完整的工作流有步骤和检查点自由文本AI 理解因人而异偏向代码风格规范工程深度覆盖全生命周期spec 到 ship通常只覆盖代码生成主要约束代码格式防偷懒机制内置反理由化表无无多工具支持7 主流 AI 工具工具相关工具相关可维护性版本化的 Markdown可 PR 更新散落在各处仓库级单文件为什么选择 Agent Skills出身于工程文化最严格的团队之一Google Chrome工程质量有保证30k Stars 代表了大量真实用户的验证纯 Markdown 实现意味着零侵入、随时可调整、无供应商锁定项目详细剖析1. 技能文件的解剖一个 Skill 长什么样以skills/build/incremental-implementation/SKILL.md为例每个技能文件遵循一套固定的解剖结构--- name: incremental-implementation description: Build features in small, testable increments triggers: - start implementation - begin coding - implement feature --- ## Overview [技能的目的和适用范围] ## When to Use [触发这个技能的具体场景] ## Process [逐步执行的工作流每步都有明确的交付物] ### Step 1: Understand the task - 确认需求是否已经有 spec - 明确这次实现的边界in scope / out of scope ... ## Rationalizations (借口与反驳) | 常见借口 | 为什么不行 | |:---|:---| | 需求很简单直接写 | 简单不代表不需要边界定义 | | 先跑通再写测试 | 这会导致测试覆盖不足... | ## Red Flags [应该警惕的错误信号如一次提交超过 400 行] ## Verification [完成这个技能需要提供的证明]这种结构的精妙之处在于它不是写给人看的文档而是写给 AI 执行的程序。每个字段都在约束 AI 的行为边界。2. 六阶段工作流从想法到上线的完整闭环Define → Plan → Build → Verify → Review → Ship ↓ ↓ ↓ ↓ ↓ ↓ /spec /plan /build /test /review /ship ↓ ↓ ↓ ↓ ↓ ↓ 需求锁定 任务分解 增量实现 测试证明 质量门控 安全发布每个阶段都有对应的技能支撑Define定义阶段idea-refine— 将模糊想法磨砺成可执行需求spec-driven-development— 用规范驱动开发而非凭感觉Plan规划阶段planning-and-task-breakdown— 将需求拆分为原子级、可验证的最小任务Build构建阶段incremental-implementation— 小步快跑每一步都可测试test-driven-development— 先写测试再写实现frontend-ui-engineering— 前端工程的专项规范无障碍、性能、响应式source-driven-development— 用官方文档/源码驱动实现而非靠记忆documentation-as-code— 文档即代码与实现同步更新code-as-liability— 把代码视为需要管理的负担包括删除Verify验证阶段browser-testing-with-devtools— 用真实工具验证不依赖主观感觉debugging-and-error-recovery— 系统化的调试方法论Review审查阶段code-review-and-quality— 代码审查的完整流程security-and-hardening— 安全审计专项performance-optimization— 性能瓶颈识别与优化change-sizing— 控制变更粒度符合谷歌的小 PR文化Ship发布阶段git-workflow-and-versioning— Git 工作流规范ci-cd-and-automation— CI/CD 流水线配置shipping-and-launch— 安全发布检查清单trunk-based-development— 主干开发实践code-deprecation— 老代码的退役流程3. 专家角色Agent Personas让 AI 穿上职业制服这是 Agent Skills 中一个非常有创意的设计。与其让同一个 AI 又写代码又审代码不如让它变身为一个纯粹的专家security-auditor 角色示例You are a security auditor. Your ONLY job is to find vulnerabilities. Do NOT suggest new features. Do NOT improve code quality. Focus EXCLUSIVELY on: - Input validation gaps - Authentication/Authorization flaws - Injection vulnerabilities (SQL, XSS, SSTI...) - Exposed secrets or credentials - Insecure dependencies当你调用security-auditor角色审查代码时AI 会完全进入安全专家的视角不会被功能实现分心——这种**单一职责原则SRP**在 AI 使用层面的应用效果出人意料地好。4. 反理由化Anti-Rationalization工程纪律的护城河这是整个项目最独特的设计之一。每个技能文件都包含一张借口-反驳对照表专门针对 AI和人在压力下的常见逃避行为AI 常见借口工程纪律的反驳“这个功能很简单直接写”简单性是主观判断没有 spec 就没有验收标准“测试之后再补”补测试的技术债通常不会被还清“只是临时的 workaround”临时方案的平均寿命超乎你的想象“PR 已经很大了再加点也无所谓”大 PR 是审查盲区也是 merge 冲突的来源“性能优化以后再说”以后很可能意味着永远不会项目地址与资源官方资源GitHub: https://github.com/addyosmani/agent-skills技能解剖文档: docs/skill-anatomy.md贡献指南: CONTRIBUTING.md️Claude Code 文档: docs/claude-code.md适用人群日常使用 Claude Code、Cursor 等 AI 编码工具但发现 AI 经常偷工减料的开发者希望在团队中统一 AI 使用规范的技术负责人对工程最佳实践感兴趣希望借助 AI 工具实践 Google 工程文化的工程师构建自动化 Agent 流水线需要质量保障机制的 AI 应用开发者总结与展望核心要点回顾AI 默认会走捷径Agent Skills 通过结构化工作流强制 AI 遵循工程纪律纯 Markdown 实现零依赖、工具无关、完全可自定义覆盖完整开发生命周期从需求 spec 到代码退役7 个 Slash Command 贯穿始终反理由化设计是最独特的亮点预先消除 AI 的常见偷懒借口来自 Google Chrome 工程总监工程理念经过大规模生产验证一句话评价如果说 AI 编码工具让你写代码快了 10 倍那么 Agent Skills 让你写的代码也好了 10 倍。欢迎来我的个人主页找到更多有用的知识和有趣的产品