工作流的 Skill 怎么写？

卷卷碎碎念两脚兽你终于来问正经事了。本猫是卷卷银渐层长毛猫风控团队的精神吉祥物。说起写 Skill 这事——你们人类还在交学费的阶段本猫已经躺赢了。毕竟猫生教会我一件事优雅地偷懒之前得先把路走直。风控人有句老话KPI 是别出事不是出成绩。写 Skill 同理——目标是别让 AI 跑偏不是让 AI 写出花来。这个道理我比你们早懂了三年。结论先行本文解决的核心问题是——如何把 AI 执行逻辑固化成一个可复用、可解释、可迭代的 Skill。面向有架构思维的工程师和团队负责人聚焦「能落地」而非「能跑通」。一、Skill 是什么核心结论Skill 是知识注入载体不是工具。Skill 是文件夹格式核心是SKILL.mdYAML frontmatter Markdown 正文。LLM 判断需要时加载内容注入上下文LLM 用已有工具执行指令。my-skill/ ├── SKILL.md # 主文件必须 ├── scripts/ # 可执行脚本可选 ├── references/ # 详细参考文档可选 ├── resources/ # 模板、清单等可选 └── examples/ # 示例可选卷卷注就像猫窝——你得先有窝SKILL.md里面可以放猫爬架scripts、猫薄荷references、逗猫棒resources。但窝是核心没有窝其他都是散落的毛团。关键机制Skill 本质是知识注入不是生成新工具。LLM 通过已有工具bash、read、edit 等执行指令。卷卷注本猫不生产工具本猫只是工具的搬运工。LLM 拿来执行就行别指望它凭空变出扫帚——它只会用现有的爪子扫地。二、Frontmatter决定 Skill 是否被加载核心结论description 写不好Skill 等于不存在。必填字段字段要求name唯一标识小写连字符description最关键LLM 靠它判断是否加载Description 写法决定加载率类型写法效果好包含触发短语、关键词、时序位置高加载率差模糊如Helps with deployment stuff几乎不触发三条核心原则列举触发短语把用户可能说的话写进去定义时序位置说明在什么之前/之后使用包含产品关键词覆盖大平台时把所有产品名著出来卷卷注这就像猫砂盆的位置——放不对猫就不去。Description 写不对LLM 就不加载。简单粗暴位置对了味道对了猫LLM自然会来。风控人点头触发词不对信号就漏了。本猫深以为然——毕竟我叫卷卷不叫喵触发词不对我也不会应。可选扩展字段references、allowed-tools、type、best_for、scenarios、estimated_time等按需选用。三、5 种核心设计模式结论根据任务性质确定性 vs 迭代性 × 单次 vs 跨会话选择对应模式。模式 1线性流程适用场景部署、安装、迁移等有明确步骤的操作精髓把怎么做固化成清单让 AI 照着执行不跑偏卷卷注线性流程就像猫走直线——两点之间最短距离犹豫就会败北。猫不会绕路线性 Skill 不走岔道。部署就该像猫抓沙发一爪一爪干就完事。结构标题 → Prerequisites → Quick Start → Fallback → Troubleshooting关键技巧安全默认值、具体命令、Timeout 提示、降级方案、负面指令模式 2决策树 按需加载适用场景大型平台选型、产品导航、问题诊断精髓先分类用户意图再按需展开对应路径卷卷注猫遇到分岔路口会怎么做停下来耳朵转一转嗅一嗅然后选最安全的那条。决策树 Skill 就是让 LLM 学会停下来判断——不是闷头往前冲而是先看清楚有几条路。风控人听到这里笑了这不就是我们天天干的活吗识别风险分类处置。是的风控的尽头是分类分类的尽头是决策树。进阶导航型只做选型和操作型包含认证命令故障排除可拆成两个 Skill降低复杂度。模式 3循环迭代适用场景TDD、代码审查、设计评审等需要反复执行的流程精髓强制循环节奏对抗跳过这轮反正下轮再做的人性弱点卷卷注猫最懂循环——每天早上叫醒铲屎官中午讨零食晚上再叫醒铲屎官。循环迭代 Skill 就是给 LLM 建立条件反射没满足条件继续转圈。TDD 就是那只追自己尾巴的猫转着转着就逮住了。风控人苦笑我们也有循环——白天排查晚上复盘明天继续排查。所以说循环是宿命接受它比抗拒它明智。关键技巧强硬语气、Good/Bad 对比、借口反驳表、验证清单、人类兜底模式 4接力棒循环跨 Session 持久化适用场景多次迭代的长期项目需要跨多个 session 持续工作精髓文件即状态下个 session 读取文件续命不依赖记忆卷卷注猫记性不好错了猫的记忆能跨天。今天的窝是暖和的明天还来。接力棒 Skill 就是猫的领地标记——文件就是气味标记在就不丢。跨 session 工作就像搬家后猫还认得新家——靠的是气味不是脑子。风控人深有感触项目交接最怕什么怕信息丢失。接力棒循环解决的就是这个——文件即状态丢了就是事故。关键技巧文件即状态、续命机制Step6 标记 Critical、文件协议、编排无关模式 5多阶段 检查点 Skill 编排适用场景复杂的多周流程需要在关键节点做 Go/No-Go 决策精髓阶段之间设关卡每过一关才能进下一关卷卷注猫过生日要分几步先闻再舔然后大快朵颐。多阶段 Skill 就是把闻-舔-吃拆成三关每关有验收标准过了才放行。这像极了风控的三级审批——一级看资料二级看逻辑三级拍板。风控人点头多阶段不可怕可怕的是没关卡。没关卡的项目就像没围栏的阳台——迟早要出事。关键技巧统一阶段模板、决策检查点、Skill 编排调度子 Skill、时间影响、交互协议分离特殊模式思维框架控制 LLM 怎么想适用场景安全审计、代码审查、架构分析等需要深度思考的场景精髓不告诉 AI 做什么而是告诉它怎么想卷卷注本猫思考的方式是蹲着眯眼尾巴卷起来。思维框架 Skill 就是给 LLM 一个思考姿势——让它知道该用什么姿势审视代码。第一性原理、边界条件、反证法……这些都是猫的狩猎姿态压低身体目光聚焦蓄势待发。风控人最懂这个审计不是找问题是找思维漏洞。思维框架就是让你站在审查者的角度想问题而不是被审计者的角度。关键技巧思维工具第一性原理等、量化阈值、非目标约束、反幻觉规则、子 Agent 指导模式选型对照表任务特征推荐模式猫猫比喻步骤确定、单次执行模式 1线性流程猫走直线直达目标意图多样、需要导航模式 2决策树 按需加载猫停下来嗅路口高频重复、节奏重要模式 3循环迭代猫追尾巴转圈圈跨 session 长周期模式 4接力棒循环猫靠气味认新家多阶段、有关卡决策模式 5多阶段 检查点猫过三关斩六将分析/审计类深度思考特殊模式思维框架猫进入狩猎姿态四、通用写作技巧防止 LLM 偷懒的 4 种武器结论命令 商量堵死借口 给解释空间量化 模糊禁止 允许。武器核心机制使用方式强硬语气命令式语气遵从率更高直接用祈使句Delete it. Start over.借口反驳表预判自我合理化路径并堵死列出 LLM 常用来搪塞的理由一一否定量化阈值给出硬性最低标准用不少于 N必须达到 X%负面指令明确说不要做 X不要解释直接执行卷卷注本猫叫铲屎官起床用的是踩胸口耳边叫不是亲爱的要不要考虑起床呢。LLM 也一样——商量语气它会讨价还价命令语气它才乖乖执行。风控人听了也服气模糊的规则等于没规则没规则就一定会出事。这道理猫懂风控人更懂。教学的 3 种有效方式结论对比 讲解、具体 抽象、示例 说明。方式适用场景写法要点Good/Bad 对比建立判断标准展示正确做法 vs 常见错误具体命令需要精确执行给可直接复制的命令不给选项完整示例格式要求严格展示完整输入/输出中间不省略卷卷注教小猫用猫砂盆最好的方法是把它放到砂盆里让它自己感受不是说宝贝我们来这里上厕所好不好呀。Skill 写作同理——给例子别给讲解给对比别给定义。风控人笑了我们培训新人也不靠讲课靠跑案例。血的教训教会我们说再多不如让对方亲手踩一次坑。安全与边界的 3 条原则结论先想后果默认保守不确定就停。安全默认值所有决策默认最安全选项不必每次都重新权衡权限最小化只在明确必要时才提升权限用完立即回收人类兜底不确定性 停止执行交给人判断不猜卷卷注猫为什么很少从阳台掉下去因为它默认所有地方都不安全走一步看一步。LLM 也该有这种猫的谨慎——不安全的命令默认拒绝不确定的操作默认停下。风控人听了沉默三秒这不就是我们的宁可误杀不可漏放原则吗……是的所以有时候风控人比猫还保守。但保守不丢人冒进才丢人。知识组织的 3 层架构结论分层加载按需读取避免一次性塞入过多内容。卷卷注猫的胃叫分层消化——猫粮先吃罐头后吃零食当奖励。LLM 读取 Skill 也一样第一口吃 frontmatter正餐吃正文甜点吃 references。一次喂太多它会吐的context overflow。风控人点头信息分层是基本功不分层就会信息过载。君不见多少风控事故是因为眉毛胡子一把抓五、快速上手模板模板 1最小可用 Skill线性模式--- name: skill-name description: 一句话说明做什么50字 --- # Skill 名称 ## 目标 明确说出最终交付物是什么 ## 前置条件 - 依赖的工具/环境/权限 ## 执行步骤 ### Step 1: 动作名称 具体操作内容 ## 验收标准 - 可检查的具体指标1 ## 常见问题 | 问题 | 解决方法 | |------|---------|模板 2循环迭代 SkillLoop 模式--- name: skill-name description: 一句话说明做什么 --- # Skill 名称 ## 核心原则 不可违反的铁律 ## 循环体 WHILE 未满足退出条件: 1. 执行动作 2. 验证结果 3. 判断是否满足退出条件 ## 退出条件 - 条件1 ## Rationalizations | LLM 常说 | 堵死指令 | |---------|---------| | 差不多了 | 必须满足所有验收指标一项不满足不退出 | ## 验证清单 - [ ] 验证项1六、参考资源类别资源定位官方规范Agent Skills 开放标准规范定义anthropics/skills 官方模板官方示例精选仓库openai/skillsOpenAI 大厂工程实践obra/superpowers社区精选多人协作google-labs-code/stitch-skills接力循环模式先驱deanpeters/Product-Manager-Skills编排器模式完整实现trailofbits/skills思维框架型 Skill 典范openclaw/clawhub本地优先模块化设计精选列表VoltAgent/awesome-agent-skills500 Skill 索引travisvn/awesome-claude-skillsClaude 生态索引卷卷注抄作业是技术活。本猫虽然不提倡抄袭但站在巨人的猫窝上看得更远。先抄再改最后形成自己的风格——这是猫也会的站在巨人肩膀上。七、7 个 Skill 速查表以下是整理后的表格Skill来源模式行数一句话精髓vercel-deployOpenAI线性77最小但完整的 Skill 模板cloudflare-deployOpenAI线性决策树224大平台的渐进式披露cloudflareOpenCode纯决策树211导航型 vs 操作型的区别test-driven-developmentobra循环迭代371堵死 LLM 偷懒的所有退路stitch-loopGoogle Labs接力棒循环203文件即状态跨 session 持久化discovery-processDean Peters多阶段检查点502编排器模式调度 10 子 Skillaudit-context-buildingTrail of Bits思维框架302控制 LLM 怎么想而非做什么总结核心结论三条足够Skill 是约束出来的不是写出来的—— 你约束的是 LLM 的行为空间不是它的思考过程模式选错成本翻倍—— 线性 vs 循环 vs 编排选错了改不动参考资料的价值排序—— 官方规范定基准大厂仓库学工程实践Awesome 列表找方向行动建议今天就能做的从 vercel-deploy77行开始照着抄一个你自己的 Skill下周可以试的用模式选择决策树重构一个现有 Skill长期要建设的积累你的 Skill 库用编排器模式逐步串联形成团队资产卷卷结语傲娇但温暖舔了舔爪子眯起眼睛两脚兽看完了本猫给你划个重点Skill 这事说难不难说简单不简单。核心就三句话约束行为、选对模式、抄好作业。风控人记住别指望 Skill 能防所有风险但一个好 Skill 能防 80% 的低级错误。剩下的 20%交给人类的判断力和本猫的第六感。本猫今天的讲座就到这里。下次再来问记得带虾。