用途:为编写工作流(workflow)与技能(skill)文件提供一套简洁、节省 token 的写作标准,优先级为 P0(关键)。目标是防止过度构建,避免后续需要昂贵的优化处理。
主要能力与核心规则:
- 用模板而非示例:工作流只定义结构,不预填数据,数据由 agent 在运行时生成。
- 表格不写示例行:只保留表头加 1 行骨架行,绝不用假数据填充。
- 不写散文式解释:若项目符号或命令能达到同样效果,就删除段落。
- 不预先回答问题:不要记录 agent 将输出的内容,让它自己输出。
- 合并顺序步骤:若两步总是一起发生,就合并为一步。
尺寸限制:工作流 .md 不超过 80 行,超出则把细节提取到 references/;SKILL.md 不超过 100 行,超出则把示例提取到 references/;表格行不超过 8 行;内联代码块不超过 10 行,超出均提取到 references/。
工作流结构(必需顺序):1. 目标(1 句话);2. 步骤(祈使动词 → 命令或清单);3. 输出模板(仅表头,不预填行)。
反模式:不写冗长的步骤前言;不预填报告行;不重复示例(同一概念只保留一种格式);不写“如何做 X”章节(直接给步骤指令);不为显而易见的规则加警告块,> ⚠️ 仅用于真正不明显的风险。
可移植输出契约:使用 feature_status、missing evidence、decision needed 等与适配器无关的表述;在规范工作流中避免运行时特定的工具名、聊天渠道、容器和挂载路径。
保存前快速自检:agent 能否在运行时从上下文重建被删除的内容?若能则删除;每个表格行是否为真实结构而非示例数据;是否有段落可被项目符号列表替代;把内容减半后是否仍足以让 agent 行动。
适用场景:创建或修改工作流文件、技能文件时。限制:资料未提供更多关于具体平台、收费或安装方式的信息。