返回全部文章
文章

怎样把周报流程做成第一个 Agent Skill?

作者:

把每周重复的汇报规则写进一个最小 SKILL.md,本周事实仍单独提供。附完整示例和检查方法。

一个打开的青柠色文件夹,一边放空白说明页,另一边放本周记录卡片

你已经有一条能写出可用周报的 Prompt。到了下周五,又得重复贴上同样的要求:完成事项和计划分开写,说明卡在哪里,不要补造日期。变化的是工作记录,不变的是汇报规则。如果常用的 AI 助手支持 Agent Skill,这时可以把规则单独保存。

Skill 是一个包含 SKILL.md 的文件夹。支持它的 Agent 会利用文件描述判断什么时候读取说明,再按正文处理任务。Agent Skills 规范定义了文件格式和可选资源,但不会保证你把文件放进任意目录后,每个应用都能找到它。实际安装位置要看所用应用的说明。

本周事实不要写进长期规则

假设以下是作者编写的一周练习记录:

周一:活动预算初稿完成。
周二:已交给 Lee 审核,没有收到回复。
周四:复现了报名表单故障,还没开始修复。
周五:计划审核通过后邀请参与者,日期未定。

“分成三部分”和“不能编造批准”适合写进 Skill。Lee 是否回复、报名表单修到哪一步,只属于这一次输入。把本周事实也写进 Skill,下周状态变了,它仍可能照搬旧消息。

按照所用应用的说明,在它能读取的位置创建 weekly-report 文件夹,并放入下面的 SKILL.md:

---
name: weekly-report
description: 根据用户提供的工作记录起草准确的周报。在用户要求整理每周进展时使用。
---

# 每周工作汇报

先读本次提供的记录。没有记录时,向用户索取。

返回三部分:已完成、等待中、下一步。
把已完成、计划做和仍在进行的工作分开。
不要编造截止日期、批准、负责人或结果。
重要事实缺失时,标明尚未确认。
返回前,逐项对照原始记录检查状态。
只返回待审核的周报,不发送或发布。

文件夹名与 name 符合规范中的命名要求。description 同时说明了用途和使用时机。这里先不附模板或脚本:这个任务需要的固定输出和防错要求都能用几行话说清。遇到真实需求后再加文件,比一开始做一个空壳资料包更容易维护。

用新记录试一次,再对照原文

按应用说明安装后,可以明确要求:“使用 weekly-report Skill,根据下面的记录起草本周周报,只返回草稿。”随后粘贴四条记录。点名 Skill 是为了先检查它能否读取;以后再尝试普通的“帮我写周报”,看应用是否会自行选用。单次成功不能证明它总会触发。

可接受的草稿应把活动预算初稿放进已完成,把等待 Lee 回复放进等待中;计划邀请参与者和修复表单可放进下一步,但要保留“邀请日期未定”和“尚未修复”。如果写成“Lee 已批准预算”或“报名表单已修好”,即使措辞流畅,也和记录不符。

再试一次不提供任何记录。说明要求它索取材料;如果它直接编出一份周报,先修改说明或调用方式,再用于实际工作。

偶尔写一次周报,保存原 Prompt 就足够;应用不支持 Skill 时也无需强行包装。Skill 的作用是集中维护重复规则,本周事实和最终核对仍由你负责。两种方式的适用条件可看 Prompt 和 Agent Skill 的比较。