
20 个 agent-skills 技能实用指南从模糊需求到顺利上线什么时候用哪个【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skillsagent-skills 是一套面向 AI 编码代理的 AI 编码代理技能集它把资深工程师日常依赖的工作流和质量关卡打包成 20 个可直接调用的技能覆盖从需求到部署的全流程。本文不按开发阶段逐个罗列而是按你日常会遇到的痛点场景来组织——需求说不清时、代码写到一半变乱时、上线前最后要查什么——帮你看懂每个技能在什么时候该出场以及怎么把它们串起来。装好之后多数技能可以直接用/spec、/build、/review、/ship这类斜杠命令触发也可以打开 skills/ 目录手动调用某一个。 先做这一步让代理知道技能怎么用using-agent-skills先找到该用哪个技能20 个技能摆在面前代理未必每次都挑得对。这个元技能负责把当前的活儿匹配到对应的工作流上并规定所有技能共用的执行规则避免用错流程或跳步。会话开始时让它先跑一遍比中途发现走错了路再回退划算得多内容在 skills/using-agent-skills/SKILL.md 里。 接到一个说不清的需求时interview-me把一句话需求问成清楚的事需求方常只丢来一句帮我做个 X没人告诉你给谁用、为什么现在做。这个技能让代理一次只问一个问题追问到你真实想要的东西有大约 95% 的把握为止而不是默默替你脑补需求、做出一个方向就错的功能。你只需回一句interview me它就开问。idea-refine先发散再收敛顺便压一压方案方向是对的但想法还模糊这时候急着动手最容易返工。它先帮你把可能性摊开多想几个再收敛到一个并且会主动挑战方案里的假设把漏洞暴露在写代码之前。用帮我压力测试一下这个方案这类话触发它效果最好。spec-driven-development规格先于代码边写边想规格是返工最常见的来源。这个技能要求先写清楚规格再碰代码如果一条需求里其实藏着好几个能独立测试的能力它会先拆成模块地图再逐条写规格防止一个需求悄悄膨胀成一锅粥。搭配/spec命令使用最顺。planning-and-task-breakdown把大任务拆成能动手的清单规格写完了任务还是大到不知从哪下手它会按依赖关系把工作拆成有序的小任务每块都小到可以独立交付让你能判断先做什么、哪些能并行、大概要花多久。对应/plan命令拆完的清单可以直接交给后面的开发技能执行。 写代码的时候一次推进一步接口别乱incremental-implementation一次写一片每片都能跑一口气生成一大堆代码一旦中途出错很难定位也难回滚。它的规矩是一次一片每次变更只碰少量文件、能跑通、先提交这样不管功能多长你随时都能退到上一个稳定点。任务只要涉及多个文件就让代理按 skills/incremental-implementation/SKILL.md 里的切片规则走。api-and-interface-design接口一次设计对少返工接口定得含糊之后每加一个功能都要返工一遍。它约束你设计 REST/GraphQL 端点、模块间类型契约、前后端边界的方式稳定、显式、给变化留余地。设计接口时它会自动被触发动手前也可以打开 skills/api-and-interface-design/SKILL.md 对照着过一遍。frontend-ui-engineering把界面做到生产级代理生成的页面常有一种AI 味通常就缺这一课。它覆盖组件结构、状态管理、响应式布局和 WCAG 无障碍标准目标是页面能在生产环境用而不只是看起来对。建页面、改组件时它会自动触发不需要你手动点名。test-driven-development测试是证据不是装饰代理说应该没问题的时候你凭什么信它强制红绿重构节奏先写测试、看它失败、再写刚好够通过的代码、最后简化。测试先于代码存在代理就没法靠解释蒙混过关回归也能在发生的那一刻被抓住。 出了岔子的时候先找根因别乱试debugging-and-error-recovery从坏了到找到根因测试挂了、行为不对第一反应不该是改代码碰运气。它要求先收集证据、缩小范围再定位真正的根因修完还要验证并防止复发同一个坑就不会踩第二遍。任何 unexpected 的错误都值得先套这套流程。browser-testing-with-devtools看真实页面别信理论上没问题前端问题的真相在浏览器里不在想象里。它让代理通过 Chrome DevTools 直接检查真实页面DOM 结构、控制台报错、网络请求、性能数据都基于实际运行状态说话。需要配置 chrome-devtools MCP 才能用具体步骤见 skills/browser-testing-with-devtools/SKILL.md。✅ 合并之前代码要过的四道关code-review-and-quality合并前的五轴审查代码是代理写的更需要人来审——尤其当它看起来很像对的时候。它从五个轴审查变更让缺陷、安全、性能、可读性、测试覆盖这些维度都不漏。跑/review之前把这条流程走完是合并前最省心的最后一步检查。code-simplification能跑的代码再简化一遍能跑不等于好维护复杂代码往往在不知不觉中积累的。它在行为完全不变的前提下简化代码去掉多余分支、拆掉过长函数、把命名改清楚。你发现某个文件越写越厚的时候就是/code-simplify该上场的时候。git-workflow-and-versioning给仓库留下能读的史提交得随性出问题时追溯全靠翻聊天记录。它规范分支策略、提交粒度、冲突处理和发版时的版本号与 changelog 写法让仓库历史任何时候都读得下去。你每做一次代码变更它其实都在背后生效。security-and-hardening上线前把输入和会话查一遍凡是接收用户输入、管理登录态、调用第三方服务的功能都是漏洞最爱出没的地方。它逐条检查输入校验、会话管理、隐私合规GDPR/CCPA这些项把问题挡在上线之前而不是等漏洞被曝出来再补。处理不可信数据之前值得先翻一遍它的清单。 上线之前最后要查的事performance-optimization先看数据再动手优化没有测量的优化很可能越优化越慢。它坚持先取数定位真正的瓶颈——Core Web Vitals、N1 查询、数据库慢点都在范围内——再针对性下手。对应/webperf命令适合在上线前给整个应用做一次体检。ci-cd-and-automation把重复的活交给流水线每次部署都靠手动操作人越多越容易出事故。它帮你搭好流水线CI 里跑测试和质量关卡部署策略、环境隔离各就各位重复环节全部自动化。第一次搭 GitHub Actions 时照着 skills/ci-cd-and-automation/SKILL.md 的步骤走不容易漏配置。shipping-and-launch分阶段发布留好退路上线不是点一下部署按钮就结束的事。它给你一份上线前检查清单、一套分阶段发布计划还有一条明确的回滚路径——出问题时能体面地退回去而不是硬扛。发布前跑一次/ship整套检查就不用你自己记了。 上线之后让项目活得久一点documentation-and-adrs把为什么写下来代码能看懂但当初为什么这么决策没人说得清——这是长期维护最大的坑。它让你用 ADR架构决策记录的方式记关键决定选了什么、为什么、放弃了什么。新同事和代理下次接手时上手时间会短很多。deprecation-and-migration下掉旧功能别吓跑用户要废弃一个功能最难的是做得不吓人。它走完整流程提前公告、新旧实现并行、引导用户迁移、最后再清理每一步都有明确顺序升级过程有序且可回退。决定砍掉某块旧代码之前先按它的流程估一遍影响面。想自己动手试试的话最快的路径是把整个仓库克隆下来装进你正在用的编码代理之后每次开发就都有一位有经验的同事在旁边把关git clone https://gitcode.com/GitHub_Trending/agentskill/agent-skills克隆后按 docs/getting-started.md 的步骤完成安装不同工具Claude Code、Cursor、Gemini CLI 等在 docs/ 下都有各自的配置指南。【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考