参数/描述修正: - report-submit.md:report_submit → report_submit_item - huanxi-shared 全局约定:同步修正 report_submit 工具名 - weekly-draft.md:多模块循环示例 week → week_number(weekly_report_save 正确参数名) - 工具索引补全参数:task_list_mine/people_get_board/user_list/weekly_report_submit - resolve-ids.md:澄清 feishu_user_id 与 feishu_open_id 是两个不同字段 新增工具调用规范: - huanxi-shared 全局约定第 6 条:以 MCP 工具实际定义为准 - 5 个 skill 文件前置区域统一加 ⚠️ 提示引用第 6 条 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2.9 KiB
2.9 KiB
周报草稿(+draft,仅限模块负责人)
⚠️ 参数细节以 MCP
weekly_report_save的 docstring 为准,本文档仅做工作流引导。
数据来源
周报草稿基于本周负责人日报汇总(leader_report_get_batch 返回值),而非员工个人日报。
| 数据 | 来源 | 说明 |
|---|---|---|
| 本周每日负责人日报 | leader_report_get_batch(date列表, module_ids) |
含各日的模块进展 + 下属提交情况摘要 |
| 现有周报草稿 | weekly_report_get_batch(year, week, module_ids) |
已填写的草稿(若有) |
草稿生成步骤
Step 1: 解析本周负责人日报数据
→ 按日期排列,提取每日:
· 模块整体进展
· 团队成员提交情况
· 遇到的问题与风险
Step 2: AI 基于负责人日报起草 content(本周总结):
- 提炼本周模块核心进展(任务推进 + 里程碑)
- 汇总团队整体情况
- 列出本周识别的问题与应对
Step 3: AI 起草 next_week_plan(下周计划):
- 基于本周未完成项和下周目标
- 结合用户补充的计划
Step 4: 展示草稿给用户审阅修改
Step 5: 用户确认后逐模块保存:
mcp__huanxi__weekly_report_save(
module_id = "<模块ID>",
year = <ISO year>, ← 注意:ISO year,不是日历年
week_number = <ISO week>, ← 后端字段名是 week_number,不是 week
content = "<本周总结>",
next_week_plan = "<下周计划>"
)
内容格式建议(负责人视角)
content(本周总结):
## 本周模块进展
- **[任务A]** 完成 XX 功能开发,进度推进至 80%(负责人:张三)
- **[任务B]** 完成接口联调,已提测(负责人:李四)
## 团队提交情况
本周全员提交日报,无缺报。
## 问题与风险
- [周三] 第三方接口超时问题,已升级厂商处理,预计周一恢复
## 本周总体评估
整体按计划推进,无阻塞性风险。
next_week_plan(下周计划):
- [任务A] 目标完成剩余 20% 并提测
- [任务B] 协助测试团队完成验收
- 启动 [新需求] 的技术调研
已有草稿处理
若 weekly_report_get_batch() 中该模块已有草稿(非 empty):
- 展示现有草稿内容
- 询问:"是在此基础上修改,还是基于本周负责人日报重新生成?"
- 基于用户选择执行对应操作
多模块处理
for module in leader_modules:
1. 提取该模块的 leader_report_batch(本周各日记录)
2. AI 生成草稿(content + next_week_plan)
3. 展示给用户确认/修改
4. weekly_report_save(module_id=module.id, year, week_number, ...)
5. 告知:模块 "{module.name}" 草稿已保存 ✅
所有模块草稿完成后:统一展示,询问是否提交