Agent Skills:把资深工程师的那套流程,装进 AI 编程代理里
一、问题是什么
AI 编程代理写代码的质量,波动大得离谱。
同一个模型,你让它改一个函数,它可能一次就对,也可能推倒重写三个文件、顺手改掉两个不相关的模块、最后还告诉你「顺便优化了一下结构」。这种波动不是模型能力问题,是流程问题——它没有被要求先想清楚再动手,也没有被要求改完自己验证。
人的团队是怎么解决这件事的?靠流程。需求先写清楚,再拆任务,写测试,实现,跑验证,评审,最后才合。这套东西在成熟团队里是默认的,但你在对话框里跟 AI 说「帮我改一下这个」,它拿不到这套默认。
Agent Skills 就是把人类团队那套流程,做成代理能直接装载的技能包和命令集。它不是提示词模板,而是一套阶段化的操作规范。
二、核心设计:六个阶段,每个阶段有对应的命令
它的结构是一条线:定义、计划、构建、验证、评审、交付。每个阶段对应一个命令,你按阶段推进,而不是一句话丢过去等结果。
定义阶段落的是规格:要做什么、不做什么、验收标准是什么。计划阶段把规格拆成可独立验证的任务。构建阶段逐条实现,每实现一条先写测试。验证阶段跑测试和检查。评审阶段过一遍质量与安全。交付阶段处理版本与发布。
这条线的价值在「不可跳步」。你自己写代码时可以随手跳过测试,但在这套流程里,测试通过是进入下一阶段的必要条件。它把资深工程师的肌肉记忆变成了对代理的强制约束。
它还专门做了一个「怀疑驱动」的技能——遇到不确定的地方,先证伪再实现,而不是猜一个方案往前冲。这一条针对的正是 AI 最常见的失败模式:它总能给你一个看起来合理的实现,而你看不出哪里错了。
三、功能拆解
技能数量是二十五个,覆盖的面比想象中宽:接口设计、浏览器调试、持续集成、代码评审、代码简化、约束驱动开发、上下文工程、调试与错误恢复、弃用与迁移、文档与决策记录、怀疑驱动开发、前端工程、版本控制、想法打磨、增量实现、反向访谈、可观测性、性能优化、计划与任务拆解、安全加固、上线发布、源头驱动开发、规格驱动开发、测试驱动开发、以及技能自身的用法说明。
除了技能,它带四个「人设」:代码评审员、安全审计员、测试工程师、网页性能审计员。这四个不是技能,是可以被指派做独立复核的角色——相当于给你配了四个只挑刺不动手的同事。
命令有九个,是技能的快捷入口:出规格、出计划、构建、测试、评审、上线、简化、查约束、查性能。
还有一个「反向访谈」的技能值得单说:在你描述需求之后,它反过来问你问题,把没想清楚的地方问出来。这个方向是反直觉的——大多数工具在拼命减少交互,它在增加必要的那几轮。
四、适合谁、不适合谁
适合的:在用代理写「要长期维护的代码」的人;团队里已经有流程、想让代理也遵守同一套流程的人;以及被「它改完我看不出对不对」折磨过、想要机器可验证的通过条件的人。
不适合的:写一次性脚本、跑完就扔的场景——走完整流程是纯粹的负担;已经在用别的流程框架、不想再叠一层的人;以及只想要「更快出代码」的人,这套东西在某些阶段是主动变慢的。
五、诚实提醒
第一,它是流程不是能力。装上之后代理不会变聪明,它只是被要求按部就班。如果你的需求本身就模糊,流程只会把模糊放大成更多轮返工。
第二,单装一个技能会缺共享文件。官方在问题列表里写明了这一点:只装某一个技能时,仓库层面的共享清单不会跟着装,那个技能引用的检查项会找不到。要么整套装,要么装完自己补。
第三,命令可能和编辑器内置命令重名。官方给的做法是加命名空间前缀。第一次用如果命令没反应,先查这一点。
第四,二十五个技能不是都要用。多数人最后常用的就四五个。全都开着的后果是每次对话都被塞一大堆规范,反而拖慢。
第五,它是给「有测试文化」的场景设计的。团队里没人写测试,这套流程里的验证阶段会变成形式主义——测试文件写了但不跑,或者跑了但不看结果。
六、项目现状
实测版本 0.6.16。仓库结构是技能目录二十五个、人设目录四个、命令目录九个。分发有两条路:一条是通用的技能安装器(可以列清单、可以单装),另一条是主流代理的插件市场。项目由一位在前端性能领域有长期公开输出的工程师维护,文档的组织方式能看出来是有意做成「可教学」的。
七个阶段对应六条命令这条线写得比较清楚,仓库首页有阶段图。学习成本主要不在装,在读——二十五个技能全读一遍要几个小时。
七、常见问题
问:它和提示词模板有什么区别
答:模板是一次性的文本,它是带阶段、带命令、带通过条件的结构。最大的差别在验证环节:模板不会要求你先写测试。
问:装了之后代理会不会变慢
答:会。它主动增加了「先想清楚」和「改完验证」这两步。省下来的是返工时间,不是首次出码时间。
问:必须整套装吗
答:推荐整套。单装会缺仓库层面的共享文件,那个技能引用的检查清单会找不到,官方文档里写明了这个限制。
问:命令敲了没反应
答:多半是和编辑器内置命令重名了。加命名空间前缀再试。
问:它管得住代理乱改文件吗
答:管得住一部分。计划阶段会把改动范围定下来,评审阶段会检查越界。但如果代理不遵守,最终还是你看 diff。
问:适合什么规模的项目
答:适合要长期维护的项目。一次性脚本、几百行的工具,走这套流程的收益抵不上时间成本。
下载地址
夸克网盘(永久有效):https://pan.quark.cn/s/290b9dabd09d
本教程由「宝藏星球屋」整理,更多软件、游戏、开源项目都在 https://cbge.top。






















暂无评论内容