Skip to content

10.1 周报技能 ​

这一节覆盖什么 ​

写周报是每个打工人的周五保留节目:翻聊天记录、扒便签、回忆这周干了啥,攒一小时凑一篇。自动化社区里有不少「AI 周报」玩法,我们用 dsh 复刻一遍,并且往前多走一步:不只生成一次周报,而是把这套流程沉淀成一个可复用的技能,以后任何会话里说一句「写周报」就能跑。

最终效果:notes/ 目录里躺着每天的随手工作笔记,dsh 通读后汇总成一份四板块周报,然后你把这套 SOP 固化成 SKILL.md 技能,新会话直接复用。

为什么值得复刻 ​

周报类玩法几乎所有办公自动化教程都有,但多数平台只做到「生成一次」。这一节的真正卖点在 dsh 的技能系统:SKILL.md 就是普通文件,放在技能目录里就能被 agent 自动发现和加载。你把个人的汇报格式、口径、习惯写进去一次,它就从「演示」变成了「你的专属助理」。

本节用到三样前面学过的能力:

能力在哪学的在本节怎么用
文件读写Part 2 工作区读入笔记,写出周报和技能文件
工具调用3.2看它怎么读笔记、怎么组织内容
技能系统Part 9创建 weekly-report 技能并在新会话复用

分步操作 ​

第一步:准备样例笔记 ​

在工作区建一个 weekly-demo/notes/ 目录,放几份当天的随手笔记,想到什么写什么,不用整理,越真实越好。本节的样例是周一到周五共 5 份,每份三五行:

text
# 09-01 周一
- 修复登录页超时 bug,原因是 token 刷新竞态,改完自测通过
- 评审了小陈的数据导出 PR,提了 2 个意见(分页和内存占用)
- 客户群有人反馈导出乱码,还没来得及看

第二步:新建会话并授权 ​

新建会话,权限档位选 Workspace Write,要读笔记也要写周报文件。

新建会话并选择 Workspace Write

第三步:粘贴第一条指令 ​

text
工作区 weekly-demo/notes/ 目录里有我本周的 5 份工作笔记,通读后汇总一份周报:
1. 按「本周完成、进行中、下周计划、风险与求助」四个板块组织;
2. 合并同类项,别丢细节,每条写清事项、进展和结果;
3. 保存为 weekly-demo/weekly/2026-W36.md;
4. 最后用三句话总结本周最大的进展。
不要向我提问,直接执行。

粘贴周报指令

第四步:观察工具树 ​

轨迹区里你会看到 agent 逐份读取笔记文件,然后整理归纳、写出周报。散落在 5 天里的同一条线(比如导出功能从「客户反馈乱码」到「演示通过」)会被它自己串起来合并,这正是人写周报时最费脑子的部分。

观察读取笔记的工具调用

第五步:审阅产出 ​

打开 weekly-demo/weekly/2026-W36.md 检查:板块是否齐全、事实有没有被夸大或遗漏、日期和数字是否与笔记一致。AI 写周报最该防的是「脑补」,笔记里没有的进展它替你编出来的话,直接让它改。

审阅生成的周报

第六步:把流程沉淀成技能 ​

跑通一次只是演示,把 SOP 固化下来才是自己的。在同一会话里发第二条指令:

text
把刚才这套周报汇总流程沉淀成一个可复用的技能:在工作区 .agents/skills/weekly-report/ 目录下创建 SKILL.md,写清楚这个技能的用途、输入(weekly-demo/notes/ 下的笔记文件)、输出格式(四个板块的周报)、以及注意事项(合并同类项、不虚构笔记里没有的进展)。以后我在会话里说「写周报」,你就按这个技能执行。

agent 会在技能目录里写出 SKILL.md。这个文件就是普通 Markdown,你随时可以打开手改——把你的汇报口径、常用表述加进去,它就越来越像你写的。

创建 weekly-report 技能

第七步:新会话验证复用 ​

新建一个会话,只说三个字:

text
写周报

如果技能被正确加载,agent 会直接按你定义的格式和路径执行,而不是反问你「什么周报、什么格式」。这一步跑通,技能才算真正长在了你的工作流上。

新会话复用技能生成周报

常见问题 ​

技能文件放在哪里才会被识别? 工作区的 .agents/skills/<技能名>/SKILL.md 是项目级技能,只在这个工作区的会话里生效;用户级目录则跨工作区可用。SKILL.md 是纯文本,用编辑器就能改,不需要任何打包动作。

agent 说「写周报」时没走我的技能怎么办? 新会话里先让它执行「列出可用的技能」确认技能已被收录;没收录的话检查目录名和 SKILL.md 是否在正确位置。再不行就把技能名点出来:「按 weekly-report 技能写周报」。

周报来源只有笔记吗? 不止。工作区里能读到的都可以当素材:git 提交记录、任务清单、会议纪要。在指令或 SKILL.md 里写明数据来源即可,来源越结构化,周报越准。

周报内容会不会被夸大或虚构? 会,这是所有 AI 写作类任务的通病。防线有两个:SKILL.md 里明写「不虚构笔记里没有的进展」;审阅时逐条对照原始笔记,发现脑补立刻让它改。

我的工作笔记会泄露吗? dsh 本地运行,笔记和周报都只存在于你自己的磁盘,模型调用走 API 传输但不落第三方存储。这也是本地 agent 做办公自动化相比云方案的核心优势。

小结 ​

这一节复刻了办公自动化里最经典的周报玩法,并且用 dsh 的技能系统把它从「一次性演示」升级成「可复用的个人 SOP」:先手动跑通,再固化为 SKILL.md,最后新会话一句话复用。这正是 dsh 和普通聊天机器人的分水岭——它不只回答问题,还能把你的工作方式记下来。

下一节,我们复刻一个更有画面感的玩法:先让 agent 发散出一批选题卡,再派多个子代理并行写三种风格,你在同一屏里横向对比着挑。

发现错误?提交反馈 · 欢迎 提 PR 改进本书