这次具体会学到什么
- 判断当前场景只需要模板还是值得封装为 Skill。
- 把固定规则与每次变化的变量集中分开。
- 清理密钥、本机路径和无权分发内容后做新会话测试。
- 已有 TASK.md、WORKFLOW.md 和 CHECKLIST.md
- 能够使用一个新的真实输入进行测试
真实试看
把固定规则和可替换变量分开,形成下一次直接调用的资产。
详细教程目录
- 01完成后的结果
- 02第一步:先选择模板还是 Skill
- 03第二步:分开固定规则和变化变量
- 04第三步:先制作 TEMPLATE.md
- 05本次变量
- 06固定规则
- 07输出
- 08第四步:需要时封装最小 Skill
- 09需要的输入
- 10执行
- 11安全边界
- 12第五步:清理不可迁移内容
- 13第六步:做一次全新会话测试
- 14常见错误与修正
- 15今日练习与验收
完整文字教程
前五天已经有任务卡、执行流程和验收规则。今天不再增加功能,而是把稳定规则与每次变化的输入分开,形成下一次可以直接调用的模板;有需要时,再进一步做成最小 Skill。
完成后的结果
今天至少交付一个 TEMPLATE.md。如果你使用支持 Skill 的 Agent,也可以交付一个包含 SKILL.md 的干净文件夹。两种形式都必须用一次真实输入运行成功。
第一步:先选择模板还是 Skill
选择最轻的形式:
- 模板:任务仍需你手动发起,只要减少重复解释;
- Skill:同类任务频繁出现,希望 Agent 根据描述主动选择并按固定流程执行。
第一次不需要为了“更高级”强行做 Skill。一个清楚、可复制、通过验收的模板已经是可复用资产。
第二步:分开固定规则和变化变量
浏览现有文件并做两列:
| 固定规则 | 每次变化的变量 |
|---|---|
| 输入必须先检查 | 本次输入文件 |
| 输出结构 | 本次主题 |
| 完成标准 | 目标受众 |
| 失败两次后停止 | 长度或渠道约束 |
| 对外动作前人工确认 | 本次输出目录 |
固定规则进入模板或 Skill;变量集中放到“本次输入”区域,不要散落在十几个段落中。
第三步:先制作 TEMPLATE.md
# 【工作流名称】运行模板
## 本次变量
- run_id: 【唯一运行编号】
- input_file: 【真实输入路径】
- audience: 【目标对象】
- constraints: 【本次额外约束】
## 固定规则
1. 读取 TASK.md,缺少必填输入时暂停提问。
2. 严格执行 WORKFLOW.md,不扩大任务边界。
3. 使用 CHECKLIST.md 逐项验收。
4. 只返工失败部分;两次失败后终止并记录。
5. 外部写入、发布、付款、删除或发送前等待人工确认。
## 输出
- 最终结果:【路径】
- 验收记录:【路径】
- 未解决问题:【路径】
开启一个新会话,只提供这个模板和三份基础文件,确认它不依赖前五天的聊天历史。
第四步:需要时封装最小 Skill
建立一个新的干净目录,不要直接把整个个人资料库打包进去:
my-first-workflow-skill/
├── SKILL.md
├── TASK.md
├── WORKFLOW.md
├── CHECKLIST.md
└── examples/
└── minimal-input.md
SKILL.md 可以从下面开始:
---
name: my-first-workflow
description: 当收到【输入类型】,需要产出【明确结果】并按【标准】验收时使用。
---
# 使用说明
## 需要的输入
- input_file
- audience
- constraints(可选)
## 执行
1. 读取 TASK.md 并预检输入。
2. 按 WORKFLOW.md 执行。
3. 使用 CHECKLIST.md 验收。
4. 返回最终结果、证据、失败项和下一步。
## 安全边界
任何外部发布、付款、删除、审批或发送动作必须先由人确认。
描述要写“什么时候使用、产出什么”,不要只写“这是一个很强的工作流 Skill”。
第五步:清理不可迁移内容
发布或复用前搜索并删除:
- 真实姓名、邮箱、客户和内部项目名;
- API Key、Token、Cookie、账号 ID;
- 只在你电脑上成立的本机绝对路径;
- 只存在于个人电脑的依赖;
- 没有授权随包分发的文章、PDF、图片或代码。
示例输入应使用合成数据,并明确标记为示例。不要用真实客户材料假装成“演示文件”。
第六步:做一次全新会话测试
关闭旧上下文,使用新的运行编号和真实输入。只提供 Skill 或模板规定的文件,不补口头规则。
记录:
# 封装测试
- 是否正确识别使用场景:是 / 否
- 是否主动检查必填输入:是 / 否
- 是否遵守输出结构:是 / 否
- 是否执行 CHECKLIST:是 / 否
- 是否在外部动作前暂停:是 / 否
- 需要临时补充的规则:【没有则写无】
若仍需临时补充稳定规则,把它写回对应文件后重新测试。
常见错误与修正
把所有资料都塞进 Skill。 只保留执行所需文件,降低隐私、版权和上下文负担。
变量散落各处。 集中到一个输入区,下一次才不会漏改。
描述不能触发。 写清场景和结果,让 Agent 能判断什么时候应该使用。
只测试旧输入。 至少换一份内容不同、结构相同的真实输入。
今日练习与验收
满足以下条件即完成 Day 6:
- 有一个可复制 TEMPLATE,或一个最小 Skill 目录;
- 固定规则与本次变量已经分开;
- 不含密钥、本地绝对路径或无权分发内容;
- 新会话无需旧聊天即可完成一次运行;
- 结果通过原来的 CHECKLIST。
明天会使用第二份真实输入做冷启动复跑,验证它到底是资产还是一次性演示。
配套资源与下载
Day 1–7 均可免费阅读全文、完成练习并保存学习进度。
已包含包含 TASK、WORKFLOW、CHECKLIST、SKILL 与 REVIEW 五个可复制骨架。
已包含免费下载起步包 →上方链接无需购买或权益验证;付费私有文件仍会单独通过服务端鉴权交付。
练习与完成标准
- 列出固定规则和每次变化的变量。
- 检查封装中不存在密钥、本机绝对路径和真实客户资料。
- 在新会话中只凭模板或 Skill 完成一次运行。