agent-skills 快速上手指南：5 个真实项目场景，完整掌握 AI 编码代理技能集

agent-skills 快速上手指南5 个真实项目场景完整掌握 AI 编码代理技能集【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skillsagent-skills 是一套面向 AI 编码代理的工程技能集把资深工程师交付项目时用的工作流程、质量关卡和最佳实践打包成 24 个可安装的技能让代理从规划到上线都遵循同一套纪律。 仓库 README 习惯按 Define → Plan → Build → Verify → Review → Ship 六个阶段讲解本文换个角度——按你实际会遇到的 5 类处境组织这些技能告诉你情况发生时该翻哪一份 SKILL.md。速查表按处境找技能场景技能什么时候用拿到新任务using-agent-skills开 session 时先让代理说该走哪套流程需求含糊interview-me请求缺给谁用、为什么、成功长什么样想法模糊idea-refine有雏形需要展开选项并压测假设新项目/新功能spec-driven-development写代码前先定义做什么、为何、如何算完成任务大到不知从哪下手planning-and-task-breakdown需要可验证的小任务和验收标准实现逻辑、修 bugtest-driven-development任何行为变更先写失败的测试改动跨多个文件incremental-implementation准备一次写 100 行以上代码之前设计接口/端点api-and-interface-designREST、GraphQL、模块边界、组件 props搭建或修改页面frontend-ui-engineering需要不像 AI 生成的界面输出质量下降context-engineering开 session、切换任务或代理表现变差用不熟的框架source-driven-development框架决策要能溯源到官方文档高风险决策doubt-driven-development生产、安全、不可逆操作测试挂了/构建坏了debugging-and-error-recovery任何不符合预期的错误浏览器里的怪问题browser-testing-with-devtools需要看 DOM、console、网络请求合并前code-review-and-quality任何变更进主干之前代码能跑但难读code-simplification测试通过但实现比必要的重怀疑变慢了performance-optimization有性能指标要求或怀疑出现回退碰输入/认证/存储security-and-hardening用户输入、认证、数据存储、外部集成提交代码git-workflow-and-versioning任何代码变更搭流水线ci-cd-and-automation搭建或修改构建部署流水线上线生产observability-and-instrumentation加遥测或部署到生产环境准备发布shipping-and-launch部署到生产之前的最后一关做架构决策documentation-and-adrs改 API、发功能时同步记录为什么下线老功能deprecation-and-migration移除旧系统、迁移用户新项目怎么起步从模糊想法到可执行计划拿到新任务时先问代理这件事该走哪套流程。元技能 skills/using-agent-skills/SKILL.md 干的就是这件事把进来的工作映射到对应技能并定义共享操作规则。24 个技能里它是唯一的地图建议最先读。动手前先问清需求这一环节有三个技能分别对应三种处境请求缺给谁、为什么、成功标准时用 skills/interview-me/SKILL.md。代理一次只问一个问题附上自己的猜测和置信度直到能预测你的回答。理解偏差在计划和代码出现之前最便宜动工之后再换方向代价最大。有雏形但没想清楚时用 skills/idea-refine/SKILL.md。发散扩张、收敛评估、锐化产出三步走最终产出一页 Markdown问题陈述、推荐方向、关键假设、MVP 范围和不做清单。准备写代码前用 skills/spec-driven-development/SKILL.md。先把构建什么、为什么、如何算完成写进规范再走 SPECIFY → PLAN → TASKS → IMPLEMENT 的带门禁流程每阶段经人确认才推进单行修复、改错别字这类改动不必用。把规范拆成任务清单规范就位后交给 skills/planning-and-task-breakdown/SKILL.md。它把工作量拆成小任务每个都能在单次专注会话里实现、测试并验证且带明确验收标准。先画依赖图确定先建什么再按完整功能路径做垂直切片而不是一层一层先全部数据库、再全部 API地铺。产出落在 tasks/plan.md。任务大到不知道从哪下手、或需要把范围说给人听都用得上它。开始写代码时让代理保持纪律先写测试再写代码skills/test-driven-development/SKILL.md 执行 Red-Green-Refactor 循环先写一个失败的测试再写让它通过的代码。修 bug 时要求先用测试复现缺陷然后才允许动手改——看起来对不算完成。技能里还有 80/15/5 测试金字塔、DAMP over DRY、Beyoncé Rule 这类可执行规则动手前会先探测仓库自带的测试命令而不是默认全局工具。改动跨多个文件、或你准备一次写 100 行以上代码时交给 skills/incremental-implementation/SKILL.md按薄片垂直切片推进实现一点、测试、验证、提交每个增量都让系统保持可工作的状态。特性开关、安全默认值、可回滚的改法都属于这套工具箱。接口和页面最容易跑偏的两处设计 REST 端点、GraphQL schema、模块边界或组件 props 时用 skills/api-and-interface-design/SKILL.md。核心是 Hyrums Law用户足够多时所有可观察行为都会被依赖哪怕文档没承诺——所以每个公开行为都要有意设计不泄露实现细节并在设计期就规划废弃路径。搭建或修改页面时用 skills/frontend-ui-engineering/SKILL.md。目标是不像 AI 生成的 UI组件文件就近组织、遵循设计系统、状态管理与响应式布局到位并满足 WCAG 2.1 AA 无障碍标准。让代理的输出可信输出质量掉下去通常是三个原因之一输入不对 → skills/context-engineering/SKILL.md在对的时间给代理对的信息包括规则文件组织、上下文压缩、MCP 集成。开 session、切换任务或输出质量下降时先查上下文再换模型。引用靠记忆 → skills/source-driven-development/SKILL.md框架相关的每个决策都要溯源官方文档先验证、再引用来源未验证的部分明确标记。决策太关键 → skills/doubt-driven-development/SKILL.md对进行中的每个非平凡决策做对抗性的全新上下文复审流程是 CLAIM → EXTRACT → DOUBT → RECONCILE → STOP必要时升级到第二个模型交叉验证。生产、安全、不可逆操作、陌生代码库都适用——提前验证一份自信的输出比事后调试便宜。卡住时的排查清单 先停线再找根因skills/debugging-and-error-recovery/SKILL.md 的第一条规则叫 stop-the-line出现意外就停止继续加功能保留现场。随后按五步分诊复现、定位、缩小、修复、防护。测试失败、构建报错、行为不符预期、生产事故都走同一套流程而不是随机试错。给代理装上浏览器眼睛静态读代码看不到运行时。skills/browser-testing-with-devtools/SKILL.md 通过 Chrome DevTools MCP 服务器让代理直接检查 DOM、读取 console 日志、分析网络请求、做性能剖析——把猜运行时发生了什么换成验证实际发生了什么。凡是跑在浏览器里的东西都适用纯后端改动用不上它。合并前与上线前四道关卡代码审查过五轴再合并skills/code-review-and-quality/SKILL.md 从五个轴审查正确性、可读性、架构、安全、性能。批准标准很实际——不完美但明确改善代码库健康度就放行不因不是我会写的样子而阻塞。附带变更规模控制约 100 行、严重度标签和拆分策略。问题不在逻辑而在代码太绕时用 skills/code-simplification/SKILL.md目标不是减少行数而是通过新同事能否比看原版更快理解这一检验。Chestertons Fence拆除前先弄清这段代码为何存在和 500 行规则都在其中。注意反向约束代码已经干净时别为了简化而简化。性能与安全两道硬闸性能问题猜不准。skills/performance-optimization/SKILL.md 坚持测量优先先定 Core Web Vitals 目标再剖析、做 bundle 分析最后才谈优化。有性能指标要求、或怀疑出现回退时启用。安全同理不能上线前补。skills/security-and-hardening/SKILL.md 覆盖 OWASP Top 10 预防、认证模式、密钥管理、依赖审计和三层边界体系。碰用户输入、认证、数据存储或外部集成时就该让它介入。提交、流水线、遥测这一组三个技能各管一层改动如何到达用户skills/git-workflow-and-versioning/SKILL.md提交是存档点分支是沙盒历史是文档。推荐 trunk-based 开发——main 随时可部署特性分支 1-3 天内合回原子提交、变更控制在约 100 行。任何代码变更都适用。skills/ci-cd-and-automation/SKILL.md两个核心立场是 Shift Left质量检查前移和 Faster is Safer交付越快越安全配特性开关、质量门禁流水线和失败反馈回路。搭建或修改构建部署流水线、管理多环境配置都走这份技能。skills/observability-and-instrumentation/SKILL.md边构建边埋点——结构化日志、RED 指标、OpenTelemetry 追踪、基于症状的告警。目标是生产出事时值班工程师能快速回答问题在哪。最后一步发布动作本身skills/shipping-and-launch/SKILL.md 管部署生产前的最后一关上线前检查清单、特性开关生命周期、分阶段灰度、回滚程序和监控配置。准备发版时过一遍重点是回滚路径要在发布前验证过。长期运营文档、废弃与决策记录为什么文档与 ADRskills/documentation-and-adrs/SKILL.md 的重心在为什么架构决策记录ADR、API 文档、内联文档标准。做架构决策、改 API、发功能时同步记录后人才知道这段设计当初为何存在。代码即负债废弃与迁移skills/deprecation-and-migration/SKILL.md 从一个立场出发留下的每行代码都是成本。它区分强制废弃与建议废弃给出迁移模式并包含清理僵尸代码的流程。移除旧系统、迁移用户、下线功能时照这套步骤走把影响面压到最小。快速开始克隆仓库然后按 docs/getting-started.md 里的说明配置到你的代理工具git clone https://gitcode.com/GitHub_Trending/agentskill/agent-skills【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考