addyosmani agent-skills

以下是您要求的英文文章的中文翻译，已按照保留原文结构、技术术语不翻译、代码块原样保留等要求处理。

addyosmani agent-skills

原文内容

Agent Skills 面向 AI 编码代理的生产级工程技能。这些技能将资深工程师在构建软件时使用的工作流程、质量门禁和最佳实践进行了编码。它们被打包成标准格式，使 AI 代理在开发的每个阶段都能一致地遵循。

DEFINE    PLAN     BUILD    VERIFY   REVIEW   SHIP
┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐
│ Idea │───▶│ Spec │───▶│ Code │───▶│ Test │───▶│ QA   │───▶│ Go   │
│Refine│   │ PRD  │   │ Impl │   │Debug │   │ Gate │   │ Live │
└──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘
  /spec    /plan    /build   /test   /review  /ship

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

| 你正在做什么 | 命令 | 核心原则 | | --- | --- | --- | | 定义要构建什么 | /spec | 先写 Spec，再写代码 | | 规划如何构建 | /plan | 小粒度、原子化任务 | | 增量构建 | /build | 一次只做一个切片 | | 证明它能工作 | /test | 测试即证据 | | 合并前审查 | /review | 改善代码健康度 | | 审计 Web 性能 | /webperf | 先测量，再优化 | | 简化代码 | /code-simplify | 清晰胜过巧妙 | | 发布到生产环境 | /ship | 更快更安全 |

想要在 spec 确定后减少手动步骤？/build 会自动生成计划并一次性批准执行所有任务——你只需批准一次计划，之后它会自主运行。它消除的是任务之间的人工干预，而不是验证环节：每个任务仍然是测试驱动并单独提交的，遇到失败或风险步骤时会暂停。

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

快速开始

最快路径——任何代理，一条命令。 open 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 code-review-and-quality # 合并前的五维审查
npx skills add addyosmani/agent-skills --skill interview-me # 需求盘问，一次一个问题
npx skills add addyosmani/agent-skills --skill test-driven-development # 红-绿-重构，强制执行

偏好原生集成？请选择下面的工具。

Claude Code（推荐）

Marketplace 安装：

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

SSH 错误？ Marketplace 通过 SSH 克隆仓库。如果你在 GitHub 上没有设置 SSH 密钥，可以添加 SSH 密钥，或者在 marketplace-add 步骤中使用完整的 HTTPS URL 强制使用 HTTPS 克隆：

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

如果在 Windows 或 macOS 上 /plugin install 仍然失败并显示 git@github.com: Permission denied (publickey)，推荐的解决方法是配置 Git 一次，将子进程克隆时的 GitHub SSH URL 重写为 HTTPS：

git config --global url."https://github.com/".insteadOf git@github.com:

本地 / 开发环境：

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

Cursor

将工作流技能放在 .cursor/skills/ 目录下（从 agent-skills/skills/ 同步），将简短策略放在 .cursor/rules/*.mdc 中——不要将完整的技能内容粘贴到 rules 中。详见 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 和技能工具使用代理驱动的技能执行。详见 docs/opencode-setup.md。

GitHub Copilot

使用 agents/ 中的代理定义作为 Copilot 角色，技能内容放在 .github/copilot-instructions.md 中。详见 docs/copilot-setup.md。

Kiro IDE & CLI

Kiro 的技能放在 .kiro/skills/ 目录下，可以存储在项目级别或全局级别。Kiro 也支持 Agents.md。详见 Kiro 文档：https://kiro.dev/docs/skills/

Codex

作为原生 Codex 插件安装（Codex CLI v0.122+）：

codex plugin marketplace add addyosmani/agent-skills

Codex 通过 .codex-plugin/plugin.json 直接读取根目录下的 skills/ 目录。安装后，在聊天中使用 @ 调用技能（例如 @spec-driven-development）。本地安装和故障排除详见 docs/codex-setup.md。

其他代理

技能是纯 Markdown 格式——它们可以与任何接受系统提示或指令文件的代理配合使用。详见 docs/getting-started.md。

全部 24 个技能

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

元技能 - 发现哪个技能适用

| 技能 | 作用 | 使用时机 | | --- | --- | --- | | using-agent-skills | 将传入的工作映射到正确的技能工作流程，并定义共享的操作规则 | 开始一个会话或决定哪个技能适用 |

定义 - 明确要构建什么

| 技能 | 作用 | 使用时机 | | --- | --- | --- | | interview-me | 一次一个问题的面试式盘问，提取用户真正想要的东西，而不是他们认为自己应该想要的东西，直到达到约 95% 的置信度 | 需求描述不明确，或用户主动要求“interview me”/“grill me” | | idea-refine | 结构化的发散/收敛思维，将模糊的想法转化为具体的提案 | 你有一个粗略的概念需要进一步细化 |

请输出翻译