agent-skills 快速上手把生产级工程技能装进你的 AI 编码 Agent【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills本篇指南基于 agent-skills 仓库的入门文档 docs/getting-started.md 展开讲解如何把这套生产级工程技能skills加载到任意 AI 编码 Agent 中。读完后你将掌握技能Skill的工作机制、四种通用加载方式、最小化与全生命周期两套落地方案以及 agents 角色、斜杠命令、参考清单三类配套资产的使用方法并理解仓库源码中各组件的实际调用关系。技能如何工作是流程不是文档agent-skills 适用于任何接受 Markdown 指令的 AI 编码 Agent。它的核心单元是技能Skill每个技能就是一个 Markdown 文件SKILL.md描述一条具体的工程工作流。当技能被加载进 Agent 的上下文后Agent 会按流程执行——包括验证步骤、需要规避的反模式以及明确的退出标准。这里有一条关键认知原文档加粗强调技能不是参考文档reference docs而是 Agent 逐步执行的流程step-by-step processes。从源码可以印证这一点。以 skills/test-driven-development/SKILL.md 的 frontmatter 为例--- name: test-driven-development description: Drives development with tests. Use when implementing any logic, fixing any bug, or changing any behavior. Use when you need to prove that code works, when a bug report arrives, or when youre about to modify existing functionality. ---name与目录名一致小写连字符命名description采用第三人称说明技能做什么 Use when 触发条件的写法。这种 frontmatter 契约是技能被 Agent 自动发现的前提Agent 启动时只把技能名和描述注入上下文只有当 Agent 判断技能与当前任务相关时才会加载完整的SKILL.md。完整的格式规范见 docs/skill-anatomy.md。快速开始任意 Agent 的四步接入第 1 步克隆仓库git clone https://gitcode.com/GitHub_Trending/agentskill/agent-skills如果你只想要最快速的通用路径也可以使用开源的 skills CLI 一条命令安装全部技能见 README.md 的 Quick Start 章节npx skills add addyosmani/agent-skills # 安装全部 25 个技能 npx skills add addyosmani/agent-skills --list # 安装前先浏览列表适用前提单技能安装--skill name只会拷贝skills/name/目录本身仓库根目录的共享references/清单不会被带过去。技能本身仍可工作但它指向的共享清单路径将不可用。建议整仓集成、克隆仓库或把所需清单复制进已安装技能的references/目录内。这个可移植性缺口在上游仓库以 Issue #361 跟踪。第 2 步选择一个技能浏览skills/目录每个子目录都包含一个SKILL.md结构统一包含五类要素When to use何时使用——指示该技能适用的触发条件Process流程——逐步执行的工作流Verification验证——如何确认工作已完成Common rationalizations常见自我合理化——Agent 可能用来跳过步骤的借口及对应反驳Red flags危险信号——技能正在被违反的迹象仓库当前共包含 25 个技能24 个生命周期技能 1 个元技能按阶段分组Defineinterview-me、idea-refine、spec-driven-development 等、Planplanning-and-task-breakdown、Buildincremental-implementation、test-driven-development、frontend-ui-engineering 等、Verifybrowser-testing-with-devtools、debugging-and-error-recovery、Reviewcode-review-and-quality、security-and-hardening 等、Shipgit-workflow-and-versioning、ci-cd-and-automation、shipping-and-launch 等。完整目录见 README.md 的 All 24 Skills 章节。第 3 步把技能加载进 Agent把目标SKILL.md的内容复制进 Agent 的系统提示词、规则文件或对话中。最常见的三种方式系统提示词System prompt在会话开始时粘贴技能内容。规则文件Rules file把技能内容写进项目的规则文件CLAUDE.md、.cursorrules等。仓库自带的 CLAUDE.md 就是一个规则文件实例——不过它配置的是在 agent-skills 仓库内部工作的 Agent文档明确提示不要把它复制到你的项目或全局配置里可复用的资产是skills/下的技能本身。对话引用Conversation在指令中引用技能例如Follow the test-driven-development process for this change.对本次变更遵循 test-driven-development 流程。第 4 步用元技能做技能发现建议始终先加载using-agent-skills元技能。它内置了一张任务类型 → 技能的路由流程图让 Agent 能自行判断当前任务该走哪条流程。从源码 skills/using-agent-skills/SKILL.md 可以看到其核心路由逻辑节选Task arrives ├── Dont know what you want yet? ──────→ interview-me ├── Have a rough concept, need variants? → idea-refine ├── New project/feature/change? ──→ spec-driven-development ├── Have a spec, need tasks? ──────→ planning-and-task-breakdown ├── Implementing code? ────────────→ incremental-implementation ├── Writing/running tests? ────────→ test-driven-development ├── Something broke? ──────────────→ debugging-and-error-recovery ├── Reviewing code? ───────────────→ code-review-and-quality ├── Committing/branching? ─────────→ git-workflow-and-versioning ├── Deploying/launching? ─────────→ shipping-and-launch └── ...UI、API、CI/CD、文档、可观测性等分支完整图见 SKILL.md该元技能还定义了六条始终生效的核心操作行为显式暴露假设、主动管理困惑、必要时提出异议、强制简洁、范围纪律、验证而非假设和 16 步完整生命周期序列interview-me → spec → plan → context → build → 测试 → review → 简化 → git → 文档 → 发布是理解整套技能如何协同的入口文档。推荐配置从最小集到全生命周期最小集建议从这里开始在真实项目中落地前先把 3 个核心技能加载进规则文件spec-driven-development——定义要构建什么先规格后代码test-driven-development——证明它确实能工作测试即证据code-review-and-quality——合并前验证质量五轴审查这三个技能覆盖了 AI 辅助开发中最关键的质量缺口。注意 skills/spec-driven-development/SKILL.md 的触发条件写得很明确Use when starting a new project, feature, or significant change and no specification exists yet当开始新项目、新功能或重大变更且尚不存在规格说明时使用。全生命周期需要全面覆盖时按开发阶段加载技能项目启动: spec-driven-development → planning-and-task-breakdown 开发过程中: incremental-implementation test-driven-development 合并之前: code-review-and-quality security-and-hardening 部署之前: shipping-and-launch上下文感知加载Context-Aware Loading不要一次加载全部技能——那会白白消耗上下文还会稀释真正重要的技能。按当前任务加载相关技能做 UI加载frontend-ui-engineering在调试加载debugging-and-error-recovery搭 CI加载ci-cd-and-automation对于要在真实项目中推广的团队仓库还提供了两条端到端路径的详细指南绿地项目从零启用全生命周期以及成熟代码库的验证优先、渐进式落地方案见 docs/adoption-guide.md。技能结构Skill Anatomy每个技能都遵循相同的结构YAML frontmatter (name, description) ├── Overview — 这个技能做什么 ├── When to Use — 触发条件 ├── Core Process — 逐步工作流 ├── Examples — 代码示例与模式 ├── Common Rationalizations — 借口及反驳 ├── Red Flags — 技能被违反的迹象 └── Verification — 退出标准清单其中两个设计点值得特别强调依据 docs/skill-anatomy.md 的完整规格反合理化表Common Rationalizations把 Agent 常说的我待会儿再补测试这很简单不用写规格逐条列出并配上事实性反驳防止 Agent 找借口跳过流程。验证即不可谈判项每个技能以带证据要求的清单收尾——测试通过、构建输出、运行时数据看起来对永远不算数。上下文效率也是结构约束的一部分SKILL.md建议控制在 500 行以内超过 100 行的参考资料拆到支撑文件中按需加载被多个技能共享的清单则统一放在仓库根目录的references/下作为唯一事实来源pack 级设计选择权衡与代价见 anatomy 文档的 Shared References 一节。使用 Agents四个预置专家角色agents/目录包含预配置的 Agent 角色persona用于专项审查Agent用途code-reviewer.md五轴代码审查test-engineer.md测试策略与编写security-auditor.md漏洞检测web-performance-auditor.mdCore Web Vitals 与性能审计通过/webperf调用从源码看每个角色文件同样是frontmatter 角色指令的 Markdown 结构。以 agents/code-reviewer.md 为例它定义了一位Senior Staff Engineer要求按正确性、可读性、架构、安全、性能五个维度评估变更并给出分类反馈。使用方式在需要专项审查时加载对应角色定义例如要求编码 Agent使用 code-reviewer 角色审查这次变更并把该角色文件一并提供。使用 Commands斜杠命令一览仓库为 Claude Code 提供了斜杠命令位于.claude/commands/目录。命令与技能的映射关系如下命令调用的技能/specspec-driven-development/planplanning-and-task-breakdown/buildincremental-implementation test-driven-development/build autoplanning-and-task-breakdown → incremental-implementation test-driven-development整个计划一次批准/testtest-driven-development/reviewcode-review-and-quality/code-simplifycode-simplification/shipshipping-and-launch/webperfweb-performance-auditor专家角色仅限 Web 应用结合命令源码可以进一步理解几个命令的实际行为.claude/commands/spec.md先就目标用户、核心功能与验收标准、技术栈约束、边界总是做/先问/绝不做提问再生成覆盖六大领域的结构化规格保存为项目根目录的SPEC.md并与用户确认。.claude/commands/build.md定义了两种模式。默认/build每次只实现计划中的下一个待办任务读取验收标准 → 写失败测试 RED → 最小实现 GREEN → 全量回归 → 构建验证 → 提交 → 标记完成并停止/build auto则在存在规格文件的前提下对整个计划做一次人类批准随后自主执行每个任务的完整测试驱动循环。关键约束自主模式只移除任务之间的人工步进不移除验证——每个任务仍须通过测试并单独提交遇到测试无法通过、规格含糊、或高风险不可逆操作认证变更、破坏性数据迁移、支付、删除、部署等时必须停下来询问用户。.claude/commands/ship.md是一个扇出编排器——并行运行三个专家角色对当前变更做独立检查再把报告合并成唯一的 go/no-go 决策与回滚方案。.claude/commands/webperf.md明确限定只针对 Web 应用不用于工具库、CLI 或无浏览器输出的纯服务端代码。插件安装时的警告说明作为 Claude Code 插件安装时你可能看到类似Default commands/ folder is ignored because the manifest sets commands的警告。这是预期行为仓库根目录的commands/目录属于 Antigravity CLI与.claude/commands/有意分开所有 Claude Code 斜杠命令都正确地从 .claude/commands/ 加载该警告纯属显示层面。插件清单见 plugin.json当前版本 0.6.8。使用 References补充清单references/目录存放补充性检查清单当技能本身覆盖的细节不够时按需加载Reference配合使用的技能testing-patterns.mdtest-driven-developmentperformance-checklist.mdperformance-optimizationsecurity-checklist.mdsecurity-and-hardeningaccessibility-checklist.mdfrontend-ui-engineeringdefinition-of-done.md所有技能 / 每次变更observability-checklist.mdobservability-and-instrumentationorchestration-patterns.mddoubt-driven-development其中 references/definition-of-done.md 值得单独说明它定义的是每个变更都必须跨过的、项目级常设门槛测试通过、无回归、运行时行为已验证、文档已更新与逐任务的验收标准互补——任务只有在其自身验收标准满足且常设 DoD 达标时才算完成。再次强调前文提到的限制单技能npx安装场景下这些位于仓库根目录的共享清单路径不可用需整仓集成或手动拷贝清单文件缺口由上游 Issue #361 跟踪。Spec 与任务工件的管理/spec和/plan命令会产生工作工件SPEC.md、tasks/plan.md、tasks/todo.md。在工作进行期间应把它们当作**活文档living documents**对待开发期间保留在版本控制中让人与 Agent 拥有共享的单一事实来源范围或决策变化时同步更新如果你的仓库不希望这些文件长期存在合并前删除或把相应目录加入.gitignore——工作流并不要求它们永久存在。/build auto命令的源码.claude/commands/build.md也印证了这一点自主模式会先检查git status --porcelain的干净基线把计划文件作为独立预备提交并严格按只暂存该任务触碰的文件、每任务一次提交执行保证任何提交点都是干净的回滚位置。实用建议Tips入门文档最后给出的五条实践建议按优先级任何非平凡工作从 spec-driven-development 开始——规格是代码库中最廉价的工件写代码时始终加载 test-driven-development——测试即证明不要跳过验证步骤——它们是整套技能的立身之本选择性加载技能——更多上下文并不总是更好用 agents 角色做审查——不同视角能捕捉不同问题。小结agent-skills 的接入路径可以概括为克隆仓库或npx skills add→ 选择阶段对应的SKILL.md→ 通过系统提示词、规则文件或对话引用三种方式之一注入 Agent → 用using-agent-skills元技能做路由。配置上建议从 spec/TDD/审查三技能的最小集起步再按阶段扩展到全生命周期配合agents/的四个专家角色、.claude/commands/的斜杠命令和references/的共享清单即可在任意接受 Markdown 指令的编码 Agent 中获得一致的工程纪律。各工具Claude Code、Cursor、Gemini CLI、Codex、OpenCode 等的原生集成细节可进一步参阅 docs/ 下的各 setup 指南与 docs/adoption-guide.md。【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考