weekly-report

name	weekly-report
description	每周工作周报生成助手。帮助用户通过问答式收集本周工作信息，自动读取项目 architecture.md 获取技术背景，结合周报模板和提交规范，生成符合格式的 Markdown 周报文件并保存到正确路径。触发词示例："帮我写周报"、"填写周报"、"生成本周周报"、"协助完成周报"。

Weekly Report Skill

固定配置

• 模板路径：C:\Work\Research\空白模板\周报模板.md
• 提交规范：C:\Work\Research\空白模板\周报提交规范.txt（见 references/submission_rules.md）
• 输出路径：C:\Work\Research\<姓名全拼>-<YYMMDD>.md
• 汇报人：Tingde Liu（文件名前缀：TingdeLiu）

模板格式见 references/template.md，提交规范见 references/submission_rules.md。

OKR 背景（内部参考，不写入周报）

OKR 考核表位于 C:\Work\Research\，文件名格式为 YYYY年M月的OKR考核表.xlsx。

在 Step 1 完成日期计算后，自动查找并读取当月 OKR 文件（用 pandas 读取，提取目标O和关键结果KR）。仅作为背景参考，用于：

• 理解用户描述的工作属于哪个方向
• 在追问时更准确地判断缺了哪些信息
• 描述工作成果时自然地带出量化指标（若 KR 有指标要求）

不得在周报中出现"OKR"、"KR"等字眼，也不得在提问中向用户展示OKR内容。若找不到当月 OKR 文件，跳过此步骤。

项目目录

所有项目位于 C:\GitHub\，每个项目下有：

• architecture.md：技术架构背景（若存在）
• PLAN.md：最近工作记录（若存在）

工作流程

Step 1：确定日期范围

用 currentDate（系统提供）计算本周的周一和周日，得出：

• 周报日期范围（周一~周日）
• 文件名中的日期（本周日 YYMMDD 格式）
• 完整文件名：TingdeLiu-YYMMDD.md

Step 2：询问本周参与的项目

第一轮提问（必须执行，不可跳过）：

本周参与了哪些项目？（列出项目名即可，例如：SplaTAM、wheeltec_ros2、StreamVLN 或其他）

Step 3：读取项目背景

根据用户列出的项目，并行读取每个项目的：

1. C:\GitHub\<ProjectName>\architecture.md
2. C:\GitHub\<ProjectName>\PLAN.md（若存在）

PLAN.md 提供最近工作上下文，结合 architecture.md 的技术术语，准确理解用户的工作描述。

Step 4：询问具体工作内容

读取完文件后，一次性提问所有内容：

请描述本周各项目的具体工作：

- [项目A]：做了什么？有无量化结果（指标/成功率等）？
- [项目B]：做了什么？开发/部署了哪些模块？
- ...

另外：
- 本周阅读了哪些论文？或撰写了哪些综述博客？（有的话请提供论文标题 / 博客标题，以及简要收获）
- 遇到的问题 / 阻碍？
- 下周计划？
- 各项任务预估时长？（若不确定可说"你看着给"）

关于博客链接：若用户提及撰写了综述博客，URL 规则为 https://tingde-liu.github.io/YYYY/MM/DD/<slug>/，slug 为文件名去掉日期前缀和 .md 后缀（如 2026-03-05-Robot-Agent-Survey.md → slug 为 Robot-Agent-Survey）。如需确认文件名，读取 C:\GitHub\Tingde.Liu.github.io\_posts\ 目录即可。博客条目时长固定写 约 6 小时。

Step 5：补充追问（若有缺口）

用户回复后，若仍有关键信息缺失，一次性集中追问：

补充几个细节：
1. [项目名] - [缺失内容，如：具体改动了哪些模块？有无量化指标？]
2. ...

原则：

• 用户主动提供的信息直接使用，不重复追问。
• 最多三轮问答（Step 2 → Step 4 → Step 5），之后直接生成。
• 时间估算：若用户说"你看着给"，根据工作量合理估算（单项任务通常 3–12 小时）。

Step 6：生成周报

按模板结构生成完整周报，要求：

1. 按模板分类归入正确 section：

   • 论文/开源调研 → Section 1（研究与阅读）
   • 数据集收集 → Section 2（数据采集）
   • 算法改进/调参/训练 → Section 3（算法研发）
   • 环境部署/ROS开发/系统编码 → Section 4（系统开发）
   • 实机测试/性能评测 → Section 5（实验测试）
   • 文档/协作 → Section 6（团队协作）

2. 技术细节准确：利用 architecture.md 中的术语和模块名，描述具体而非泛泛。

3. 量化结果前置：有指标（PSNR/ATE/成功率等）的任务，在描述开头直接给出数字。

4. 链接附上：论文、开源项目、调研页面等均需附 URL。

5. 时间标注：每条任务末尾标注 （约 x 小时）。

Step 7：保存文件

将生成内容写入 C:\Work\Research\TingdeLiu-YYMMDD.md，并告知用户：

1. 文件路径
2. 提交截止时间：下周一 9:30 前
3. 上传命令（日期替换为本周日的 YYYYMMDD 格式）：

scp C:\Work\Research\TingdeLiu-YYMMDD.md root@115.190.160.32:/data/weekly_report/YYYYMMDD

例如本周（周日 2026-03-22）：

scp C:\Work\Research\TingdeLiu-260322.md root@115.190.160.32:/data/weekly_report/20260322

注意事项

• 不属于任何已知 section 的工作，归入最接近的 section，不要新建 section。
• Section 中若本周无对应工作，整个 section 省略，不保留空占位。
• B 部分（阻碍与讨论）和 C 部分（下周计划）必须填写，不可省略。
• B 部分第 3 条"需要申请的资源或讨论点"：若用户未提及任何讨论点或资源需求，直接写"暂无"，不得自行补充内容。
• 文件使用 UTF-8 编码保存。