# 把工作记录变成周期周报

先验证一次汇总，再设置周期运行和结果位置。

## 先完成一次手动汇总

在工作区准备本周记录，注明各文件的日期。先在普通会话中运行以下任务，确认材料路径和输出格式都能使用。

```text
阅读工作区内本周的工作记录，生成 weekly-summary.md。
按完成事项、未完成事项、风险和下周计划组织。
每条进展注明来源文件，没有依据的结论不要写入。
没有新记录时说明没有更新，不沿用上周的完成事项。
```

检查周报是否只覆盖所需日期，风险是否有来源。示例使用 Markdown，可在确认格式后改为自己的交付要求。

## 用教学记录检查日期与状态

第一次测试可以使用下面三条记录，指定报告范围为 2026 年 9 月 7 日至 11 日。材料为教学示例。

```text
2026-09-04，旧记录，首页初稿已完成。
2026-09-07，本周记录，首页评审通过，移动端修改尚未完成。
2026-09-09，本周记录，移动端修改完成，测试环境仍未就绪，负责人待确认。
```

周报应把移动端修改列为本周完成，把测试环境列为未解决问题。9 月 4 日的初稿可以作为背景，不能再记为本周新增成果。9 月 7 日的旧状态被 9 月 9 日的记录更新，也不应同时把移动端修改列为完成和未完成。

本例没有给出下周计划，相关栏目应标为待补充。不要为了填满版面，把风险对应的建议写成团队已承诺的计划。

## 明确每次运行覆盖哪段时间

固定周期报告需要说明统计起止日期、采用的时区和材料来源。首次练习使用明确日期；转成长期任务时，再要求根据本次报告日期计算范围，并在报告开头写出结果供核对。

```text
报告按 Asia/Shanghai 的日期统计本周一至本次运行日。
只把范围内的记录计为本周进展，较早记录仅在解释背景时引用。
同一事项按记录日期归并，保留最新状态及对应来源。
没有新记录时说明没有更新，不生成虚构进展。
```

迟到的材料可能改变已生成的报告。补齐记录后先核对原文件，再决定修订该周报告或重新生成；使用外部投递时还要确认是否已经发送过旧版。

## 转成定时任务

进入 **能力 → 定时任务**，创建任务，填写验证通过的指令。选择执行 Agent、调度时区和结果接收会话。指令中使用任务所在机器能读取的路径。

![真实 App 中的定时任务表单](/images/docs/scheduled-task.png)

若每周五 17 时执行，可在 Cron 中填写 `0 17 * * 5`。这里的时间由任务时区解释。保存后核对下次运行时间，不能只看电脑菜单栏时钟。

## 决定文件如何保留

固定文件名适合每次查看最新报告，但会覆盖前次内容。需要保留各周记录时，在指令中要求使用报告日期命名，并注明日期按哪个时区计算。

执行会话和结果接收会话分别决定任务在哪里工作、结果在哪里查看。配置说明见[调度与结果参考](/docs/schedule-reference)。

## 验收首次运行

对这个只在工作区生成文件的任务，可以立即运行一次，检查运行记录和文件内容。如果等待审批，在对应会话处理审批，再核对任务状态。不要反复点击运行来绕过等待。

桌面休眠或退出时，本地任务无法正常在线执行。需要持续值守时，将任务放在长期运行的服务上，并核对服务器是否能读取材料。