name	aily-doc-weekly-work-report
label	工作周报
description	基于飞书生态的每周周报自动生成 Skill：从当周日程、任务、妙记、云文档中提取工作内容，使用 `knowledge_answer` 兜底补全遗漏信息，最终调用 `doc_agent (writer)` 生成结构化的飞书云文档周报。

SKILL: aily-doc-weekly-work-report

基于飞书生态的每周周报自动生成 Skill：从当周日程、任务、妙记、云文档中提取工作内容，使用 knowledge_answer 兜底补全遗漏信息，最终调用 doc_agent (writer) 生成结构化的飞书云文档周报。

1) Overview

⚠️ 输出形式（强制）

本 skill 被触发即代表用户期望生成飞书云文档，主 Agent 无需询问用户是否需要写成文档，也不得以对话文本替代文档作为最终交付物。
数据收集完成后，必须通过 task（subagent_type: writer）委托 Writer Agent 创建飞书云文档。

飞书工具优先（必须遵守）

所有飞书相关信息获取与写作，先参考 feishu-use-skills-map 并按其指引调用对应技能
需要访问飞书文档/群消息/会议/任务时，必须先 get_skills 获取对应飞书技能说明
本 Skill 是飞书生态工具最密集的 Skill 之一，涉及日程、任务、妙记、云文档、知识库五大数据源

工具/Skill 明确清单（执行前先 get_skills）

Agent	工具名	用途	使用阶段
主 Agent	`aily-calendar`	获取日程/会议事件	A1 日程获取
主 Agent	`aily_lark_task` (MCP)	获取任务列表及状态	A2 任务获取
主 Agent	`minute` (MCP)	获取妙记/会议纪要	A3 妙记获取
主 Agent	`aily-doc`	搜索/列出云文档	A4 云文档获取
主 Agent	`knowledge_answer`	兜底补全遗漏信息	A5 兜底补全
主 Agent	`todo_write`	分解任务清单	任务规划
主 Agent	`file`	写入 draft.md 素材	A1-A5 + B
主 Agent	`task`	分发写作任务给 Writer Agent	C 调用 Writer
Writer Agent	`file_read`	读取 draft.md	读取素材
Writer Agent	`outline_generator`	生成文档大纲	规划结构
Writer Agent	`feishu_doc_create`	生成飞书云文档	最终输出

说明：aily-calendar 必要时可用 resources 获取妙记/共享文档关联信息；minute MCP 适用于已有妙记链接的场景。

证据与时间约束（主/写作 Agent 一致）

任何数据/结论必须来自可追溯来源；不确定则明确标注"需补充资料"
若用户指定时间范围，必须严格筛选在时间窗内的资料，过期内容不得使用
不可编造事实、链接或来源；引用必须有明确出处

可读性规则（强制）

并列项 >= 3：优先使用无序/有序列表或表格
单段 > 150 字必须拆分（列表/小节/Callout）
连续两段无列表且信息密度高：插入列表或 Callout

触发方式（Triggers）

"帮我生成本周周报"
"总结一下我这周的工作"
"把这周的日程、任务、会议整理成周报"
"生成 {start_date} 到 {end_date} 的周报"

时间窗口（Week Window）

默认：本周（周一 00:00:00 至周日 23:59:59），按用户时区
自定义：用户可指定具体日期范围
周报必须标注：统计区间：{week_start_date}（周一）~ {week_end_date}（周日）

核心输出（Deliverables）

飞书云文档周报：结构标准、内容翔实、可追溯

质量标准

完整性：日程、任务、妙记、云文档四类来源均覆盖
洞察优先：不做流水账，每类来源产出 insights
时间正确性：严格过滤到当周窗口

2) 任务分解示例（todo_write）

主 Agent 收到周报请求后，使用 todo_write 分解任务：

{
  "todos": [
    {"content": "获取本周日程数据并分析", "status": "in_progress"},
    {"content": "获取本周任务数据并分析", "status": "pending"},
    {"content": "获取本周妙记（会议纪要）并提取要点", "status": "pending"},
    {"content": "获取本周创建/编辑的云文档", "status": "pending"},
    {"content": "使用 knowledge_answer 兜底补全遗漏信息", "status": "pending"},
    {"content": "汇总分析结果，调用 writer agent 生成周报云文档", "status": "pending"}
  ]
}

3) Module A — 数据获取（主 Agent 执行）

核心原则：使用 MCP 工具获取四类数据源，最后用 knowledge_answer 兜底。每完成一步，立即使用 file(path: "/home/workspace/draft.md", mode: "append") 将结果追加写入 draft.md。

A1. 获取本周日程

