| 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：读取项目背景
根据用户列出的项目，并行读取每个项目的：
C:\GitHub\<ProjectName>\architecture.mdC:\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：生成周报
按模板结构生成完整周报，要求：
-
按模板分类归入正确 section：
- 论文/开源调研 → Section 1（研究与阅读）
- 数据集收集 → Section 2（数据采集）
- 算法改进/调参/训练 → Section 3（算法研发）
- 环境部署/ROS开发/系统编码 → Section 4（系统开发）
- 实机测试/性能评测 → Section 5（实验测试）
- 文档/协作 → Section 6（团队协作）
-
技术细节准确：利用 architecture.md 中的术语和模块名，描述具体而非泛泛。
-
量化结果前置：有指标（PSNR/ATE/成功率等）的任务，在描述开头直接给出数字。
-
链接附上：论文、开源项目、调研页面等均需附 URL。
-
时间标注：每条任务末尾标注 （约 x 小时）。
Step 7：保存文件
将生成内容写入 C:\Work\Research\TingdeLiu-YYMMDD.md，并告知用户：
- 文件路径
- 提交截止时间：下周一 9:30 前
- 上传命令（日期替换为本周日的 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 编码保存。
