工作周报生成器 (work_report_generator)

描述

根据用户自然语言需求，自动生成结构化的工作周报。本技能专注于数据处理、统计归纳和模板填充，不直接访问数据源；数据由上层编排层通过 CLI 获取并按照输入契约传入。

输入契约

技能接收一个 JSON 对象，必须符合以下结构（详细定义见 references/data_contract.md）：

{
  "report_scope": {
    "scope_type": "personal | team | project",
    "scope_id": "string",
    "scope_name": "string"
  },
  "time_range": {
    "start": "YYYY-MM-DD",
    "end": "YYYY-MM-DD"
  },
  "data_sources": {
    "tasks": [ ... ],        // 任务列表
    "bugs": [ ... ],         // 缺陷列表（可选）
    "feedbacks": [ ... ],    // 反馈/需求列表（可选）
    "risks": [ ... ],        // 风险列表（可选）
    "milestones": [ ... ]    // 里程碑列表（可选）
  }
}

处理流程

1. 数据校验：验证输入契约完整性，缺失必要字段返回错误。
2. 数据统计：对任务、缺陷等数据进行数值统计（完成数、完成率、状态分布等）。
3. AI 归纳：调用 LLM 对任务标题/描述进行语义聚类，生成“重点工作事项”摘要；基于里程碑进度生成“下周计划”建议；若包含风险，生成风险提示。
4. 模板填充：将统计数据和 AI 生成内容填入 assets/template.md 对应占位符。
5. 输出：返回填充后的 Markdown 文本。

输出格式

技能返回 Markdown 格式的周报，基于模板 assets/template.md 完成填充

注意事项

1. 技能内部不发起任何网络请求，所有数据通过输入契约传入。
2. 对于缺失的可选数据源（如 bugs 为空数组），对应小节显示“无”。
3. AI 归纳部分使用系统预设的提示词，确保输出符合周报风格。