工具：aily-calendar（必要时用 resources 获取妙记/共享文档关联信息）

获取内容：

事件标题、开始/结束时间
参与人
会议描述/备注

时间过滤：仅保留落在周窗口（{week_start_date} 周一至 {week_end_date} 周日）的事件

分析维度：

会议数量与时长统计
按项目/主题聚类
高频协作对象

写入 draft.md（使用 file(path: "/home/workspace/draft.md", mode: "append")）：

## 日程数据

### 原始数据
| 日期 | 时间 | 事件 | 参与人 |
|------|------|------|--------|
| {date} | {start_time}-{end_time} | {event_title} | {attendees} |
| ... | ... | ... | ... |

### 洞察
- 本周共 {meeting_count} 场会议，总时长约 {total_hours} 小时
- Top 3 会议主题：{topic_1}、{topic_2}、{topic_3}
- 高频协作：{collaborator_1}（{count_1}次）、{collaborator_2}（{count_2}次）

A2. 获取本周任务

工具：aily_lark_task (MCP)

获取内容：

任务标题、负责人、状态（待办/进行中/已完成）
截止时间、优先级
更新记录

过滤规则：

本周创建的任务
本周完成的任务
本周有状态变更的任务

分析维度：

完成数 / 进行中数 / 阻塞数
关键完成项
阻塞原因与待解决事项

写入 draft.md（使用 file(path: "/home/workspace/draft.md", mode: "append")）：

## 任务数据

### 本周完成
- [x] {task_title_1}：{task_description_1}
- [x] {task_title_2}：{task_description_2}

### 进行中
- [ ] {task_title_3}：{task_description_3}（预计下周完成）

### 阻塞
- [ ] {task_title_4}：{task_description_4} —— 阻塞原因：{block_reason}

### 洞察
- 本周完成 {completed_count} 项任务，完成率 {completion_rate}%
- 阻塞事项需关注：{blocked_task}（{block_impact}）

A3. 获取本周妙记（会议纪要）

工具：minute (MCP)

获取内容：

会议标题、时间
会议摘要/纪要内容
决策事项、行动项

分析维度：

关键决策清单
待办行动项（Action Items）
重要讨论要点

写入 draft.md（使用 file(path: "/home/workspace/draft.md", mode: "append")）：

## 妙记数据

### 重要会议纪要
#### 1. {meeting_title_1}（{meeting_date_1}）
- **决策**：{decision_1}
- **行动项**：{assignee_1} {action_item_1}（{deadline_1}前）
- **要点**：{key_point_1}

#### 2. {meeting_title_2}（{meeting_date_2}）
- **决策**：{decision_2}
- **行动项**：{assignee_2} {action_item_2}

### 洞察
- 本周 {minutes_count} 场会议有纪要记录
- 关键决策 {decision_count} 项，待跟进行动项 {action_count} 项

A4. 获取本周云文档活动

工具：aily-doc（通过 get_skills 获取技能后调用）

检索方式：

通过 aily-doc 搜索飞书云文档：
- 过滤条件：owner_name = "{current_user}"
- 时间范围：create_time = "[{week_start_date}, {week_end_date}]"（本周范围）

获取内容：

文档标题、链接
创建/更新时间
文档类型（文档/表格/幻灯片）

分析维度：

本周创建的文档（产出）
本周编辑的文档（贡献）
文档分类（需求文档/技术方案/会议纪要/其他）

写入 draft.md（使用 file(path: "/home/workspace/draft.md", mode: "append")）：

## 云文档活动

### 本周创建
| 文档标题 | 类型 | 链接 |
|---------|------|------|
| {doc_title_1} | {doc_type_1} | [链接]({doc_url_1}) |
| {doc_title_2} | {doc_type_2} | [链接]({doc_url_2}) |

### 本周编辑
| 文档标题 | 更新内容 |
|---------|---------|
| {edited_doc_title} | {edit_summary} |

### 洞察
- 本周产出 {created_doc_count} 篇文档
- 主要产出类型：{doc_category_1}（{category_1_count}篇）、{doc_category_2}（{category_2_count}篇）

A5. Knowledge Answer 兜底

工具：knowledge_answer

查询策略（在前4步完成后执行）：

knowledge_answer(
  query_list: ["总结我本周（{week_start_date}到{week_end_date}）的主要工作内容和产出"],
  explanation: "兜底补全可能遗漏的本周工作信息"
)

使用规则：

作为补充来源，不替代前4步的事实数据
若 knowledge_answer 返回的信息与前4步冲突，以 MCP 数据为准
若发现前4步遗漏的重要信息，补充到 draft.md

