Back to all skills
docx-work-reportSKILL.md ↗

docx-work-report-general

将口语化的工作内容描述转化为结构化的 Word 文档,适用于实习生/小团队的日常工作记录。

注意:此为通用版,不含具体姓名等个人信息。首次使用需配置姓名和导师。

触发条件

  • "日报"、"新增"、"周报"、"任务看板"、"台账"、"生成docx"、"写日报"、"填新增"
  • 用户提供某天/某周的工作内容并要求生成文档

依赖

  • Python 3.12+,需安装 python-docxlxml
  • 安装命令: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_reportcreate_new_recordcreate_weekly_reportcreate_kanbancreate_ledger)。

实际生成模式:以已有的数据脚本为模板,复制后只替换数据区段(d0622new_0622weekly_datakanban_dataledger_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节)

  1. 基本信息(日期、姓名、项目、导师、工时、状态)
  2. 今日目标与实际结果(计划/实际/差异)
  3. 任务执行记录(序号、任务、输入方法、产出、验证方式、状态)
  4. 实验/调试记录(实验ID、假设、配置变更、结果、结论)— 无则写"无"
  5. 风险、问题与支持需求 — 无则写"无"
  6. 明日计划(优先级、事项、预期产出、依赖)
  7. 自评与导师反馈(维度、自评、导师反馈留空)

新增记录结构(6节)

  1. 基本信息(日期、记录人、项目、模块)
  2. 新增事项清单(编号、类型、标题、来源、价值、处理建议)
  3. 新知识/新方法沉淀 — 无则写"无"
  4. 新问题/缺陷记录 — 无则写"无"
  5. 可复用资产登记 — 无则写"无"
  6. 是否同步到周报 — 无则写"无"

周报结构(6节)

  1. 基本信息(周次、周期、姓名、导师、项目、总工时)
  2. 一句话总结(结论 + 证据)
  3. 本周关键产出(类别、产出、证据、状态)
  4. 问题、风险与决策需求
  5. 下周计划(优先级、事项、产物、验收标准、依赖)
  6. 导师评价(留空待填)

任务看板(五表联动)

  1. 表一:任务看板(T-001递增,P0/P1/P2优先级,Backlog/Todo/Doing/Review/Done/Blocked状态)
  2. 表二:每日站会记录
  3. 表三:导师反馈记录 — 无数据则写"暂无数据"
  4. 表四:阶段评价表(维度、证据、评分留空、建议留空)
  5. 表五:团队复盘(5个固定问题)

台账(四表联动)

  1. 表一:每日工作记录(整周逐天)
  2. 表二:每日新增记录(整周逐天)
  3. 表三:周报汇总(一行)
  4. 表四:工具看板(从表一表二提炼进行中/待办事项)

排版规范

  • 页面: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

关键规则

  1. 不编造用户未提供的信息,缺失项填"-"
  2. 导师评价/反馈列始终留空,等待导师填写
  3. 任务看板中 Done 的任务带截止日期,未完成的不填
  4. 四表/五表联动:各表信息自动流转,保持一致性
  5. 产出文件的命名严格按格式,便于排序和查找