docx-work-reportSKILL.md ↗
docx-work-report-general
将口语化的工作内容描述转化为结构化的 Word 文档,适用于实习生/小团队的日常工作记录。
注意:此为通用版,不含具体姓名等个人信息。首次使用需配置姓名和导师。
触发条件
- "日报"、"新增"、"周报"、"任务看板"、"台账"、"生成docx"、"写日报"、"填新增"
- 用户提供某天/某周的工作内容并要求生成文档
依赖
- Python 3.12+,需安装
python-docx和lxml - 安装命令:
pip install python-docx lxml - 运行时使用当前环境的 Python
工作流程
第一步:收集信息
需要用户提供:
- 姓名、导师姓名(首次使用,后续沿用)
- 工作/任务内容(口语化即可)
可选项(有则填,无则跳过):
- 实验记录、调试过程、风险问题
- 导师反馈、每日站会信息
- 下周计划、明日计划
第二步:确定输出类型
| 用户请求 | 输出文件 | 命名格式 |
|---|---|---|
| 日报 | 日报.docx | 姓名-YYYY-MM-DD-日报.docx |
| 新增记录 | 新增.docx | 姓名-YYYY-MM-DD-新增.docx |
| 周报 | 周报.docx | 姓名-YYYY-WXX-周报.docx |
| 任务看板 | 任务看板.docx | 姓名-YYYY-WXX-任务看板.docx |
| 台账 | 台账.docx(含4表) | 姓名-YYYY-WXX-台账.docx |
第三步:运行生成脚本
核心库:scripts/generate_all.py 提供 5 个函数(create_daily_report、create_new_record、create_weekly_report、create_kanban、create_ledger)。
实际生成模式:以已有的数据脚本为模板,复制后只替换数据区段(d0622、new_0622、weekly_data、kanban_data、ledger_data 等变量内容)。一次运行生成该周全部文档。
脚本通用结构(复制后只改 NAME、REVIEWER 和数据):
import os, sys
sys.path.insert(0, r"<skill-path>/scripts")
from generate_all import (create_daily_report, create_new_record,
create_weekly_report, create_kanban, create_ledger)
OUTPUT_DIR = os.path.dirname(os.path.abspath(__file__))
import generate_all; generate_all.OUTPUT_DIR = OUTPUT_DIR
NAME = "填写姓名"
REVIEWER = "填写导师"
PROJECT = "填写项目名"
# 数据定义区(唯一需要修改的部分)
d0622 = { "date": "2026-06-22", "goals": [...], ... }
# ... 更多数据 ...
# 生成区(不变)
create_daily_report(date_str=d0622["date"], ...) # 日报
create_new_record(date_str=new_0622["date"], ...) # 新增
create_weekly_report(...) # 周报
create_kanban(...) # 任务看板
create_ledger(...) # 台账
重要规则:
- 脚本结构不变,只替换 NAME/REVIEWER 和数据;不要每次重写生成逻辑
- 通过
generate_all.OUTPUT_DIR覆盖输出目录到脚本所在位置 - 日期在表格内使用
YYYY/M/D(不补零),由format_date()辅助
文档结构规范
日报结构(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(不补零),例如 2026/5/21、2026/6/3
- 周次格式:YYYY-WXX
枚举值参考
优先级
P0(阻塞/核心)、P1(重要)、P2(锦上添花)
状态
Backlog / Todo / Doing / Review / Done / Blocked
新增类型
知识 / 问题 / 资产 / 方案
任务类型
开发 / 实验 / 调研 / 文档 / 会议 / 调试 / Other
Agent模块
Planner / RAG / Tool Use / Memory / Eval / UI / Infra / Other
关键规则
- 不编造用户未提供的信息,缺失项填"-"
- 导师评价/反馈列始终留空,等待导师填写
- 任务看板中 Done 的任务带截止日期,未完成的不填
- 四表/五表联动:各表信息自动流转,保持一致性
- 产出文件的命名严格按格式,便于排序和查找