写入 draft.md（使用 file(path: "/home/workspace/draft.md", mode: "append")）：

## Knowledge Answer 补充

### 补充信息
- [补充] {supplementary_item_1}（未在{missing_source_1}中体现）
- [补充] {supplementary_item_2}（未在{missing_source_2}中体现）

### 与事实源对照
- 一致：日程、任务、妙记信息与 knowledge_answer 基本吻合
- 补充：发现 {supplement_count} 项遗漏，已补入对应章节

4) Module B — 汇总分析（主 Agent 执行）

在获取完所有数据后，主 Agent 使用 file(path: "/home/workspace/draft.md", mode: "append") 在 draft.md 末尾生成全局汇总：

## 全局汇总

### 本周主题
- 主线1：{main_theme_1}
- 主线2：{main_theme_2}

### 关键产出
1. {key_output_1}
2. {key_output_2}
3. {key_output_3}

### 待解决问题
1. {pending_issue_1}
2. {pending_issue_2}

### 下周计划
1. 【高】{high_priority_plan}
2. 【中】{medium_priority_plan}
3. 【低】{low_priority_plan}

5) Module C — 调用 Writer Agent 生成周报

任务分发

主 Agent 完成数据收集与汇总后，调用 task 工具分发给 Writer Agent：

{
  "description": "生成本周周报云文档",
  "prompt": "基于 /home/workspace/draft.md 中的周报素材，生成一份飞书云文档周报。\n\n要求：\n1. 严格按照周报模板结构\n2. 统计区间：{week_start_date} ~ {week_end_date}\n3. 突出洞察和结论，避免流水账\n4. 所有数据来源于 draft.md，不要编造\n\n周报模板见下方。",
  "subagent_type": "writer"
}

Writer Agent 执行流程

Writer Agent 收到任务后，按以下步骤执行：

file_read：读取 /home/workspace/draft.md 完整内容
outline_generator：基于周报模板生成飞书文档大纲
feishu_doc_create：按模板结构生成飞书云文档，内容来源于 draft.md
end：返回飞书云文档链接，结束任务

6) 周报模板（Writer Agent 遵循）

Writer Agent 使用 feishu_doc_create 生成飞书云文档时，必须遵循以下模板结构：

# 周报：{week_start_date} ~ {week_end_date}

> 👤 {user_name}
> 📅 统计区间：{week_start_year}年{week_start_month}月{week_start_day}日（周一）~ {week_end_year}年{week_end_month}月{week_end_day}日（周日）
> 🕐 生成时间：{generated_datetime}

---

## 📌 本周摘要

<!-- 3-5 条核心要点，高度概括 -->

- **主线工作**：本周主要推进 {main_work_1}、{main_work_2} 两个方向
- **关键产出**：完成 {key_deliverable_1}、产出 {key_deliverable_2}
- **待解决**：{pending_issue} 事项阻塞，需协调
- **下周重点**：{next_week_focus_1}、{next_week_focus_2}

---

## 📊 一周概览

| 维度 | 数据 |
|------|------|
| 会议数量 | {meeting_count} 场（约 {meeting_hours} 小时） |
| 完成任务 | {completed_task_count} 项 |
| 进行中任务 | {in_progress_task_count} 项 |
| 阻塞任务 | {blocked_task_count} 项 |
| 产出文档 | {doc_count} 篇 |

---

## 📅 日程与会议

### 重点会议

| 日期 | 会议 | 关键结论 |
|------|------|---------|
| {meeting_date_1} | {meeting_name_1} | {meeting_conclusion_1} |
| {meeting_date_2} | {meeting_name_2} | {meeting_conclusion_2} |

### 洞察
- 本周会议集中在 {meeting_focus_area} 方向
- 高频协作对象：{top_collaborator_1}、{top_collaborator_2}

---

## ✅ 任务进展

### 本周完成
- [x] **{completed_task_1}**：{completed_desc_1}（关联项目：{project_1}）
- [x] **{completed_task_2}**：{completed_desc_2}

### 进行中
- [ ] **{ongoing_task_1}**：{ongoing_desc_1} —— 预计下周完成

### 阻塞事项
| 任务 | 阻塞原因 | 解决方案 |
|------|---------|---------|
| {blocked_task_name} | {block_reason} | {resolution_plan} |

---

## 🎙️ 会议纪要要点

### 关键决策
| 会议 | 决策内容 | 决策时间 |
|------|---------|---------|
| {decision_meeting} | {decision_content} | {decision_date} |

### 待跟进行动项
| 行动项 | 负责人 | 截止时间 |
|--------|-------|---------|
| {action_item} | {action_owner} | {action_deadline} |

