WorkBuddy 执行异常主因是 SKILL.md 结构不匹配 AI 读取逻辑；需用 YAML 元数据锚定触发与边界，description 限 80 字含触发词+禁止动作，name 简洁如“每日线索巡检”，正文严格三段式：①【何时用】、②【怎么干】、③【红线】，关键红线前置并用 > ⚠️ 全大写强化。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你花一小时写完 SKILL.md，却发现 WorkBuddy 总是只执行前两步、跳过关键校验或漏掉红线条款，问题往往不在模型理解力，而在文档结构本身——AI 读取时会优先抓取开头和加粗项，长段落中埋着的限制条件极易被忽略。
用 YAML 元数据锚定触发与边界
在 SKILL.md 开头的 YAML 区域，【description 字段必须控制在 80 字以内，且包含明确触发词+禁止动作】。例如写成：“当用户说‘线索巡检’‘整理今日 lead’时启动；不报价、不代发、不处理昨日数据”。这行文字会被 WorkBuddy 在首轮匹配时完整载入上下文，而正文里写三页“注意事项”它根本不会读。
name 字段别写“线索处理V2.3_优化版”，就写“每日线索巡检”。名称越短，加载越稳。
正文分层：三段式强制切分
SKILL.md 正文严格按以下顺序组织，中间不加空行：
① 【何时用】（1–2句话）：只写触发场景，不解释原因。例：“仅用于当日新增销售线索，来源必须是 CRM 导出的 Excel 文件。”
② 【怎么干】（带编号步骤）：
1. 读取 ./data/leads/today.xlsx，字段必须含「公司名」「联系人」「首次触达时间」；
2. 调用 Python 脚本去重并打 ICP 分数，输出 reviewed.xlsx；
3. 在 A 列插入「优先级」标记：分数≥85 为 A 级，40–84 为 B 级，＜40 标「待排除」；
4. 生成话术草稿，末尾固定加「请审核后手动发送」。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
③ 【红线】（单独成段，每行一个不可妥协项）：
首触客户禁止出现价格数字
同行公司名称出现在 ./bank/rival-list.txt 中则整行标红不输出
脚本运行失败时立即中断，不生成任何中间文件
关键规则前置+符号强化
把最易被跳过的硬性约束，从正文里拎出来，放在 YAML 下方第一行，用 > 符号缩进+全大写强调：
> ⚠️ 红线前置：不报价｜不代发｜不处理非今日数据｜不调用外部 API
这行内容紧贴 YAML 结束符，会在所有技能加载阶段被强制注入初始上下文，比藏在正文第 17 行的“请注意…”管用十倍。
不要给每条红线加解释。解释越多，AI 越容易挑着读——它默认“带句号的句子是结论，带冒号的段落是说明”，而说明部分常被跳过。
