| 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 检查项
Writer Agent 检查项
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 仅作补充 |
