做Agent开发的朋友谁懂啊😭 写好的Skill在Trae里稳得一批 原封不动复制到OpenClaw直接翻车 要么加载不出来，要么不会自动触发 输出格式乱飘，折腾半天找不到根源 其实根本不是你写得不好 是俩平台在目录、语法、权限上 藏了一堆私有差异，踩坑太正常了 今天整理亲测有效的通用开发规范 一套文件夹双平台零修改直接用 对齐四层排查标准，新手照着做就行 ✅ 6条通用铁律（必守） ▫️ 命名统一：文件夹小写英文，核心文件严格SKILL.md，编码UTF-8无BOM ▫️ YAML头极简：只留name/version/description三字段，禁用平台私有配置 ▫️ 目录极简：不建.trae/.openclaw私有文件夹，拓展目录用通用命名 ▫️ 纯文本流程：不用平台专属命令语法，全靠自然语言描述步骤 ▫️ 触发通用：场景+口语关键词双覆盖，不靠平台私有触发规则 ▫️ 路径统一：全用正斜杠相对路径，杜绝Windows反斜杠 ❌ 新手5大致命踩坑 1. 写入OpenClaw专属requires字段，Trae直接解析失败 2. 直接复制.trae隐藏文件夹，OpenClaw完全识别不到 3. 用Trae专属!命令语法，OpenClaw当成普通文本 4. 路径用反斜杠，Mac/WSL环境直接解析崩溃 5. 文件夹用中文/驼峰命名，大小写敏感系统加载异常 📝 四层自检法（10分钟排错） ▫️ 文件层：技能列表里能看见吗？→ 检查文件名、路径 ▫️ 触发层：自然说话能激活吗？→ 检查触发描述 ▫️ 优先级层：输出格式统一吗？→ 检查规则冲突 ▫️ 环境层：换设备还能跑吗？→ 检查路径和依赖 💡 亲测通用需求分析Skill源码 完整模板整理在配图里，纯通用无平台专属语法 复制保存直接能用，双平台部署都稳定 部署小提示： Trae放.trae/skills目录，OpenClaw放根目录skills 项目内优先级高于全局，修改不污染全局配置 下篇预告🔜 2个高频核心Skill模板开源分享 拿来就能直接用，关注不迷路～ 你踩过跨平台兼容的坑吗？ 🙋‍♀️ 踩过，折腾好几天｜💬 还没，先收藏备用 踩过的话评论区说说最离谱的是啥～ #AI智能体 #Agent开发 #编程干货 #Skill开发 #Trae #OpenClaw #效率工具 #程序员日常