一个实用的aionclaw skill必须包含skill.md（含frontmatter元信息、何时使用、输入参数、输出格式）、触发逻辑（triggers关键词）和执行载体（scripts/脚本或纯提示词逻辑），三者缺一不可。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
一个实用的AionClaw Skill应该包含哪些内容
当你在AionClaw里想让智能体稳定复现某项办公动作——比如每天自动抓取竞品价格、按固定格式生成会议纪要、或把微信聊天记录转成结构化待办——光靠临时提示词会越来越难控制输出质量，这时就必须封装成Skill。它不是代码工程，而是把“人怎么做”这件事，用机器能读、能判、能执行的方式写清楚。
核心三件套：SKILL.md + 触发逻辑 + 执行载体
一个真正能落地的Skill，必须同时满足三个条件：AI能准确识别该不该用、知道具体怎么调用工具、最后能返回你想要的格式结果。缺一不可。
第一步：创建技能文件夹，命名用小写字母+连字符，例如daily-price-scan；第二步：在该文件夹内新建SKILL.md，这是唯一强制要求的文件；第三步：根据需要添加scripts/（执行脚本）、assets/（配置模板）或references/（参考文档）子目录。
注意：AionClaw启动时只扫描skills/目录下的第一层子文件夹，不会递归查找嵌套文件夹。如果你把skill放在skills/analysis/price-scan/里，它将被完全忽略。
SKILL.md 必须写清这四块内容
SKILL.md 不是自由写作，而是结构化说明书。它被AI当作“技能档案卡”来读取，顺序不能乱。
① Frontmatter元信息区（YAML格式，必须顶格写，前后用---包围）
这里定义Skill的“身份证”：name（唯一标识，不能有空格和中文）、description（一句话说明用途，AI靠它做触发判断）、user-invocable（true表示用户可直接说“用XX技能”，false则仅Agent内部调用）、triggers（关键词数组，如["查价格","比价","监控竞品"]）。
② 技能说明正文（Markdown格式，必须含三个二级标题）
## 何时使用：列出3～5个典型触发场景，用短句，避免模糊表述。错误示范：“当用户有需求时”；正确示范：“用户发送商品链接并说‘看看今天卖多少钱’”、“用户输入‘对比A/B两款型号’后附上型号编号”。
## 输入参数：明确标注每个参数名、类型、是否必填、示例值。例如product_url: 字符串, 必填, 示例 https://item.jd.com/123456.html。如果参数带校验逻辑（如必须是合法URL），必须写在这里，否则脚本运行时崩溃，AI不会帮你补救。
## 输出格式：限定最终返回内容的形态。不是“返回价格信息”，而是“纯文本，每行一个字段，格式为：【平台】京东｜【型号】X100｜【当前价】¥2999｜【历史最低】¥2780”。【输出格式一旦写死，就不能靠后续提示词覆盖】
要不要加 scripts/？看这个硬标准
方法一：纯提示词型Skill（适合文本处理类）
不放scripts/，全部逻辑写在SKILL.md的“执行步骤”里，靠AI调用内置工具（如浏览器、文件读写、正则提取）。适用场景：整理会议录音文字→提取待办→按模板生成表格。优点是零依赖，部署即用；缺点是复杂逻辑易出错，比如网页结构微调就可能漏数据。
方法二：脚本驱动型Skill（适合确定性操作）
必须放scripts/main.py（或.sh/.js），且SKILL.md中“执行步骤”要明确写出“调用scripts/main.py，传入{input_params}”。脚本里必须做输入校验、异常捕获、日志打印。例如价格监控脚本，必须自己检查HTTP状态码、重试机制、超时中断——AI不会替你补这些。
方法三：混合型（推荐新手起步用）
前半段用AI做语义理解（识别用户说的是哪款产品、要对比几个平台），后半段交脚本执行（调API、解析HTML、查本地缓存）。这样既保留灵活性，又守住结果确定性。AionClaw默认支持Python3、Node.js、bash三种运行时，不用额外装环境。
容易被忽略但致命的两个细节
第一，所有路径必须用相对路径。scripts/main.py里写open("../assets/config.json")会失败，因为工作目录是AionClaw根目录，不是skill文件夹。正确写法是open("skills/daily-price-scan/assets/config.json")，或者统一用os.path.join(os.path.dirname(__file__), "..", "assets", "config.json")。
第二，triggers关键词必须覆盖用户真实说法。别只写官方话术“查询竞品价格”，要加上口语变体：“XX家现在啥价？”、“B站那个同款便宜吗？”、“帮我看看拼多多有没有更低价”。AionClaw的触发匹配是前缀+分词模糊匹配，不是精确字符串比对。
