@tom_doerr: 为AI编码智能体封装高级工程师工作流程 https://github.com/addyosmani/agent-skills…

为AI编码代理编码资深工程师工作流程 https://t.co/TSfcQpb6LV https://t.co/rqzS3SgyFM — # addyosmani/agent-skills 来源：https://github.com/addyosmani/agent-skills # Agent Skills 面向AI编码代理的生产级技能。

技能编码了资深工程师在构建软件时使用的工作流程、质量关口和最佳实践。这些技能被打包，使得AI代理在开发的每个阶段都能一致地遵循它们。

Addy 的 Agent Skills 定义 规划 构建 验证 审查 发布 ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ 想法 │──▶ │ 规格 │──▶ │ 代码 │──▶ │ 测试 │──▶ │ 质量 │──▶ │ 上线 │ │ 细化 │ │ PRD │ │ 实现 │ │ 调试 │ │ 关口 │ │ 运营 │ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ /spec /plan /build /test /review /ship

命令

7 个斜杠命令，映射到开发生命周期。每个命令会自动激活相应的技能。

如果规格已存在，希望减少手动步骤？/build auto 会生成计划并在一次批准的通道中实现所有任务——你只需批准计划一次，它就会自动运行。它移除了任务之间的人工干预步骤，而非验证环节：每个任务仍然由测试驱动并单独提交，遇到失败或高风险步骤时会暂停。

技能也会根据你正在做的事情自动激活——设计 API 会触发 api-and-interface-design，构建 UI 会触发 frontend-ui-engineering，以此类推。

快速入门

Claude Code（推荐）

市场安装：

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

SSH 错误？ 市场通过 SSH 克隆仓库。如果你没有在 GitHub 上设置 SSH 密钥，可以添加 SSH 密钥（https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account）或使用完整的 HTTPS URL 强制使用 HTTPS 克隆：

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

本地/开发安装：

git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills

Cursor

将某个 SKILL.md 复制到 .cursor/rules/，或引用整个 skills/ 目录。参见 docs/cursor-setup.md。

Antigravity CLI

安装为原生插件，支持技能、子代理和斜杠命令。参见 docs/antigravity-setup.md。 从仓库安装：

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

从本地克隆安装：

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

Gemini CLI

安装为原生技能用于自动发现，或添加到 GEMINI.md 作为持久上下文。参见 docs/gemini-cli-setup.md。 从仓库安装：

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

从本地克隆安装：

gemini skills install ./agent-skills/skills/

Windsurf

将技能内容添加到 Windsurf 规则配置中。参见 docs/windsurf-setup.md。

OpenCode

通过 AGENTS.md 和 skill 工具使用代理驱动的技能执行。参见 docs/opencode-setup.md。

GitHub Copilot

将 agents/ 中的代理定义用作 Copilot 角色，并将技能内容放入 .github/copilot-instructions.md。参见 docs/copilot-setup.md。

Kiro IDE & CLI

技能位于 .kiro/skills/ 下，可存储于项目或全局级别。Kiro 也支持 Agents.md。参见 Kiro 文档：https://kiro.dev/docs/skills/

Codex / 其他代理

技能是纯 Markdown 格式——适用于任何接受系统提示或指令文件的代理。参见 docs/getting-started.md。

全部 24 个技能

上述命令是入口点。整个包包含 24 个技能——23 个生命周期技能加上一个元技能 using-agent-skills。每个技能都是一个结构化工作流程，包含步骤、验证关口和反驳预期表。你也可以直接引用任何技能。

元技能

定义 - 明确要构建什么

规划 - 分解任务

构建 - 编写代码

验证 - 证明它能工作

审查 - 合并前的质量关口

发布 - 自信部署

代理角色

针对特定审查的场景配置专业角色：

参考检查清单

技能在需要时引用的快速参考材料：

技能工作原理

每个技能都遵循一致的解剖结构：

┌─────────────────────────────────────────────────┐
│ SKILL.md                                        │
│                                                 │
│ ┌─ 前言 ─────────────────────────────────────┐ │
│ │ name: 小写-连字符-名称                      │ │
│ │ description: 引导代理完成[任务]。           │ │
│ │ Use when...                                 │ │
│ └─────────────────────────────────────────────┘ │
│ 概述 → 该技能的作用                             │
│ 何时使用 → 触发条件                             │
│ 流程 → 逐步工作流程                             │
│ 反驳 → 借口 + 驳斥                             │
│ 红旗 → 出现问题的迹象                           │
│ 验证 → 证据要求                                 │
└─────────────────────────────────────────────────┘

关键设计选择：

• 流程，而非散文。 技能是代理要遵循的工作流程，而非需要阅读的参考文档。每个都有步骤、检查点和退出条件。
• 反驳预期。 每个技能都包含一个常见借口表（代理用来跳过步骤的借口，如“我以后再添加测试”），并附带已记录的反对论据。
• 验证不可商量。 每个技能都以证据要求结尾——测试通过、构建输出、运行时数据。“看起来没错”永远不够。
• 渐进式披露。 SKILL.md 是入口点。仅在需要时加载支持性参考，以最小化 token 使用。

项目结构

agent-skills/
├── skills/                      # 24个技能（23个生命周期 + 1个元技能）
│   ├── interview-me/            # 定义
│   ├── idea-refine/             # 定义
│   ├── spec-driven-development/ # 定义
│   ├── planning-and-task-breakdown/ # 规划
│   ├── incremental-implementation/  # 构建
│   ├── context-engineering/     # 构建
│   ├── source-driven-development/   # 构建
│   ├── doubt-driven-development/    # 构建
│   ├── frontend-ui-engineering/     # 构建
│   ├── test-driven-development/ # 构建
│   ├── api-and-interface-design/    # 构建
│   ├── browser-testing-with-devtools/ # 验证
│   ├── debugging-and-error-recovery/ # 验证
│   ├── code-review-and-quality/  # 审查
│   ├── code-simplification/      # 审查
│   ├── security-and-hardening/   # 审查
│   ├── performance-optimization/ # 审查
│   ├── git-workflow-and-versioning/ # 发布
│   ├── ci-cd-and-automation/     # 发布
│   ├── deprecation-and-migration/ # 发布
│   ├── documentation-and-adrs/   # 发布
│   ├── observability-and-instrumentation/ # 发布
│   ├── shipping-and-launch/      # 发布
│   └── using-agent-skills/       # 元技能：如何使用这个包
├── agents/                      # 4个专业角色
├── references/                  # 4个补充检查清单
├── hooks/                       # 会话生命周期钩子
├── .claude/commands/            # 7个斜杠命令（Claude Code）
├── .gemini/commands/            # 7个斜杠命令（Gemini CLI）
├── commands/                    # 8个斜杠命令（Antigravity CLI）
├── plugin.json                  # Antigravity 插件清单
└── docs/                        # 各工具的安装指南

为什么使用 Agent Skills？

AI 编码代理默认选择最短路径——这通常意味着跳过规格、测试、安全审查以及让软件变得可靠的那些实践。Agent Skills 为代理提供结构化工作流程，强制实施资深工程师在编写生产代码时所秉持的同样纪律。

每个技能都编码了来之不易的工程判断：何时写规格、什么需要测试、如何审查、何时发布。它们并非泛泛的提示——而是那种富有见地、流程驱动的工作流程，能够区分生产级质量与原型级质量。

技能融入了 Google 工程文化中的最佳实践——包括《Software Engineering at Google》（https://abseil.io/resources/swe-book）以及 Google 工程实践指南（https://google.github.io/eng