如何快速上手 agent-skills10 分钟跑通 AI 编码代理工程技能的完整指南【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skillsagent-skills 是一套面向 AI 编码代理的生产级工程技能集合。它把规格、测试、代码审查、发布等资深工程师的实践打包成结构化工作流解决 AI 辅助编程中代理跳过规格、测试与安全审查的问题。它能做什么4 个核心能力一览技能覆盖完整开发生命周期24 个技能覆盖需求澄清、任务拆解、增量实现、测试、审查到上线发布的每个阶段。结构化工作流不是参考文档每个技能都有步骤、检查点和退出标准要求代理用测试输出、构建结果等证据完成验证。反借口设计每个技能附「常见借口与反驳」表阻止代理以「改动很小」为由跳过测试或验证。4 个专家角色内置 code-reviewer、test-engineer、security-auditor、web-performance-auditor评审时可按角色名调用。8 个斜杠命令/spec、/test、/review、/ship 等命令对应开发阶段入口自动激活对应技能。安装三种方式把技能装进你的代理方式一Git 克隆通用首次使用推荐。当你的代理没有原生技能系统、或想手动控制加载哪些技能时选它任何能读 Markdown 指令的代理都能用。获取完整仓库包含 24 个技能、角色定义和 references/ 检查清单git clone https://gitcode.com/GitHub_Trending/agentskill/agent-skills方式二Gemini CLI 原生安装。日常使用 Gemini CLI 时选它技能装进可自动发现的目录任务匹配时按需激活。在项目目录下执行从仓库直接安装也可指向本地克隆的 skills 目录gemini skills install https://gitcode.com/GitHub_Trending/agentskill/agent-skills.git --path skills方式三Claude Code 本地插件。使用 Claude Code 时选它克隆后把仓库目录作为插件加载技能、角色和斜杠命令一并注册。在项目根目录启动 Claude Code插件目录指向克隆路径claude --plugin-dir /path/to/agent-skills三种方式对比方式适合人群前置条件Git 克隆任意代理手动管理GitGemini CLI 原生Gemini CLI 用户Gemini CLIClaude Code 本地插件Claude Code 用户Claude Code首次跑通5 分钟用 TDD 写一个失败测试场景给任意技术栈的项目实现一个小函数并让代理严格走 TDD 流程。第一步把 TDD 技能放进代理能发现的目录。以 Cursor 为例把技能目录复制到项目的 .cursor/skills/ 下mkdir -p .cursor/skills cp -r agent-skills/skills/test-driven-development .cursor/skills/第二步在代理会话中下达任务并点名引用技能按照 test-driven-development 流程实现一个 slug() 函数接收标题字符串返回 URL 安全的短字符串。先写测试。第三步观察代理按顺序完成三步先写一个会失败的测试并运行确认失败RED再写最小实现让它通过GREEN最后在测试保持绿色的前提下重构。验收标准看到测试输出从失败变为全部通过说明技能生效如果代理先写实现后补测试直接要求它「从失败的测试重新开始」。结合日常开发3 个高频场景新功能先出规格再动手。开工前把规格和任务拆解技能加载进项目cp -r agent-skills/skills/spec-driven-development agent-skills/skills/planning-and-task-breakdown .cursor/skills/然后让代理「按 spec-driven-development 为这个功能写 SPEC.md确认后拆成任务」。得到一份覆盖目标、命令、测试策略与边界的规格文档以及带验收标准、排好依赖顺序的任务清单每完成一个任务提交一次。合并前做代码审查。把 code-reviewer 角色定义放进项目GitHub Copilot 用户存到 .github/agents/ 并改名为 .agent.md其他代理直接把内容贴进会话。得到按正确性、可读性、架构、安全、性能五个维度组织的审查意见问题按严重级别标注。cp agent-skills/agents/code-reviewer.md .github/agents/code-reviewer.agent.md测试失败时按流程排障。让代理使用 debugging-and-error-recovery 技能它先复现问题再定位、缩小范围、修复最后补一个回归防护测试。得到的不只是跑通的结果还有防止同一问题复发的守卫。自定义如何写自己的技能每个技能都是 skills/ /SKILL.md 一个 Markdown 文件YAML frontmatter 只需 name 和 description。description 要写清「做什么 何时使用」代理靠它决定何时激活技能。SKILL.md 保持在 500 行以内长参考资料拆到单独文件按需加载。完整格式规范、命名约定与上下文节省建议见 docs/skill-anatomy.md向社区贡献新技能的流程见 CONTRIBUTING.md。遇到问题4 个高频坑点与解决现象代理从不激活技能→ 原因技能不在工具识别的目录.cursor/skills、.gemini/skills 等或 frontmatter 缺少 description → 解决核对目录与 frontmatter仍不触发时在对话里直接点名技能如「按 test-driven-development 流程执行」。现象Claude Code 插件安装报 Permission denied (publickey)→ 原因marketplace 默认走 SSH 克隆本地没配 SSH 密钥 → 解决改用 HTTPS 方式克隆或用 git config 配置全局 URL 重写把 SSH 转成 HTTPS。现象单独安装的技能引用 references/ 检查清单时找不到文件→ 原因单技能安装只复制该技能目录不带仓库根部的 references/ → 解决整仓安装或把所需检查清单复制进已装技能的 references/ 目录。现象代理执行的是旧版流程→ 原因项目里的技能副本已过期 → 解决从上游克隆的 skills/ 目录重新同步。跑通第一次之后建议先把规格、测试、审查三个技能作为基线加载进项目规则文件再按任务类型按需加载。各工具的具体配置见 docs/getting-started.md 及 docs/ 下的分工具指南已有代码库的分阶段落地方案见 docs/adoption-guide.md。【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何快速上手 agent-skills：10 分钟跑通 AI 编码代理工程技能的完整指南
如何快速上手 agent-skills10 分钟跑通 AI 编码代理工程技能的完整指南【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skillsagent-skills 是一套面向 AI 编码代理的生产级工程技能集合。它把规格、测试、代码审查、发布等资深工程师的实践打包成结构化工作流解决 AI 辅助编程中代理跳过规格、测试与安全审查的问题。它能做什么4 个核心能力一览技能覆盖完整开发生命周期24 个技能覆盖需求澄清、任务拆解、增量实现、测试、审查到上线发布的每个阶段。结构化工作流不是参考文档每个技能都有步骤、检查点和退出标准要求代理用测试输出、构建结果等证据完成验证。反借口设计每个技能附「常见借口与反驳」表阻止代理以「改动很小」为由跳过测试或验证。4 个专家角色内置 code-reviewer、test-engineer、security-auditor、web-performance-auditor评审时可按角色名调用。8 个斜杠命令/spec、/test、/review、/ship 等命令对应开发阶段入口自动激活对应技能。安装三种方式把技能装进你的代理方式一Git 克隆通用首次使用推荐。当你的代理没有原生技能系统、或想手动控制加载哪些技能时选它任何能读 Markdown 指令的代理都能用。获取完整仓库包含 24 个技能、角色定义和 references/ 检查清单git clone https://gitcode.com/GitHub_Trending/agentskill/agent-skills方式二Gemini CLI 原生安装。日常使用 Gemini CLI 时选它技能装进可自动发现的目录任务匹配时按需激活。在项目目录下执行从仓库直接安装也可指向本地克隆的 skills 目录gemini skills install https://gitcode.com/GitHub_Trending/agentskill/agent-skills.git --path skills方式三Claude Code 本地插件。使用 Claude Code 时选它克隆后把仓库目录作为插件加载技能、角色和斜杠命令一并注册。在项目根目录启动 Claude Code插件目录指向克隆路径claude --plugin-dir /path/to/agent-skills三种方式对比方式适合人群前置条件Git 克隆任意代理手动管理GitGemini CLI 原生Gemini CLI 用户Gemini CLIClaude Code 本地插件Claude Code 用户Claude Code首次跑通5 分钟用 TDD 写一个失败测试场景给任意技术栈的项目实现一个小函数并让代理严格走 TDD 流程。第一步把 TDD 技能放进代理能发现的目录。以 Cursor 为例把技能目录复制到项目的 .cursor/skills/ 下mkdir -p .cursor/skills cp -r agent-skills/skills/test-driven-development .cursor/skills/第二步在代理会话中下达任务并点名引用技能按照 test-driven-development 流程实现一个 slug() 函数接收标题字符串返回 URL 安全的短字符串。先写测试。第三步观察代理按顺序完成三步先写一个会失败的测试并运行确认失败RED再写最小实现让它通过GREEN最后在测试保持绿色的前提下重构。验收标准看到测试输出从失败变为全部通过说明技能生效如果代理先写实现后补测试直接要求它「从失败的测试重新开始」。结合日常开发3 个高频场景新功能先出规格再动手。开工前把规格和任务拆解技能加载进项目cp -r agent-skills/skills/spec-driven-development agent-skills/skills/planning-and-task-breakdown .cursor/skills/然后让代理「按 spec-driven-development 为这个功能写 SPEC.md确认后拆成任务」。得到一份覆盖目标、命令、测试策略与边界的规格文档以及带验收标准、排好依赖顺序的任务清单每完成一个任务提交一次。合并前做代码审查。把 code-reviewer 角色定义放进项目GitHub Copilot 用户存到 .github/agents/ 并改名为 .agent.md其他代理直接把内容贴进会话。得到按正确性、可读性、架构、安全、性能五个维度组织的审查意见问题按严重级别标注。cp agent-skills/agents/code-reviewer.md .github/agents/code-reviewer.agent.md测试失败时按流程排障。让代理使用 debugging-and-error-recovery 技能它先复现问题再定位、缩小范围、修复最后补一个回归防护测试。得到的不只是跑通的结果还有防止同一问题复发的守卫。自定义如何写自己的技能每个技能都是 skills/ /SKILL.md 一个 Markdown 文件YAML frontmatter 只需 name 和 description。description 要写清「做什么 何时使用」代理靠它决定何时激活技能。SKILL.md 保持在 500 行以内长参考资料拆到单独文件按需加载。完整格式规范、命名约定与上下文节省建议见 docs/skill-anatomy.md向社区贡献新技能的流程见 CONTRIBUTING.md。遇到问题4 个高频坑点与解决现象代理从不激活技能→ 原因技能不在工具识别的目录.cursor/skills、.gemini/skills 等或 frontmatter 缺少 description → 解决核对目录与 frontmatter仍不触发时在对话里直接点名技能如「按 test-driven-development 流程执行」。现象Claude Code 插件安装报 Permission denied (publickey)→ 原因marketplace 默认走 SSH 克隆本地没配 SSH 密钥 → 解决改用 HTTPS 方式克隆或用 git config 配置全局 URL 重写把 SSH 转成 HTTPS。现象单独安装的技能引用 references/ 检查清单时找不到文件→ 原因单技能安装只复制该技能目录不带仓库根部的 references/ → 解决整仓安装或把所需检查清单复制进已装技能的 references/ 目录。现象代理执行的是旧版流程→ 原因项目里的技能副本已过期 → 解决从上游克隆的 skills/ 目录重新同步。跑通第一次之后建议先把规格、测试、审查三个技能作为基线加载进项目规则文件再按任务类型按需加载。各工具的具体配置见 docs/getting-started.md 及 docs/ 下的分工具指南已有代码库的分阶段落地方案见 docs/adoption-guide.md。【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考