明明写了很长的 Skill 提示词,AI 跑起来还是自顾自地乱编格式?
这大概是每个刚接触 Agent Skill 开发的人最让人抓狂的瞬间。你以为你写了个高级自动化技能,结果发现它是个听不懂人话的大聪明……
这不刚好,这两天我在网上冲浪的时候,了解到了谷歌官方发布在 X 上的一篇硬核文章,原文标题叫:《5 Agent Skill design patterns every ADK developer should know》(每个ADK开发者都应该知道的5种Agent skill设计模式)。

经过我的一番啃读学习,就赶紧想着来用这套顶级架构思维优化一下我的那些“屎山” Skill。
今天这篇,我不讲空洞的理论,直接把我在 Trae 里重构公众号写作和微信排版 Skill 的全套实操细节盘盘道道。(P.S. 文末准备了谷歌原版内部架构指南和我自己手搓的重构源码,一定要看到最后!🎁)
emmmm,这么说吧,我刚开始搞那个微信排版小助手的时候,为了不让它输出<style>标签,为了让它记住极客蓝的色号,我在 Prompt 里写了至少 5 遍绝对不要和必须遵守。
结果一运行,得,白来一趟,还是给我生成了一堆乱七八糟的内联样式,甚至还加了微信根本不支持的伪元素。

我淦,这种失控感真的太痛苦了……
大多数人的做法是:继续在原来的 Skill 文件里加补丁。加到最后,把一个SKILL.md写成了一百多行的屎山——文风设定、HTML 限制规则、颜色代码、案例参考全挤在一起,连自己都看不懂,AI 更是被绕晕了。
💡 核心洞察: 其实,需求分为想要和需要。你想要的是 Skill 听话,但你真正需要的是一套解耦的架构系统。不要把所有的规则、模板、设定全硬编码在一个文件里!
今天我直接拿自己的公众号文章架构师 (article-architect)开刀,按照 Google Cloud Tech 提出的 5 大设计模式,做了一次彻底的模块化解耦。
别急着敲键盘让AI开干,来看看我是怎么一步步把散装提示词变成特种兵工作流的⬇️⬇️⬇️


以前我的大纲助手,只要我发个你好,它就开始长篇大论瞎编主题。这次重构,我在流水线的第一阶段加上了强力门控:
强制询问指令: 绝对禁止在没有完整收集用户输入的情况下开始工作!你必须先问我三个问题:核心主题是什么?目标痛点是什么?交付福利是什么?
这就叫反客为主,不拿到关键信息,绝对不准开工。
这是最核心的解耦动作。我把原本臃肿的SKILL.md掏空,新建了一个assets文件夹。
assets/style_guide.md。assets/outline_template.md。然后,在 Skill 的第二阶段,我要求 Agent 必须先调用读取工具,把这些外部资产加载进大脑,再去执行生成。这就相当于给员工发了独立的操作手册,代码和配置完美分离!

为了让 AI 学会我的碎碎念和吐槽,我单独建了一个reference/examples.md,把过去写的含有诶嘿、doge等语气词的爆款段落塞进去。让它在生成时进行 Few-Shot 模仿,文风再也没跑偏过。
AI 犯错不可怕,可怕的是它不自知。我为它专门定制了一份assets/review_checklist.md。
现在,它在把大纲发给我之前,必须在后台静默思考,自己给自己打分:是不是带了违禁词?是不是没有加粗?只要有一项没通过,它就会在后台自己重写,直到全绿才输出给我。这直接砍掉了我 80% 的返工时间。
当你看着重构后的 Skill 乖乖地按照清单一步步打分,遇到错误自己悄悄修改,最后完美输出你想要的格式时,那种感觉……诶嘿,你还真别说,一下子不再无措了。这种降维打击的掌控感,真的爽。
但这还不够。跑通这套逻辑后,我直接用魔法打败魔法,手搓了一个名为skill-architect的首席架构师技能!


这个技能的作用只有一个:帮我重构其他所有的旧 Skill。
我只要把那个一百多行的微信排版屎山文件扔给它,它就能自动帮我分析痛点,在后台自动创建assets等目录,把颜色规范和微信 HTML 限制自动拆解成独立文件,最后还我一个清爽的流水线调度器。几秒钟的时间,鸟枪换大炮。
这就是我要说的核心洞察:真正的提效不是掌握了多少提示词技巧,而是建立了一套可以自动运转的工作流。