谷歌 Gemini 团队主管 Addy Osmani，最近开源的 Agent Skills，狂揽了 18000+ GitHub Star。 它把资深工程师的工作流和开发规范，封装成了 Skills 技能库，让 AI 在每个开发阶段都能保持一致的高标准。 整个项目围绕软件开发生命周期设计，覆盖定义、规划、构建、验证、评审、发布六个阶段，共计 20 个核心技能。

Agent-skills 仓库介绍

agent-skills 是一个为 AI 编码代理（AI coding agents）提供生产级工程技能的仓库，核心目标是让 AI 代理能遵循资深工程师的工作流、质量标准和最佳实践，在软件开发全生命周期中保持一致性。

核心设计：软件开发生命周期映射

仓库将软件开发拆解为六个核心阶段，并为每个阶段匹配对应的核心原则与指令，覆盖从需求定义到上线交付的全流程：

表格

阶段	核心动作	指令	核心原则
定义阶段	明确要构建的内容	/spec	先定规格，再写代码
规划阶段	规划构建方式	/plan	拆解为小型、原子化任务
构建阶段	增量式开发	/build	一次只实现一个功能切片
验证阶段	验证功能有效性	/test	测试是功能可用的证明
评审阶段	合入前代码评审	/review	提升代码健康度
交付阶段	上线到生产环境	/ship	更快交付反而更安全
优化补充	代码简化	/code-simplify	清晰优于炫技

此外，技能会根据场景自动激活（例如设计 API 触发 api-and-interface-design、开发 UI 触发 frontend-ui-engineering）。

适配的工具 / 平台

仓库提供了多平台的接入方式，满足不同 AI 编码工具的集成需求：

1. Claude Code（推荐）：支持市场插件安装或本地开发模式部署；
2. Cursor：将技能文件拷贝到指定目录即可集成；
3. Gemini CLI：支持从远程仓库或本地克隆包安装技能；
4. Windsurf：将技能内容添加到规则配置中；
5. OpenCode：通过 AGENTS.md 和 skill 工具实现代理驱动的技能执行。

仓库结构

核心目录 / 文件分工清晰，便于扩展和使用：

• agents/：包含代码评审、安全审计、测试工程师等特定角色的代理说明；
• references/：可访问性、性能、安全、测试模式等检查清单和最佳实践参考；
• hooks/：包含缓存、忽略规则等相关的脚本配置；
• skills/：核心技能文件目录（各场景的 SKILL.md 存放处）；
• docs/：不同平台（Cursor/Gemini/Windsurf 等）的集成配置文档；
• 根目录文档：AGENTS.md（代理说明）、CLAUDE.md（Claude 集成）、README.md（核心介绍）等。

核心价值

将资深工程师的工程经验封装为可复用的「技能」，让 AI 编码代理不再只关注代码语法，而是遵循工业级的开发规范，从需求定义、开发、测试到交付全流程保障代码质量和开发效率。

agent-skills 仓库中的「技能」核心是将资深工程师的工程规范、开发流程和最佳实践封装为结构化的指令 / 规则，让 AI 编码代理能识别并执行。其实现方式可从「技能载体」「触发逻辑」「适配集成」三个维度拆解：

一、技能的核心载体：结构化的规则文件

技能的核心逻辑以可读、可解析的文本 / 配置文件形式存在（主要是 SKILL.md 格式），而非传统代码逻辑，便于 AI 代理理解和执行：

1. 内容结构：每个 skills/ 目录下的 SKILL.md 会定义对应场景的核心规则，例如：
   • 阶段化指令：对应 /spec//plan//build 等开发生命周期的核心要求；
   • 场景化规则：如 api-and-interface-design 技能会定义 API 设计的规范（参数命名、返回格式、错误码等），frontend-ui-engineering 会定义 UI 开发的可访问性、性能要求；
   • 质量校验标准：如测试覆盖率、代码评审的检查项（参考 references/ 目录下的检查清单）。
2. 格式设计：采用 Markdown 格式（兼顾人类可读性和 AI 可解析性），核心原则、步骤、校验项会通过标题、列表、表格等结构化排版，让 AI 能快速提取关键规则。

二、技能的触发与执行逻辑

技能并非被动存储，而是通过「指令映射 + 场景自动激活」触发：

1. 指令映射触发：
   • 仓库定义了 7 个核心 slash 指令（/spec//plan//build//test//review//code-simplify//ship），每个指令绑定对应开发阶段的技能集合；
   • 当用户 / 代理输入指令（如 /test）时，AI 会自动加载该指令对应的技能规则（如「测试是功能可用的证明」核心原则、测试用例设计规范、调试流程等），并按规则执行。
2. 场景自动激活：
   • 技能会根据开发场景自动匹配，无需手动指令：例如 AI 检测到当前任务是「设计 REST API」时，会自动激活 api-and-interface-design 技能；检测到「编写前端组件」时，自动激活 frontend-ui-engineering 技能；
   • 场景识别的核心是通过关键词 / 任务上下文匹配（由集成的 AI 代理侧实现，仓库仅定义「场景 – 技能」的映射规则）。

三、技能的适配与集成实现

仓库本身不直接运行技能，而是通过「标准化的集成方式」让不同 AI 编码工具（Claude/Cursor/Gemini 等）能加载并执行技能规则：

1. Claude Code（核心适配）：
   • 封装为 Claude 插件：.claude-plugin/ 目录下的 marketplace.json/plugin.json 定义了插件的元信息（名称、版本、触发方式），让 Claude 能识别并加载 skills/ 目录的规则；
   • 本地部署：通过 claude --plugin-dir 指定仓库路径，Claude 启动时加载所有技能规则，关联 slash 指令与技能逻辑。
2. Cursor：
   • 直接复用 SKILL.md 文件：将技能文件拷贝到 Cursor 的 .cursor/rules/ 目录，Cursor 的 AI 会读取规则并在编码过程中强制执行（如实时提示不符合规范的代码）。
3. Gemini CLI：
   • 作为「原生技能包」安装：通过 gemini skills install 命令将 skills/ 目录的规则注册到 Gemini CLI，AI 执行编码任务时自动调用对应技能。
4. Windsurf/OpenCode 等：
   • 规则注入：将 SKILL.md 中的核心内容提取并添加到工具的规则配置中（如 Windsurf 的规则文件、OpenCode 的 AGENTS.md），让工具的 AI 代理按规则执行。

四、辅助增强：钩子脚本（hooks）

仓库的 hooks/ 目录提供了辅助脚本（如 sdd-cache-pre.sh/simplify-ignore.sh），用于：

• 缓存技能规则（提升 AI 加载效率）；
• 忽略非核心文件 / 规则（减少 AI 处理冗余）；
• 验证技能执行效果（如 simplify-ignore-test.sh 测试忽略规则是否生效）。

  这些脚本并非技能逻辑的核心，而是优化技能在集成时的执行效率和准确性。

总结

      agent-skills 的技能实现核心是「规则即代码」：将工程最佳实践拆解为 AI 可理解的结构化规则文件，通过指令 / 场景触发执行，并适配不同 AI 工具的集成方式，让 AI 编码代理能复现资深工程师的开发流程和质量标准。其核心价值是「规范封装」而非「代码逻辑实现」，因此无需复杂的编译 / 运行逻辑，重点是规则的结构化和可集成性。

文章摘自：https://www.cnblogs.com/wintersun/p/19908147