代理技能适用于AI编码代理的生产级工程技能技能对高级工程师在构建软件时所采用的工作流程、质量关卡和最佳实践进行了编码。这些技能经过封装能确保AI代理在开发的每个阶段都能始终如一地遵循。开发流程包括定义DEFINE、规划PLAN、构建BUILD、验证VERIFY、评审REVIEW、部署SHIP。┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ Idea │ ───▶ │ Spec │ ───▶ │ Code │ ───▶ │ Test │ ───▶ │ QA │ ───▶ │ Go │ │Refine│ │ PRD │ │ Impl │ │Debug │ │ Gate │ │ Live │ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ /spec /plan /build /test /review /ship命令7个斜杠命令对应开发生命周期每个命令都会自动激活相应技能。操作内容命令关键原则定义要构建的内容/spec先写规格文档再编写代码规划构建方式/plan任务要小且原子化逐步构建/build一次完成一部分证明功能正常/test测试即证明合并前评审/review提升代码健康度简化代码/code - simplify清晰胜于巧妙部署到生产环境/ship越快越安全技能还会根据你的操作自动激活例如设计API会触发 api - and - interface - design 技能构建UI会触发 frontend - ui - engineering 技能以此类推。快速开始Claude Code推荐市场安装/plugin marketplace add addyosmani/agent - skills plugin install agent - skillsaddy - agent - skills若遇到SSH错误市场通过SSH克隆仓库。若未在GitHub上设置SSH密钥可添加SSH密钥或使用完整的HTTPS URL强制使用HTTPS克隆/plugin marketplace add https://github.com/addyosmani/agent - skills.git /plugin install agent - skillsaddy - 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 和技能工具使用代理驱动的技能执行。详情见 docs/opencode - setup.md。GitHub Copilot将 agents/ 中的代理定义用作Copilot角色并将技能内容放在 .github/copilot - instructions.md 中。详情见 docs/copilot - setup.md。Kiro IDE CLIKiro的技能位于 .kiro/skills/ 目录下可存储在项目或全局级别。Kiro也支持 Agents.md。详情见 [Kiro文档](https://kiro.dev/docs/skills/)。Codex / 其他代理技能为纯Markdown格式适用于任何接受系统提示或指令文件的代理。详情见 docs/getting - started.md。全部20项技能上述命令是入口点实际上它们会激活这20项技能每项技能都是一个结构化的工作流程包含步骤、验证关卡和反合理化表格。也可以直接引用任何技能。定义 - 明确要构建的内容技能功能使用场景idea - refine通过结构化的发散/收敛思维将模糊的想法转化为具体的提案有一个需要探索的粗略概念spec - driven - development在编写代码前编写一份涵盖目标、命令、结构、代码风格、测试和边界的产品需求文档PRD启动新项目、新功能或进行重大变更规划 - 拆解任务技能功能使用场景planning - and - task - breakdown将规格文档分解为小的、可验证的任务并确定验收标准和依赖顺序有了规格文档需要可实施的单元构建 - 编写代码技能功能使用场景incremental - implementation采用垂直切片方式进行实现、测试、验证和提交。使用特性开关、安全默认值和易于回滚的变更任何涉及多个文件的变更test - driven - development遵循红 - 绿 - 重构原则、测试金字塔80/15/5、测试规模、DAMP优于DRY、Beyonce规则和浏览器测试实现逻辑、修复bug或更改行为context - engineering在合适的时间为代理提供正确的信息包括规则文件、上下文打包和MCP集成开始会话、切换任务或输出质量下降时source - driven - development依据官方文档做出每个框架决策进行验证、引用来源并标记未验证的内容需要为任何框架或库编写有权威来源引用的代码frontend - ui - engineering涉及组件架构、设计系统、状态管理、响应式设计和WCAG 2.1 AA可访问性构建或修改用户界面api - and - interface - design采用契约优先设计、Hyrum定律、单版本规则、错误语义和边界验证设计API、模块边界或公共接口验证 - 证明功能正常技能功能使用场景browser - testing - with - devtools使用Chrome DevTools MCP获取实时运行时数据包括DOM检查、控制台日志、网络跟踪和性能分析构建或调试任何在浏览器中运行的内容debugging - and - error - recovery采用五步排查法重现、定位、简化、修复和防护。遵循停线规则和安全回退机制测试失败、构建中断或行为异常时评审 - 合并前的质量关卡技能功能使用场景code - review - and - quality进行五轴评审控制变更规模约100行使用严重程度标签Nit/Optional/FYI遵循评审速度规范和拆分策略合并任何变更前code - simplification遵循切斯特顿栅栏原则和500规则在保持精确行为的同时降低复杂度代码能正常工作但可读性或可维护性较差security - and - hardening预防OWASP十大安全风险采用认证模式、密钥管理、依赖审计和三层边界系统处理用户输入、认证、数据存储或外部集成performance - optimization采用先测量的方法设定核心网页指标目标进行性能分析、包分析和反模式检测存在性能要求或怀疑性能下降时部署 - 自信地部署技能功能使用场景git - workflow - and - versioning采用基于主干的开发方式进行原子提交控制变更规模约100行遵循提交即保存点模式进行任何代码变更时ci - cd - and - automation采用左移原则越快越安全使用特性开关、质量关卡管道和失败反馈循环设置或修改构建和部署管道时deprecation - and - migration秉持代码即负债的理念区分强制和建议性弃用采用迁移模式并移除僵尸代码移除旧系统、迁移用户或停用功能时documentation - and - adrs编写架构决策记录ADR、API文档和内联文档标准记录决策原因做出架构决策、更改API或发布功能时shipping - and - launch执行预发布检查清单、管理特性开关生命周期、进行分阶段发布、制定回滚程序和设置监控准备部署到生产环境时代理角色预配置的专家角色用于针对性评审代理角色视角code - reviewer高级工程师按照“资深工程师是否会批准”的标准进行五轴代码评审test - engineerQA专家制定测试策略、进行覆盖率分析和采用证明模式security - auditor安全工程师进行漏洞检测、威胁建模和OWASP评估参考清单技能在需要时会引用的快速参考资料testing - patterns.md涵盖测试结构、命名、模拟、React/API/E2E示例和反模式security - checklist.md包含提交前检查、认证、输入验证、头部信息、CORS和OWASP十大安全风险预防performance - checklist.md设定核心网页指标目标、前端/后端检查清单和测量命令accessibility - checklist.md涉及键盘导航、屏幕阅读器、视觉设计、ARIA和测试工具技能工作原理每个技能都遵循一致的结构┌─────────────────────────────────────────────────┐ │ SKILL.md │ │ │ │ ┌─ Frontmatter ─────────────────────────────┐ │ │ │ name: lowercase - hyphen - name │ │ │ │ description: Guides agents through [task].│ │ │ │ Use when… │ │ │ └───────────────────────────────────────────┘ │ │ Overview → What this skill does │ │ When to Use → Triggering conditions │ │ Process → Step - by - step workflow │ │ Rationalizations → Excuses rebuttals │ │ Red Flags → Signs somethings wrong │ │ Verification → Evidence requirements │ └─────────────────────────────────────────────────┘关键设计选择流程而非文档技能是代理遵循的工作流程而非供其阅读的参考文档。每个技能都有步骤、检查点和退出标准。反合理化每个技能都包含一个表格列出代理跳过步骤的常见借口如“我稍后再添加测试”并给出相应的反驳理由。验证不可协商每个技能都以证据要求结束如测试通过、构建输出、运行时数据等。“看起来没问题”是不够的。渐进式披露SKILL.md 是入口点仅在需要时加载支持性参考资料以最小化令牌使用量。项目结构agent - skills/ ├── skills/ # 20项核心技能每个目录包含一个SKILL.md文件 │ ├── idea - refine/ # 定义 │ ├── spec - driven - development/ # 定义 │ ├── planning - and - task - breakdown/ # 规划 │ ├── incremental - implementation/ # 构建 │ ├── context - engineering/ # 构建 │ ├── source - driven - development/ # 构建 │ ├── frontend - ui - engineering/ # 构建 │ ├── test - driven - development/ # 构建 │ ├── api - and - interface - design/ # 构建 │ ├── browser - testing - with - devtools/ # 验证 │ ├── debugging - and - error - recovery/ # 验证 │ ├── code - review - and - quality/ # 评审 │ ├── code - simplification/ # 评审 │ ├── security - and - hardening/ # 评审 │ ├── performance - optimization/ # 评审 │ ├── git - workflow - and - versioning/ # 部署 │ ├── ci - cd - and - automation/ # 部署 │ ├── deprecation - and - migration/ # 部署 │ ├── documentation - and - adrs/ # 部署 │ ├── shipping - and - launch/ # 部署 │ └── using - agent - skills/ # 元信息如何使用此包 ├── agents/ # 3个专家角色 ├── references/ # 4个补充清单 ├── hooks/ # 会话生命周期钩子 ├── .claude/commands/ # 7个斜杠命令Claude Code ├── .gemini/commands/ # 7个斜杠命令Gemini CLI └── docs/ # 每个工具的设置指南为什么需要代理技能AI编码代理通常会选择最短路径这往往意味着跳过规格文档、测试、安全评审以及确保软件可靠性的实践。代理技能为代理提供了结构化的工作流程强制其遵循高级工程师在生产代码中所采用的规范。每个技能都融入了宝贵的工程判断包括何时编写规格文档、测试内容、评审方式以及部署时机。这些不是通用的提示而是区分生产级和原型级工作的、有明确观点和流程驱动的工作流。技能融入了谷歌工程文化中的最佳实践包括《Google软件工程师修炼之道》和谷歌工程实践指南中的概念。你会在API设计中看到Hyrum定律在测试中看到Beyonce规则和测试金字塔在代码评审中看到变更规模和评审速度规范在简化代码时看到切斯特顿栅栏原则在Git工作流中看到基于主干的开发方式在CI/CD中看到左移原则和特性开关以及专门处理代码负债的弃用技能。这些不是抽象的原则而是直接嵌入到代理遵循的逐步工作流程中。贡献技能应具备针对性可操作的步骤而非模糊的建议、可验证性有明确的退出标准和证据要求、经过实践检验基于实际工作流程和简洁性仅包含指导代理所需的内容。有关格式规范请参阅 docs/skill - anatomy.md有关贡献指南请参阅 CONTRIBUTING.md。许可证采用MIT许可证你可以在项目、团队和工具中使用这些技能。