以下是您提供的英文文章的中文翻译，已按照要求保留原文结构、技术术语和代码块，并输出为 Markdown 格式。
addyosmani agent-skills
代理技能
面向 AI 编码代理的生产级工程技能。这些技能将高级工程师在构建软件时使用的工作流程、质量门禁和最佳实践进行了编码。它们被打包成标准格式，以便 AI 代理在开发的每个阶段都能一致地遵循。
定义 规划 构建 验证 评审 发布 ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ 想法 │ ───▶ │ 规格 │ ───▶ │ 代码 │ ───▶ │ 测试 │ ───▶ │ 质量 │ ───▶ │ 上线 │ │ 完善 │ │ PRD │ │ 实现 │ │ 调试 │ │ 门禁 │ │ 运行 │ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ /spec /plan /build /test /review /ship
命令
8 个斜杠命令，映射到开发生命周期。每个命令会自动激活相应的技能。
| 你正在做什么 | 命令 | 关键原则 | | :--- | :--- | :--- | | 定义要构建什么 | /spec | 先写规格，后写代码 | | 规划如何构建 | /plan | 小型的、原子化的任务 | | 增量构建 | /build | 一次只做一个切片 | | 证明它有效 | /test | 测试即证明 | | 合并前评审 | /review | 改善代码健康 | | 审计 Web 性能 | /webperf | 先测量，后优化 | | 简化代码 | /code-simplify | 清晰胜于巧妙 | | 发布到生产环境 | /ship | 更快更安全 |
想要在规格确定后减少手动步骤？/build 会自动生成计划，并在一次批准的流程中实现所有任务——你只需批准一次计划，然后它就会自主运行。它消除了任务之间的人工干预，但并未移除验证环节：每个任务仍然是测试驱动并单独提交的，并且在遇到失败或风险步骤时会暂停。
技能也会根据你正在做的事情自动激活——设计 API 会触发 api-and-interface-design，构建 UI 会触发 frontend-ui-engineering，以此类推。
快速开始
最快路径——任何代理，一条命令。 开放技能 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（推荐）
市场安装：
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skillsSSH 错误？ 市场通过 SSH 克隆仓库。如果你在 GitHub 上没有设置 SSH 密钥，可以添加你的 SSH 密钥，或者使用完整的 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-skillsCursor
将任意 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-skillsGemini 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 / 其他代理
技能是纯 Markdown 格式——它们适用于任何接受系统提示或指令文件的代理。参见 docs/getting-started.md。
全部 24 个技能
上述命令是入口点。该包总共包含 24 个技能——23 个生命周期技能加上 using-agent-skills 元技能。每个技能都是一个结构化的工作流程，包含步骤、验证门禁和反合理化表格。你也可以直接引用任何技能。
元技能 - 发现哪个技能适用
| 技能 | 功能 | 使用时机 | | :--- | :--- | :--- | | using-agent-skills | 将传入的工作映射到正确的技能工作流程，并定义共享的操作规则 | 开始一个会话或决定哪个技能适用 |
定义 - 明确要构建什么
| 技能 | 功能 | 使用时机 | | :--- | :--- | :--- | | interview-me | 一次一问的访谈，提取用户真正想要的东西，而不是他们认为自己应该想要的东西，直到达到约 95% 的置信度 | 需求描述不明确，或用户调用了 "interview me" / "grill me" | | idea-refine | 结构化的发散/收敛思维，将模糊的想法转化为具体的提案 | 你有一个粗略的概念需要探索 | | spec-driven-development | 在编写任何代码之前，编写一份涵盖目标、命令、结构、代码风格、测试和边界的 PRD | 开始一个新项目、新功能或重大变更 |
规划 - 分解任务
| 技能 | 功能 | 使用时机 | | :--- | :--- | :--- | | planning-and-task-breakdown | 将规格分解为小的、可验证的任务，并附带验收标准和依赖顺序 | 你有了规格，需要可执行的单元 |
构建 - 编写代码
| 技能 | 功能 | 使用时机 | | :--- | :--- | :--- | | incremental-implementation | 垂直薄切片——实现、测试、验证、提交。特性开关、安全默认值、便于回滚的变更 | 任何涉及多个文件的变更 | | test-driven-development | 红-绿-重构，测试金字塔（80/15/5），测试规模，DAMP 原则 | ... |