WorkBuddy的Skill需通过SKILL.md中inputFiles字段声明文件要求,用标准MIME类型指定类型,constraints约束多文件逻辑,examples提供输入范例,且仅Craft模式生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

WorkBuddy的Skill在处理文件类任务时,必须明确告诉AI“该读哪个文件”“文件长什么样”“哪些字段不能丢”,否则它可能随机选一个附件、跳过图片里的文字、或把PDF表格拆成乱码段落。定义输入文件要求不是写备注,而是通过结构化指令让Skill具备稳定识别能力。
在SKILL.md中用inputFiles字段声明
打开你的Skill根目录下的【SKILL.md】文件,在YAML元数据区块(---开头和---结尾之间)添加inputFiles字段。
例如,一个处理合同扫描件的Skill需强制要求用户提供带公章的PDF:
```yaml
inputFiles:
- name: contract_pdf
type: application/pdf
required: true
description: 必须是含红色公章的扫描版合同PDF,不接受Word或网页截图
minSize: 100KB
maxSize: 50MB
```
type值必须使用标准MIME类型,比如image/png、text/csv、application/vnd.openxmlformats-officedocument.spreadsheetml.sheet(xlsx)。错写成.xlsx或xlsx文件会导致Skill完全无法识别上传的Excel。
用constraints约束多文件组合逻辑
当Skill需要同时处理多个关联文件(如一份原始日志+一份字段映射表),仅靠inputFiles声明不够,必须加constraints说明它们之间的关系。
方法一:指定文件配对规则
在inputFiles下方新增constraints区块:
```yaml
constraints:
- type: filePair
files: [raw_log, field_mapping]
rule: "field_mapping中的列名必须全部出现在raw_log的首行标题中"
```
使用 draw.io(.drawio 格式)和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发: - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
方法二:限制上传顺序
某些Skill依赖先传模板再传数据,可在constraints中写明:
```yaml
constraints:
- type: uploadOrder
sequence: [template_docx, data_csv]
message: "请先上传Word模板,再上传CSV数据表,顺序错误将导致格式错乱"
```
【注意:constraints只在Craft模式下生效,Ask模式中用户提问时不会触发校验】
用examples提供可立即复用的输入范例
第一步:在SKILL.md正文末尾新增## 输入示例小节。
第二步:粘贴真实对话片段,包含用户上传动作和紧随其后的指令:
```markdown
## 输入示例
✅ 正确示范:
- 用户拖入文件:`Q3_sales_summary.xlsx`(大小:2.1 MB)
- 紧接着输入:"按region分组汇总销售额,导出为带柱状图的PPTX"
❌ 错误示范:
- 用户只输入:"帮我分析销售数据" → 没有上传任何文件
- 用户上传了`sales.png`截图 → 类型不匹配,Skill直接报错退出
```
第三步:保存SKILL.md后重启WorkBuddy,新约束会立刻生效。旧对话不会自动加载更新后的规则,必须新开一个Craft模式对话窗口。

















