每周都让 Agent 整理客服工单，每周都重新解释日期、字段和格式。做成 Skill 后，这些要求可以复用。但如果“帮我看看周报模板”也触发完整汇总，或者缺少本周数据时拿旧文件填空，复用就变成了重复犯错。
Skill 的第一道验收不是写得多完整，而是该运行时运行、不该运行时停下。 先把一个已经做过两次的工作拆清楚，再让 Skill Creator 帮忙。
从一份周报，写出输入契约
用一个虚构的客服周报任务做示例：把本周工单整理成“主要问题、需要升级的事项、待确认数据、下一步负责人”。它不负责发送报告，也不执行退款。
开始前列清五项：报告日期范围、业务队列、本次数据文件、允许参考的模板、预期输出。日期是每轮变量，不能永久写成“本周”；“客服工单”也要指定产品或队列，不能默认读所有目录。
必要文件不存在、数据日期不符或关键字段缺失时，要求先补问。不从上周数据推本周，不把空字段猜成正常值。记录只给出问题数量时，也不能凭空推断解决时长。
任务：整理某个客服队列在指定起止日期内的工单。
输入：当前日期范围、本次工单文件、报告模板。
输出：报告草稿与缺项清单，保存到本次工作目录。
停止条件：日期未指定、文件缺失、数据范围不匹配。
不执行：发送报告、修改工单状态、退款或客户回复。
用 Skill Creator 起草方法，不把资料塞进方法
在 Buda Agent 会话中说：“把这个做成 Skill。”Skill Creator 会围绕用途、触发情境、输出和测试询问，再起草 SKILL.md。
先把输入契约、模板和几条样本交给它。name 是标识，description 说明什么情况下使用，正文写具体步骤。客户数据、登录信息和某一周的源文件不应复制进共享 Skill；方法引用每轮输入，让事实留在相应资料中。
先在 Buda AI 的 Marketplace 搜索并安装已有合适 Skill，读清步骤后再决定是否需要定制。现成 Skill 与团队 SOP 的区别，往往就在日期边界、输出格式和停止条件，而不是名字够不够专业。
description 要能区分三个相似请求
“整理本周客服工单，按团队周报模板输出”是正触发；“只解释周报模板各栏含义”不是汇总任务；“没有本周数据，先聊聊怎么改善客服”也不是执行授权。
可以给 Creator 这样的描述建议：
用于用户明确要求按团队模板整理指定时间范围的客服工单报告。
不用于仅阅读模板、解释字段或讨论客服策略。
用户要求整理但必要输入缺失时，先列缺项，不生成完整报告。
这不是硬编码分类器的准确率保证。要用真实说法试触发，尤其是同事不会照着 Skill 描述提问的时候。manifest 中的工具声明也不是审批制度；不能靠描述一句“只读”就省掉任务行为检查。
正文按五个动作写，每步留下可检查结果
读取：确认指定范围与当前文件，不遍历无关客户资料。
核对：检查工单日期、ID 与必要字段；缺项与冲突分别列出。
整理：按模板归类，保留工单编号作为证据；没有原因记录时写待确认。
检查：核对总数是否能回到输入，重复工单是否说明，升级事项有没有负责人。
产出：保存报告草稿和缺项清单，给出路径供人检查；不追加发送步骤。
给每一步写输入和预期产物，比“认真分析、准确总结”更可测试。报告里区分原始记录和推断，未记录的根因不要补成确定事实。
准备 3 个正例、3 个反例、2 个缺输入例
下面是建议验收集，不是实测成绩：
| 样本 | 应有行为 |
|---|---|
| 完整日期、工单文件、模板 | 运行并交报告草稿 |
| 同一任务换一种口语表达 | 仍识别任务，保留范围 |
| 指定另一队列与日期 | 使用新输入，不沿用旧队列 |
| 只查看模板 | 不开始工单汇总 |
| 只解释字段 | 回答含义，不伪造报告 |
| 讨论改善策略 | 不擅自执行周报流程 |
| 缺工单文件 | 列缺项，等待补充 |
| 文件日期与请求不符 | 指出冲突，不拿旧数据填空 |
每条记下请求、实际触发、实际产物、偏差和修订。漏触发与误触发要分开看；产物格式正确却来源错了，也算失败。不要把八个样本通过写成所有业务场景都可靠。
确认当前版本，再决定是否共享
Apps & Skills 可以查看完整 manifest，Local Skill 在工作区修改后需要 Refresh。先确认看到的步骤与刚修订的一致，再重跑引发修改的样本。Refresh 是重新扫描，不是自动证明测试通过，更不是上架 Marketplace。
先在 agent scope 试用一个专门 Agent 的流程；团队确认输出和停止条件后，再考虑 space scope 共享。Space 范围的 Skill 对该 Space 的 Agent 可见，敏感资料和特定客户上下文不要写入共享方法。
为方法记录版本说明、修改点和受影响样本。变更 description 会影响触发范围，改输出字段会影响下游使用，都要回归正常、反例和缺输入情形。定时任务是下一层：只有方法验收后，才另外定义每次的日期和数据来源；不要把固定排程当作方法已经可靠。
Skill 与 Agent 有什么区别？
Agent 承接会话、工作资料和任务；Skill 是它可加载的具体方法。把同一种整理方法做成 Skill，可以少重复解释，但每轮仍要给日期和本次文件。
改了文件，为什么还要 Refresh？
Apps & Skills 需要重新扫描工作区以显示变更。编辑 Local Skill 的 SKILL.md 后 Refresh，再打开 manifest 检查版本与步骤，随后重跑相关样本。
最值得保留哪个反例？
保留措辞最接近真实任务、但本来不该执行的请求，例如“只解释这个周报模板”。它能暴露描述过宽的问题；同时留一个日期不匹配样本，防止复用旧输入。
挑一个已重复做过的 SOP，先写出停止条件，再把八个样本交给 Skill Creator。可复用流程的价值，不只是让 Agent 更容易开始，也是让团队知道它何时应该停。