Files
yixiong-claude-marketplace/plugins/huanxi/skills/huanxi-weekly/references/weekly-draft.md
T
SkyJourneyandClaude Sonnet 4.6 8289fa6060 docs(huanxi-skills): 修正工具调用描述与参数出入,补充工具定义优先规范
参数/描述修正:
- 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>
2026-06-17 14:38:09 +08:00

2.9 KiB
Raw Blame History

周报草稿(+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}" 草稿已保存 ✅

所有模块草稿完成后:统一展示,询问是否提交