yixiong-claude-marketplace/plugins/huanxi/skills/huanxi-report/SKILL.md

---

name: huanxi-report description: "寰汐员工日报工作流：查看今日日报状态（+check）、保存草稿（+draft）、提交日报（+submit）、撤回日报（+withdraw）。当用户说"帮我写日报"、"填日报"、"提交日报"、"查看今日汇报情况"时触发。"

寰汐员工日报

前置条件：先 Read ../huanxi-shared/SKILL.md（缓存规则 + TTL 策略）

⚠️ 工具调用规范：执行任何 mcp__huanxi__* 调用前，以工具实际注册的参数名和类型为准，本文档示例仅供工作流引导（见 shared 全局约定第 6 条）。

---

标准工作流（完整流程）

Step 0: 确认身份
  → Read ~/.claude/huanxi-cache/me.json（永久缓存）
  → 若 me.json 为空：mcp__huanxi__user_get_me() → 写入缓存

Step 1: 检查是否工作日
  → 查 workdays.json["今日日期"]
  → 未缓存：mcp__huanxi__system_get_workday() → 追加写入 workdays.json
  → 非工作日：告知用户，询问"是否仍要填写？"（不强制中断）

Step 2: 查看今日日报状态
  → mcp__huanxi__report_get_today()
  → submitted → 告知"今日已提交"，询问是否撤回
  → draft/empty → 继续 Step 3

Step 3: 获取待汇报任务并收集内容
  → mcp__huanxi__report_get_tasks_to_report()
  → 返回的每个任务条目含：id（task_id）、title、module_id、module_name、progress 等
  → 展示待汇报任务列表（任务名、模块、当前进度）
  → 引导用户逐一填写今日进展和完成百分比
  → 详见 references/report-draft.md

Step 4: 保存草稿并展示初稿
  → mcp__huanxi__report_save_draft(items=[...])
  → ⚠️ items 字段以 MCP docstring 为准；每条必须带 module_id（取自 Step 3 任务条目）
  → 展示完整初稿内容供用户预览

Step 5: 询问是否 AI 润色
  → 询问用户："是否需要 AI 润色优化表达？"
  → 用户同意 → mcp__huanxi__llm_polish_report(content=<初稿内容>)
               → 展示润色后版本，与初稿对比
               → 用户选择采用润色版或保留原版
               → 若采用润色版：mcp__huanxi__report_save_draft(items=[...]) 更新草稿
  → 用户拒绝 → 直接进入 Step 6

Step 6: 确认并提交
  → 展示最终内容，等待用户明确确认（"确认"/"提交"/"好的"等）
  → ⚠️ 未收到确认前，禁止调用 report_submit_item
  → 用户确认后：
      a. mcp__huanxi__report_get_today() → 获取各条目的 item_id
      b. 对每个需提交的草稿条目 → mcp__huanxi__report_submit_item(item_id)
      c. 逐条提交，不影响其他条目
  → 详见 references/report-submit.md

---

Shortcuts

指令	说明
+check	查看今日日报状态（已提交/草稿/空）
+draft	读取待报任务并保存草稿
+submit	提交当天日报（必须先确认）
+withdraw	撤回已提交日报（询问确认）

---

+check：查看今日状态

1. mcp__huanxi__report_get_today()
2. 展示：
   - 提交状态（submitted / draft / 未填）
   - 已填任务列表及内容摘要
   - 未填/dismissed 任务
3. 若已提交：询问"是否需要撤回修改？"
4. 若草稿：询问"是否继续编辑并提交？"

---

+withdraw：撤回日报

1. mcp__huanxi__report_get_today() → 获取各条目状态和 item_id
2. 展示已提交的条目列表，询问用户要撤回哪条（可多选）
3. 等待用户确认（撤回后该条目变为草稿，其他已提交条目不受影响）
4. 对用户选择的每条 → mcp__huanxi__report_withdraw_item(item_id)
5. 告知撤回成功，可重新编辑后用 report_submit_item 重新提交

---

关键约束

• 禁止自动提交：Step 6 必须展示内容并等待用户明确确认（"确认"/"提交"/"好的"等），不得自动调用 report_submit_item
• 逐条操作，不做全量：提交/撤回必须使用 report_submit_item / report_withdraw_item（需传 item_id），禁止批量操作所有条目，除非用户明确要求"全部提交/撤回"
• dismissed 状态：用户主动标记"今天不汇报该任务"，dismiss 的条目不计入汇报，不要提示用户补填
• 非工作日：检测到非工作日时，明确告知但不中断，询问用户意愿
• 已提交则不重复操作：Step 2 发现已提交时，不继续 Step 3-6，改为询问是否撤回