aionclaw调用skill后必须严格按output_schema输出:确认skill状态为「已就绪」,base url设为https://taotoken.net/api并配置有效api key;修改skill.md中output_schema为yaml强约束或引用json schema;重启客户端后触发skill,返回首行为json即生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让AionClaw调用Skill后,每次输出都严格遵循你设定的字段、顺序、标点和层级结构,而不是自由发挥生成散文式回复——比如要求“提审自查报告”必须含【风险项】【复现步骤】【影响范围】【修复建议】【验证方式】五个一级标题,缺一不可,且每个标题下不得出现额外解释性段落。
确认Skill已加载并绑定正确模型通道
打开AionClaw客户端→点击左下角「工具管理」→在「已启用技能」列表中找到目标Skill名称,确认其状态为「已就绪」;若显示「未响应」或「加载失败」,需先检查模型通道是否已切换至TaoToken:进入「个人中心」→「模型设置」→将Base URL设为【https://taotoken.net/api】,并粘贴从taotoken.net获取的有效API Key。
这一步漏做会导致Skill虽被调用,但底层模型仍走默认缓存路径,输出格式完全不受SKILL.md约束。
修改SKILL.md中的output_schema字段
定位到该Skill本地目录(默认路径:~/AionClaw/skills/your-skill-name/SKILL.md)→用文本编辑器打开→查找output_schema段落。
方法一:直接覆盖式声明(推荐新手)
将原有output_schema内容全部删除,替换成YAML格式的强约束定义:
output_schema:
type: object
properties:
risk_items:
type: array
items:
type: string
reproduce_steps:
type: string
impact_scope:
type: string
fix_suggestion:
type: string
validation_method:
type: string
required: [risk_items, reproduce_steps, impact_scope, fix_suggestion, validation_method]
方法二:引用外部JSON Schema文件(适合多Skill共用同一模板)
在output_schema行后添加:file: ./schema/official_audit_v2.json,并确保该JSON文件存在于同级schema目录中,且包含完整required字段与type校验。
强制Agent按Schema执行输出
第一步:重启AionClaw客户端,使SKILL.md变更生效。
第二步:在对话框中明确触发该Skill,例如输入「执行小程序提审自查」;
第三步:观察返回结果——若首行出现JSON格式字符串(如{"risk_items":[...]}),说明Schema已生效;
第四步:若仍返回自然语言段落,立即检查SKILL.md中是否遗漏了【output_schema】关键词(注意大小写与下划线,不可写作output-schema或OutputSchema)。
这一步不重启,修改永远不生效;重启后仍无效,90%概率是output_schema缩进错误或required字段拼写偏差。











