给AI写skill，大概率撞两堵墙：它压根不用你的；或用了输出差很远。只能不停加"必须""禁止"，越加越玄学。 拆范本。skill-creator是WorkBuddy内置的"教AI写skill的skill"，它把方法论写进了自己的实现，言行一致。倒推6条原则： 📌 三层加载 skill-creator把主流程写在SKILL.md，打分细则拆到agents/grader.md，格式规范拆到references/schemas.md，正文留指路牌"需要打分时去读grader.md"。正文压500行内，细节拆出去留指路牌。 📌 description是触发开关 AI不用你的skill，多半是名片没对上。skill-creator内置run_eval.py，拿真实问法各跑3次算触发率，再喂失败案例改写描述。还设1024上限防名片太长。不用搞脚本，写清"做什么+何时用我"，用用户说法，宁可主动。 📌 讲为什么，少下死命令 skill-creator全大写硬命令只留一处：先把测试结果摆到人面前再动手改。其余规则都讲理，不写"必须用pdfplumber"，而是写"因为它对表格处理更稳，扫描件改走OCR"。 📌 防过拟合 每翻车就加特例，skill越来越脆。skill-creator的1024字符上限本身就是防overfit的物理护栏，不让你堆特例清单，逼你归纳通用表达。加规则前问：通用原则还是只救眼前一个case？ 📌 确定的事交给脚本 skill-creator把格式校验(quick_validate.py)、打包(package_skill.py)、结果聚合(aggregate_benchmark.py)全固化成脚本。发现AI反复写同一个辅助脚本，就该固化进scripts/。 📌 闭环验证 skill-creator整个流程的主心骨是"写场景→AI跑→人看→改"循环，全大写强调先让人审。轻量版：3个真实场景亲手跑自己看。别用空泛测试，别让AI自己说"行了"。 写skill是替未来对话备一份会被翻到、读得懂、能照着做、靠谱的经验手册。 #AI技能开发 #skill编写 #AI工具 #效率提升 #AI实战 #howto手搓skill 写skill卡在哪步？评论区聊聊。