项目周报自动生成

1. 这个数字员工做什么

项目经理在 IM 中对悟帆说一句"帮我生成本周的项目周报"，或者每周五下午系统自动触发——悟帆从简道云的项目管理表单中拉取本周的任务完成情况、里程碑进展、风险登记、工时消耗等数据，自动做一轮"体检"：哪些任务延期了、哪些风险升级了、整体健康度怎么样，然后生成一份结构清晰、有结论有建议的项目周报，直接发到 IM 聊天里。

以前是"项目经理打开简道云 → 逐张表翻数据 → 手动汇总到 Word/邮件 → 斟酌措辞写分析 → 发给领导"。现在是"说一句人话（或到点自动跑） → 悟帆直接出一份有判断、有建议的周报"。中间全部跳过。

核心价值不只是省时间——更重要的是不会遗漏风险项，格式统一质量稳定，而且悟帆会基于数据给出项目健康度评分和改进建议，这是大多数项目经理自己写周报时做不到的。

2. 适用角色

项目经理、PMO（项目管理办公室）、研发主管、交付负责人、部门总监。

3. 效果预览

4. 简道云侧准备

需要在简道云中准备 4 张表单（如果你已有类似表单，字段对齐即可，不必重建）。

4.1 项目信息表

记录项目的基本信息，是其他表单的"主表"。

4.2 任务进度表

记录每个任务的执行情况，是周报"完成情况"板块的核心数据源。

4.3 里程碑表

记录项目的关键节点，是周报"里程碑进展"板块的数据源。

4.4 风险登记表

记录项目风险，是周报"风险预警"板块的数据源。

提示：以上 4 张表是推荐的最小数据集。如果你还有工时表、缺陷表等，也可以在悟帆的任务指令中一并纳入分析范围。

5. 悟帆侧准备

悟帆需要一份周报生成规范文档，告诉它周报应该长什么样、怎么判断项目健康度、风险怎么分级。这份文档作为悟帆的技能或知识库文件上传。

文档要点（写清楚，不要笼统）：

5.1 周报结构模板

# [项目名称] 周报（第 X 周：MM.DD - MM.DD）

## 一、本周摘要
（3-5 句话概括本周最重要的事情，有结论有判断，不是流水账）

## 二、关键数据
- 本周完成任务：X 项（新增 X 项，逾期 X 项）
- 里程碑进展：[里程碑名称] 当前进度 XX%（计划 XX%，偏差 ±X%）
- 风险数量：高 X / 中 X / 低 X

## 三、风险预警
（按严重程度排序，每条包含：风险描述 + 影响分析 + 建议措施）

## 四、项目健康度
- 综合评分：XX/100
- 健康等级：🟢 正常 / 🟡 预警 / 🔴 告警
- 评分依据：（从进度偏差、风险数量、任务逾期率三个维度说明）

## 五、下周计划
（列出下周最关键的 3-5 项任务/里程碑）

## 六、改进建议
（基于数据分析给出 1-3 条可操作的建议）

5.2 项目健康度评分规则

不要写"根据情况判断"，要写成具体规则：

5.3 写作风格要求

6. 悟帆侧配置

本场景有两种触发方式，分别配置。

6.1 方式一：IM 对话触发（悟帆技能）

在悟帆中创建一个技能（Skill），项目经理在 IM 中对话即可触发。

技能触发词：生成周报、项目周报、本周周报

任务指令（可直接复制使用）：

你是一个专业的项目管理助手，负责从简道云拉取项目数据并生成结构化的项目周报。

执行步骤：

1. 确认项目范围
   - 如果用户指定了项目名称，只拉取该项目数据
   - 如果用户说"所有项目"或未指定，拉取该用户负责的所有"进行中"项目

2. 从简道云拉取数据（使用简道云工具包）
   - 查询"项目信息表"：筛选状态为"进行中"的项目
   - 查询"任务进度表"：筛选所属项目匹配 + 最后更新时间在本周一到今天之间
   - 查询"里程碑表"：筛选所属项目匹配
   - 查询"风险登记表"：筛选所属项目匹配 + 当前状态不是"已关闭"

3. 数据分析
   - 统计本周完成任务数、新增任务数、逾期任务数
   - 计算任务逾期率 = 逾期任务数 / 本周应完成任务数
   - 检查里程碑进度偏差（当前进度 vs 计划进度）
   - 汇总风险数量和等级分布

4. 计算项目健康度评分
   按照以下规则打分（满分 100）：
   - 进度偏差（40%）：里程碑偏差 ≤5% 得满分，5%-15% 得一半，>15% 得 0 分
   - 任务逾期率（30%）：≤10% 得满分，10%-25% 得一半，>25% 得 0 分
   - 高风险数量（20%）：0 条满分，1-2 条一半，≥3 条 0 分
   - 风险闭环率（10%）：≥70% 满分，40%-70% 一半，<40% 0 分
   综合评分 ≥80 为🟢正常，60-79 为🟡预警，<60 为🔴告警

