Agent Skills 技能合集

项目概述

Agent Skills 是一套面向 AI 编程代理的生产级工程技能包，将资深工程师在软件开发各阶段所使用的工作流、质量门禁与最佳实践封装为可复用的结构化流程。它覆盖从需求定义到部署上线的完整开发生命周期，让 AI 代理在每个阶段都遵循一致的标准。

开发流水线

项目以六阶段流水线组织：

DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP
  /spec    /plan    /build    /test     /review    /ship

每个阶段都有对应的斜杠命令入口，命令会根据当前任务自动激活相关技能。例如设计 API 时触发 api-and-interface-design，构建 UI 时触发 frontend-ui-engineering。

九个核心命令

场景	命令	核心原则
定义要构建的内容	/spec	先写规范，再写代码
规划实现方式	/plan	原子化小任务
增量构建	/build	一次一个切片
证明功能有效	/test	测试即证据
设定质量基线	/constraints	一次定义，处处强制
合并前评审	/review	提升代码健康度
Web 性能审计	/webperf	先测量后优化
简化代码	/code-simplify	清晰优于巧妙
上线发布	/ship	更快即更安全

使用 /build auto 可在一次审批后自动生成计划并执行所有任务，减少人工介入，但每个任务仍保持测试驱动并独立提交，遇到失败或高风险步骤时会暂停。

快速安装

通用方式使用 Vercel 的 skills CLI，支持 Claude Code、Cursor、Codex、Copilot、Cline 等 70+ 代理：

# 安装全部 25 个技能
npx skills add addyosmani/agent-skills

# 安装单个技能（如代码评审、TDD）
npx skills add addyosmani/agent-skills --skill code-review-and-quality
npx skills add addyosmani/agent-skills --skill test-driven-development

注意：单技能安装只复制 skills/<name>/ 目录，不包含仓库级 references/，部分共享清单路径将不可用。

各代理还提供原生安装方式：Claude Code 通过 /plugin marketplace add 与 /plugin install；Cursor 放置 .cursor/skills/ 与 .cursor/rules/*.mdc；Codex（v0.122+）使用 codex plugin marketplace add 与 codex plugin add；Gemini CLI 用 gemini skills install；Antigravity CLI 用 agy plugin install；Command Code 用 cmd skills add。

技能清单

包内共 25 个技能（24 个生命周期技能 + 1 个元技能），按阶段归类：

• Define：interview-me、idea-refine、spec-driven-development、constraint-driven-development
• Plan：planning-and-task-breakdown
• Build：incremental-implementation、test-driven-development、context-engineering、source-driven-development、doubt-driven-development、frontend-ui-engineering、api-and-interface-design
• Verify：browser-testing-with-devtools、debugging-and-error-recovery
• Review：code-review-and-quality、code-simplification、security-and-hardening、performance-optimization
• Ship：git-workflow-and-versioning、ci-cd-and-automation、deprecation-and-migration、documentation-and-adrs、observability-and-instrumentation、shipping-and-launch
• Meta：using-agent-skills（路由入口）

另含 4 个专家角色（agents/）：code-reviewer、test-engineer、security-auditor、web-performance-auditor；以及 7 份参考清单（references/），涵盖测试模式、安全清单、性能清单、无障碍清单、可观测性清单等。

技能结构

每个 SKILL.md 采用统一解剖结构：

┌─ Frontmatter（名称 + 触发条件描述）─┐
│ Overview        → 技能做什么        │
│ When to Use     → 触发场景          │
│ Process         → 分步工作流        │
│ Rationalizations → 常见借口与反驳    │
│ Red Flags       → 异常信号          │
│ Verification    → 证据要求          │
└────────────────────────────────────┘

设计要点：以流程而非散文呈现；内置反合理化表防止代理跳过步骤；验证为不可协商项，"看起来对"不算合格；采用渐进加载，参考材料按需引入以节省 token。

项目结构

层 / 消费者	仓库路径	用途
共享工作流核心	skills/（25 个）	各集成通用
共享评审材料	agents/、references/	专家与清单
Claude Code 适配器	.claude/commands/、.claude-plugin/、hooks/	斜杠命令与市场元数据
Gemini CLI 适配器	.gemini/commands/	TOML 命令包装
Codex 适配器	.codex-plugin/	插件元数据
贡献工具	scripts/、evals/、.github/workflows/	校验、路由评测、CI

核心设计动机

AI 编程代理默认走最短路径，往往跳过规范、测试、安全审查等关键环节。Agent Skills 通过结构化工作流强制注入资深工程师的判断力——何时写规范、测什么、怎么评审、何时发布。它吸收了 Google 工程文化的实践，包括 Hyrum 定律、测试金字塔、Beyonce 规则、Chesterton's Fence、Trunk-Based Development、Shift Left 与特性开关等，这些原则被直接嵌入代理执行的分步流程中。

许可证：MIT。