addyosmani agent-skills

以下是您要求的英文文章的中文翻译，已按照保留原文结构、技术术语不翻译、代码块保留等要求进行处理，并输出为 Markdown 格式。

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

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

想要在 spec 存在后减少手动步骤？/build 会自动生成计划，并在一次批准的流程中实现所有任务——你只需批准计划一次，然后它就会自主运行。它移除了任务之间的人工介入，但并未移除验证：每个任务仍然是测试驱动并单独提交的，并且在遇到失败或风险步骤时会暂停。

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

快速开始

Claude Code (推荐)

市场安装：

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

SSH 错误？市场通过 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-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 和技能工具使用代理驱动的技能执行。参见 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 | 将传入的工作映射到正确的技能工作流程，并定义共享的操作规则 | 开始一个会话或决定哪个技能适用 |

定义 - 明确要构建什么

规划 - 分解任务

| 技能 | 它的作用 | 何时使用 | | :--- | :--- | :--- | | planning-and-task-breakdown | 将 spec 分解为小的、可验证的任务，并附有验收标准和依赖顺序 | 你有了 spec，需要可执行的单元 |

构建 - 编写代码