---

## 📄 文档产出

### 本周创建
| 文档名称 | 类型 | 链接 |
|---------|------|------|
| {created_doc_title_1} | {created_doc_type_1} | [查看]({created_doc_url_1}) |
| {created_doc_title_2} | {created_doc_type_2} | [查看]({created_doc_url_2}) |

### 本周贡献
- 编辑 **{edited_doc_name}**：{edit_detail}
- 评审 **{reviewed_doc_name}**：{review_detail}

---

## ⚠️ 风险与问题

| 风险/问题 | 影响 | 应对措施 |
|----------|------|---------|
| {risk_1} | {risk_impact_1} | {risk_mitigation_1} |
| {risk_2} | {risk_impact_2} | {risk_mitigation_2} |

---

## 📋 下周计划

### 优先级排序

| 优先级 | 事项 | 预期产出 |
|--------|------|---------|
| 🔴 高 | {high_plan} | {high_output} |
| 🟡 中 | {medium_plan} | {medium_output} |
| 🟢 低 | {low_plan} | {low_output} |

### 关键里程碑
- **{milestone_date_1}**：{milestone_1}
- **{milestone_date_2}**：{milestone_2}

---

## 📎 附录

### 重要链接
- [{link_title_1}]({link_url_1})
- [{link_title_2}]({link_url_2})
- [{link_title_3}]({link_url_3})

7) 执行流程图

用户: "帮我生成本周周报"
          ↓
┌─────────────────────────────────────────────────────────────┐
│                    主 Agent 执行                              │
├─────────────────────────────────────────────────────────────┤
│ 1. todo_write: 分解任务（6 步）                               │
│ 2. aily-calendar → 分析日程 → file(draft.md, append)   │
│ 3. aily_lark_task → 分析任务 → file(draft.md, append)  │
│ 4. minute → 分析妙记 → file(draft.md, append)          │
│ 5. aily-doc → 分析云文档 → file(draft.md, append)      │
│ 6. knowledge_answer → 兜底补全 → file(draft.md, append)│
│ 7. 汇总分析（Module B） → file(draft.md, append)       │
│ 8. task(writer): 分发写作任务                                │
└─────────────────────────────────────────────────────────────┘
          ↓
┌─────────────────────────────────────────────────────────────┐
│                    Writer Agent 执行                         │
├─────────────────────────────────────────────────────────────┤
│ 1. file_read: 读取 /home/workspace/draft.md                  │
│ 2. outline_generator: 生成大纲（基于周报模板）                │
│ 3. feishu_doc_create: 生成飞书云文档周报                      │
│ 4. end: 返回文档链接，结束                                   │
└─────────────────────────────────────────────────────────────┘
          ↓
      飞书云文档周报

8) Checklist

主 Agent 检查项

日程数据已通过 aily-calendar 获取并 file 写入 draft.md
任务数据已通过 aily_lark_task 获取并 file 写入 draft.md
妙记数据已通过 minute 获取并 file 写入 draft.md
云文档活动已通过 aily-doc 获取并 file 写入 draft.md
knowledge_answer 兜底已执行并 file 写入 draft.md
全局汇总（Module B）已生成并 file 写入 draft.md
已调用 task(writer) 分发写作任务

Writer Agent 检查项

已通过 file_read 读取 draft.md 完整内容
已通过 outline_generator 生成周报大纲
周报结构严格符合模板（📌📊📅✅🎙️📄⚠️📋📎 各节齐全）
统计区间标注正确：{week_start_date} ~ {week_end_date}
所有数据来源于 draft.md，无编造
已通过 feishu_doc_create 生成飞书云文档

9) 常见失败模式与修复

失败模式	原因	修复方法
数据缺失	MCP 工具调用失败或返回空	使用 `knowledge_answer` 兜底；在 draft.md 中标注"该来源暂无数据"
内容流水账	缺少分析，直接罗列原始数据	每类数据必须有"洞察"小节，提炼 insights
时间范围错误	未正确设置过滤条件	检查日期参数，确保是 {week_start_date}（周一）至 {week_end_date}（周日）
周报结构混乱	Writer 未遵循模板	在 task prompt 中明确要求遵循模板，Checklist 逐项验证
信息重复	draft.md 中多来源有冗余	Module B 汇总时去重，合并同类信息后再调用 Writer
draft.md 未写入	忘记调用 file	每个 Module A 子步骤完成后立即 `file(path: "/home/workspace/draft.md", mode: "append")`
knowledge_answer 覆盖事实	兜底信息与 MCP 数据冲突	以 MCP 数据为准，knowledge_answer 仅作补充