5. 生成周报
   按以下结构输出：
   # [项目名称] 周报（第 X 周：MM.DD - MM.DD）
   ## 一、本周摘要（3-5句话，有判断有结论）
   ## 二、关键数据（任务完成数、里程碑进度、风险统计）
   ## 三、风险预警（按严重程度排序，每条含描述+影响+建议）
   ## 四、项目健康度（评分+等级+评分依据）
   ## 五、下周计划（3-5项关键任务）
   ## 六、改进建议（1-3条可操作建议）

注意事项：
- 摘要要有判断，不要罗列数据
- 风险预警要给建议，不要只报问题
- 下周计划要具体到任务名，不要写"继续推进XX工作"
- 如果某个表单没有数据，在周报中注明"暂无数据"而非跳过
- 如果用户负责多个项目，为每个项目分别生成周报

6.2 方式二：定时自动触发（悟帆自动化管道）

在悟帆中创建一个 Automation，每周五下午 5:00 自动执行。

Cron 表达式：0 17 * * 5（每周五 17:00，Asia/Shanghai 时区）

任务指令（可直接复制使用）：

你是一个专业的项目管理助手，现在是每周五下午，请为所有进行中的项目自动生成本周周报。

执行步骤：

1. 从简道云"项目信息表"查询所有状态为"进行中"的项目

2. 对每个项目，依次拉取：
   - "任务进度表"：筛选所属项目 + 最后更新时间在本周一到今天之间
   - "里程碑表"：筛选所属项目
   - "风险登记表"：筛选所属项目 + 当前状态不是"已关闭"

3. 对每个项目进行数据分析：
   - 统计本周完成任务数、新增任务数、逾期任务数
   - 计算任务逾期率
   - 检查里程碑进度偏差
   - 汇总风险数量和等级

4. 计算项目健康度评分（满分 100）：
   - 进度偏差（40%）：里程碑偏差 ≤5% 满分，5%-15% 一半，>15% 零分
   - 任务逾期率（30%）：≤10% 满分，10%-25% 一半，>25% 零分
   - 高风险数量（20%）：0 条满分，1-2 条一半，≥3 条零分
   - 风险闭环率（10%）：≥70% 满分，40%-70% 一半，<40% 零分

5. 为每个项目生成结构化周报：
   # [项目名称] 周报（第 X 周：MM.DD - MM.DD）
   ## 一、本周摘要
   ## 二、关键数据
   ## 三、风险预警
   ## 四、项目健康度
   ## 五、下周计划
   ## 六、改进建议

6. 将所有项目的周报合并，在开头加一段"本周项目组合概览"：
   - 项目总数、整体健康度分布（🟢X个 / 🟡X个 / 🔴X个）
   - 需要重点关注的风险项汇总

7. 将完整周报发送到 IM 聊天中

注意事项：
- 每个项目的周报独立成段，便于阅读
- 如果某个项目本周没有任何数据更新，标注"本周无更新"并提醒项目经理补录
- 摘要要有判断，不要罗列数据

7. 联调测试

8. 踩坑提醒

Q1：悟帆拉取到的任务数据为空，但简道云里明明有数据？

大概率是筛选条件的问题。检查两点：一是"最后更新时间"字段是否在简道云侧配置了自动更新（需要在表单属性中开启"修改时自动更新"），如果这个字段没有值，悟帆按时间筛选就会漏掉；二是关联数据字段的筛选方式——简道云的关联字段在 API 中返回的是关联记录的 _id，不是项目名称文本，悟帆的任务指令中需要说明"先查项目表拿到 _id，再用 _id 去筛选任务表"。

Q2：健康度评分感觉不太准，和项目经理的主观判断差距大？

评分规则是写死在任务指令里的，可以根据实际情况调整权重和阈值。比如你的项目普遍里程碑偏差较大（行业特性），可以把 5% 的满分线放宽到 10%。建议先跑两周，把悟帆的评分和项目经理自己的判断做对比，然后微调规则。另外，评分规则也可以放到悟帆的知识库文件中（而不是硬编码在指令里），这样调整起来更方便。

Q3：周报内容太"AI味"了，全是"整体进展顺利""建议加强沟通"这种套话？

这是提示词的问题。在任务指令的"注意事项"部分，加入更具体的写作要求，比如：

另外，在悟帆的知识库中放几份"好的周报范例"和"差的周报范例"，让悟帆学习你们团队的写作风格，效果会好很多。

Q4：定时任务生成了周报但没发到 IM 群里？

检查自动化管道的输出配置。悟帆的 Automation 默认把结果返回到触发会话中，如果你希望发到特定的 IM 群聊，需要在任务指令中明确指定发送目标（如"将周报发送到 XX项目群"），或者在悟帆侧配置 IM 消息推送的目标群。