Agent Skills 技能合集

项目概述

Agent Skills 是一套面向 AI 编程代理的生产级工程技能包，将资深工程师在软件开发各阶段所使用的 工作流、质量门禁和最佳实践封装为可复用的结构化流程，使 AI 代理在开发全周期中保持一致的专业水准。

整个流程围绕六个阶段展开：定义 → 规划 → 构建 → 验证 → 评审 → 发布，对应八个斜杠命令，覆盖从需求构思到生产部署的完整链路。

核心命令

阶段	命令	核心原则
定义	/spec	先写规格再写代码
规划	/plan	任务原子化、粒度小
构建	/build	一次交付一个垂直切片
验证	/test	测试即证明
评审	/review	持续改进代码健康度
性能	/webperf	先度量再优化
简化	/code-simplify	清晰优于巧妙
发布	/ship	速度即安全

/build auto 模式可在规格确认后自动生成计划并依次执行所有任务，每个任务仍遵循测试驱动并独立提交，失败或高风险步骤会暂停等待人工介入。

此外，技能会根据上下文自动激活：设计 API 时触发 api-and-interface-design，构建 UI 时触发 frontend-ui-engineering，依此类推。

快速安装

通过开源的 skills CLI 可一键安装到 70+ 主流代理（Claude Code、Cursor、Codex、Copilot、Cline 等）：

npx skills add addyosmani/agent-skills            # 安装全部 24 个技能
npx skills add addyosmani/agent-skills --list     # 浏览后再选择安装
npx skills add addyosmani/agent-skills --skill test-driven-development  # 单个技能安装

注意：单技能安装仅复制 skills/<name>/ 目录，不含共享的 references/ 清单；如需使用补充检查表，建议整库集成或手动克隆。

Claude Code 用户推荐使用市场方式：

/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

遇到 SSH 权限错误时，可改用 HTTPS URL：

/plugin marketplace add https://github.com/addyosmani/agent-skills.git

Antigravity CLI 原生插件安装：

agy plugin install https://github.com/addyosmani/agent-skills.git

Gemini CLI 原生技能安装：

gemini skills install https://github.com/addyosmani/agent-skills.git --path skills

Codex CLI（v0.122+）原生插件：

codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills

Command Code 内置命令：

cmd skills add addyosmani/agent-skills --global   # 全局安装

各工具的详细配置见仓库 docs/ 目录下的安装指南。

24 个技能分类

Meta（1 个）：using-agent-skills（任务路由与共享规则）。

Define（3 个）：interview-me（逐题提问直到 ~95% 置信度）、idea-refine（发散-收敛构思）、spec-driven-development（编写 PRD）。

Plan（1 个）：planning-and-task-breakdown（将规格拆解为可验证任务）。

Build（7 个）：incremental-implementation、test-driven-development、context-engineering、source-driven-development、doubt-driven-development、frontend-ui-engineering、api-and-interface-design。

Verify（2 个）：browser-testing-with-devtools、debugging-and-error-recovery。

Review（4 个）：code-review-and-quality、code-simplification、security-and-hardening、performance-optimization。

Ship（6 个）：git-workflow-and-versioning、ci-cd-and-automation、deprecation-and-migration、documentation-and-adrs、observability-and-instrumentation、shipping-and-launch。

代理角色与引用清单

预配置 4 个专家角色：code-reviewer（资深工程评审）、test-engineer（证明式测试）、security-auditor（OWASP 评估）、web-performance-auditor（Core Web Vitals 审计）。

7 个补充检查表涵盖：完成定义、测试模式、安全清单、性能清单、可访问性、可观测性、编排模式。

技能结构与设计原则

每个技能遵循统一结构：Frontmatter → 概览 → 适用条件 → 流程步骤 → 反合理化表 → 红旗信号 → 验证要求。

关键设计理念：

• 流程而非文章：技能是工作流而非参考资料，配套步骤、检查点与退出标准。
• 反合理化：内置"稍后再补测试"等常见借口的反驳表。
• 验证不可协商：每个技能都以可观测证据（测试通过、构建输出、运行时数据）作为结束条件。
• 渐进式披露：SKILL.md 作为入口，支撑引用按需加载以节省 token。

采用策略

docs/adoption-guide.md 提供两种路径：全新项目从首日即启用完整生命周期；存量项目采用增量、验证优先的渐进式落地。

项目结构

agent-skills/
├── skills/        # 24 个技能（23 生命周期 + 1 meta）
├── agents/        # 4 个专家角色
├── references/    # 7 个补充检查表
├── hooks/         # 会话生命周期钩子
├── .claude/commands/  # Claude Code 斜杠命令
├── .gemini/commands/  # Gemini CLI 斜杠命令
├── commands/      # Antigravity 斜杠命令
└── docs/          # 各工具安装指南

设计动机

AI 编程代理默认走最短路径，往往跳过规格、测试与安全评审。Agent Skills 通过结构化工作流强制落实资深工程师的判断——何时写规格、测什么、怎样评审、何时发布。

技能体系借鉴 Google 工程文化，包含 Hyrum 定律、Beyonce 法则、测试金字塔、变更体积约 100 行、Chesterton's Fence、Trunk-based 开发、Shift Left、Feature Flag 等原则，并设有专门的废弃技能，将代码视为负债。

许可

MIT 许可证。