| name | docx-work-report |
| description | 生成实习生结构化工作记录 docx 文件。当用户说"日报"、"新增"、"周报"、"任务看板"、"台账"、"生成docx"、"写日报"、"填新增"时触发。支持日报、新增记录、周报、任务看板（五表联动）、工作台账（四表联动）五类文档的自动生成。输入为口语化的工作内容描述，输出为格式化的 .docx 文件。 |
| agent_created | true |
docx-work-report
将口语化的工作内容描述转化为结构化的 Word 文档，用于 AI Agent 小团队实习生的日常工作记录。
触发条件
- "日报"、"新增"、"周报"、"任务看板"、"台账"、"生成docx"、"写日报"、"填新增"
- 用户提供某天/某周的工作内容并要求生成文档
依赖
- Python 3.12+，需安装
python-docx 和 lxml
- 安装命令：
pip install python-docx lxml
工作流程
第一步：收集信息
固定信息（自动填充）：
- 姓名：liuweiqing
- 导师：lishibo
- 日期/周次：根据当天日期或上下文自动推算
必填项（用户需提供）：
可选项（有则填，无则跳过）：
- 实验记录、调试过程、风险问题
- 导师反馈、每日站会信息
- 下周计划、明日计划
第二步：确定输出类型
根据用户请求生成对应文档：
| 用户请求 | 输出文件 | 命名格式 |
|---|
| 日报 | 日报.docx | liuweiqing-YYYY-MM-DD-日报.docx |
| 新增记录 | 新增.docx | liuweiqing-YYYY-MM-DD-新增.docx |
| 周报 | 周报.docx | liuweiqing-YYYY-WXX-周报.docx |
| 任务看板 | 任务看板.docx | liuweiqing-YYYY-WXX-任务看板.docx |
| 台账 | 台账.docx（含4表） | liuweiqing-YYYY-WXX-台账.docx |
第三步：运行生成脚本
将用户输入的结构化数据填入对应脚本的数据区段，然后执行：
python scripts/generate_all.py
重要：每次运行前先读脚本，将数据区段的变量替换为用户输入的内容，然后执行。
第四步：交付
生成的 docx 文件保存到当前工作区，通过 present_files 交付给用户。
文档结构规范
日报结构（7节）
- 基本信息（日期、姓名、项目、导师、工时、状态）
- 今日目标与实际结果（计划/实际/差异）
- 任务执行记录（序号、任务、输入方法、产出、验证方式、状态）
- 实验/调试记录（实验ID、假设、配置变更、结果、结论）— 无则写"无"
- 风险、问题与支持需求 — 无则写"无"
- 明日计划（优先级、事项、预期产出、依赖）
- 自评与导师反馈（维度、自评、导师反馈留空）
新增记录结构（6节）
- 基本信息（日期、记录人、项目、模块）
- 新增事项清单（编号、类型、标题、来源、价值、处理建议）
- 新知识/新方法沉淀 — 无则写"无"
- 新问题/缺陷记录 — 无则写"无"
- 可复用资产登记 — 无则写"无"
- 是否同步到周报 — 无则写"无"
周报结构（6节）
- 基本信息（周次、周期、姓名、导师、项目、总工时）
- 一句话总结（结论 + 证据）
- 本周关键产出（类别、产出、证据、状态）
- 问题、风险与决策需求
- 下周计划（优先级、事项、产物、验收标准、依赖）
- 导师评价（留空待填）
任务看板（五表联动）
- 表一：任务看板（T-001递增，P0/P1/P2优先级，Backlog/Todo/Doing/Review/Done/Blocked状态）
- 表二：每日站会记录
- 表三：导师反馈记录 — 无数据则写"暂无数据"
- 表四：阶段评价表（维度、证据、评分留空、建议留空）
- 表五：团队复盘（5个固定问题）
台账（四表联动）
- 表一：每日工作记录（整周逐天）
- 表二：每日新增记录（整周逐天）
- 表三：周报汇总（一行）
- 表四：工具看板（从表一表二提炼进行中/待办事项）
排版规范
- 页面：A4 (21cm × 29.7cm)，上下左右边距 2.0cm
- 标题：宋体
- 正文字号：10pt，表格字号 9pt
- 表格：居中对齐，表头浅蓝底色 (#D9E2F3)，灰色边框 (#999999)
- 表格内字体：宋体，表头加粗居中
- 日期格式：YYYY-MM-DD（文件名）、YYYY/M/D（表格内，不补零）
- 周次格式：YYYY-WXX
关键规则
- 不编造用户未提供的信息，缺失项填"-"
- 导师评价/反馈列始终留空，等待导师填写
- 任务看板中 Done 的任务带截止日期，未完成的不填
- 四表/五表联动：各表信息自动流转，保持一致性
- 产出文件的命名严格按格式，便于排序和查找
