agent-skills 是面向 AI 编程智能体的生产级工程技能包。它的核心思路是把资深工程师在构建软件时使用的工作流程、质量门禁和最佳实践编码成结构化技能，并打包好，使 AI 智能体在开发的每个阶段都能一致地遵循。
用途 AI 编程智能体默认倾向于走最短路径，常常跳过规格说明、测试、安全审查等让软件可靠的做法。agent-skills 为智能体提供结构化工作流，强制其遵循资深工程师在编写生产代码时同样严格的纪律。每个技能都编码了工程判断：何时写规格、测试什么、如何审查、何时发布。它不是通用提示，而是带有观点、以流程驱动的工作流，帮助产出生产级质量而非原型级质量。
主要能力 包含 9 个映射开发生命周期的斜杠命令，每个命令会自动激活正确的技能。例如 /build 在规格确定后自动生成计划并单次批准后实现所有任务：只需批准一次计划，之后自主运行；它去掉的是任务之间的人工步骤，而不是验证——每个任务仍测试驱动、单独提交，遇到失败或风险步骤会暂停。在 Claude Code 中这些安装为插件命令；若内置命令同名（如 /review），使用命名空间形式 /agent-skills:review。技能也会根据你正在做的事情自动激活，例如设计 API 触发 api-and-interface-design，构建 UI 触发 frontend-ui-engineering 等。
技能组成 共 25 个技能：24 个生命周期技能加 1 个 using-agent-skills 元技能。每个技能是包含步骤、验证门禁和反合理化表格的结构化工作流。技能按用途分组：Meta（发现适用技能）、Define（澄清要构建什么）、Plan（拆解）、Build（写代码）、Verify（证明可用）、Review（合并前质量门禁）、Ship（有把握地部署）。此外还有预配置的专家角色用于定向审查，以及技能在需要时引入的参考清单。
使用方式 最快路径是使用 open skills CLI，一条命令即可安装到 70+ 智能体（Claude Code、Cursor、Codex、Copilot、Cline 等）。也可获取单个技能；但注意按技能安装时 npx 只复制 skills/<name>/，不含仓库级 references/ 目录，技能仍可用，但共享清单路径不可用，建议整仓集成、克隆仓库，或把所需清单复制到已安装技能内的 references/ 目录。各宿主工具还有原生集成方式：Claude Code 可通过市场安装或本地开发安装；Cursor 把工作流技能放在 .cursor/skills/，简短策略放在 .cursor/rules/*.mdc；Antigravity 可作为原生插件安装技能和子智能体；Gemini CLI 可安装为原生技能自动发现，或加入 GEMINI.md；Windsurf 将技能内容加入其规则配置；OpenCode 复制技能到 .opencode/skills/ 并添加项目级 AGENTS.md；Copilot 使用 agents/ 中的定义作为角色，技能内容放入 .github/copilot-instructions.md，其生命周期斜杠命令仅限 Claude Code，需按名称调用技能；Codex 可安装为原生插件（需 Codex CLI v0.122+），安装后用 @ 在对话中调用；Command Code 使用内置 cmd skills 命令。技能是纯 Markdown，任何接受系统提示或指令文件的智能体都能使用。
设计特点 每个技能遵循一致结构，关键设计选择包括：过程而非散文，技能是智能体遵循的工作流，有步骤、检查点和退出标准；反合理化，每个技能包含常见借口（如“我稍后再加测试”）及反驳；验证不可妥协，每个技能以证据要求收尾（测试通过、构建输出、运行时数据），“看起来正确”永远不够；渐进式披露，SKILL.md 是入口，支持性参考仅在需要时加载以节省 token。技能还融入 Google 工程文化中的最佳实践，如 API 设计中的 Hyrum 定律、测试中的 Beyonce 规则和测试金字塔、代码审查中的变更大小与审查速度规范、简化中的 Chesterton's Fence、Git 工作流中的主干开发、CI/CD 中的左移与功能开关，以及专门的弃用技能。
适用场景与限制 适用于希望让 AI 编程智能体遵循生产级工程流程的开发者、团队和工具。项目采用 MIT 许可。对已有代码库，提供了采用指南：新项目可从第一天走完整生命周期，已有代码库可采用增量、验证优先的推广方式。仓库中还有与 Superpowers、Matt Pocock's skills 的对比文档。注意：具体安装命令、各宿主详细配置及版本要求请以官方仓库文档为准；按技能单独安装时共享清单路径的可用性存在已知限制（见 #361）。
