addyosmani/agent-skills

这是什么

Agent Skills 是一组即用型 工作流（称为技能），教导 AI 编程辅助工具（Claude Code、Cursor、Copilot、Codex、Gemini 等）如何遵循专业软件工程实践。每个技能都是一个 Markdown 文件，定义了逐步流程、质量门和“反合理化”表格，防止代理偷工减料。

为什么重要

AI 驱动的代码辅助工具越来越擅长编写代码片段，但仍缺乏资深工程师的纪律：编写规格、将工作分解为小任务、测试、审查和安全发布。将这些技能插入代理后，团队可以获得一致、生产级输出，而无需手动提醒模型每个最佳实践。

核心概念

生命周期对应的斜杠命令 – /spec、/plan、/build、/test、/review、/ship 等 – 每个触发适当的技能组合。
25 个具体技能涵盖整个开发生命周期（想法精炼、规格驱动开发、测试驱动开发、安全强化、性能审计、CI/CD、可观测性等）。
角色代理（代码审查员、测试工程师、安全审计员、网页性能审计员）可被调用以提供专业反馈。
可移植 Markdown 格式 – 技能适用于任何能吸收系统提示或指令文件的代理。
自动模式 – /build auto 创建计划并在一次批准的过程中执行所有任务，同时在失败时暂停。

如何开始

安装整个包，使用通用的 skills CLI（适用于 70+ 代理）：
```
npx skills add addyosmani/agent-skills   # 安装所有 25 个技能
```

或安装单个技能，例如：

npx skills add addyosmani/agent-skills --skill test-driven-development

对于特定代理，请遵循提供的设置块（Claude Code、Cursor、Antigravity CLI、Gemini、Codex 等）。大多数涉及克隆仓库并将代理的插件/技能目录指向 skills/ 文件夹。
在代理的聊天界面中使用斜杠命令（/spec、/plan、/build、…）来执行工作流。

谁会使用它

工程团队希望 AI 辅助工具尊重其现有的代码审查、测试和部署标准。
工具构建者为 Claude、Cursor、Copilot 等创建插件，需要现成的工程最佳实践提示库。
个人开发者寻找结构化方式来获得 AI 帮助，同时不牺牲质量或安全性。

限制 / 未解决问题

安装单个技能只会复制其 skills/<name>/ 文件夹；references/ 中的共享检查清单会丢失。此可移植性缺口在 issue #361 中跟踪。
某些代理需要额外配置（例如 Claude 市场的 SSH 密钥、Cursor 或 Kiro 的特定文件夹约定）。
仓库提供工作流，但依赖宿主代理来执行；有效性取决于底层模型的合规性。

TL;DR：Agent Skills 捆绑了 25 个以 Markdown 定义的工程工作流，可插入热门的 AI 编程代理，通过简单的斜杠命令赋予它们纪律严明、生产就绪的开发流程。