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模式对话窗口。
