lzl-worklog 工作产出记录·汇报

整理工作记录，生成给 Mentor、主管或协作者看的周报。支持工作记录类和云端提交类；两类都先按项目和功能主线概括成果，再说明各实际仓库承担的具体改动，保留必要的验证和交付状态。纯原生工具，无脚本依赖。

两类周报

• “根据这些记录”“梳理本周工作”按工作记录类；“根据云端分支”“只写已推送内容”“根据远端提交”按云端提交类。用户已经明确类型时不再问；未限定来源时默认工作记录类，只有两种口径会实质影响结果且意图无法判断时才询问。
• 来源口径不同，成稿结构相同：云端提交类需在取证时核对多条分支，成稿将同一功能的各仓改动整合、去重后呈现，不新增分支标题或分支交付章节。分支与提交定位留在证据素材中，用户要求时再展示。
• 个人周报按本人贡献整合：远端分支可能继承带教或同事的提交，不能将整条分支或整个功能归为本人完成。结合提交身份、父节点差异与已确认协作记录确认增量；在已有能力上适配或补充时写清“接入、复用、修复、完善”的具体部分。归属不明的改动先不计入个人已完成成果。
• 同一周分别保存两类时使用不同文件名，避免覆盖。切换类型不修改原日志，也不把一种类型的范围自动扩展给另一种。
• 生成云端提交类前读取 references/cloud-weekly.md；工作记录类沿用五源与日志流程。

闸口铁律（最高优先级，覆盖一切执行惯性）

以下闸口必须停轮等待：展示选项/候选后立即结束本轮回复，用户未回复前禁止任何扫描、提炼、落盘、派 agent：

闸口只在相应信息缺失或尚需本次写入确认时触发，已明确的选择不重复询问。仅在聊天中展示或修改草案时，不要求初始化存储、读取无关日志、确认正式归档或询问 Word；用户随后要求保存时，按清单确认规则处理。

• 禁止自问自答：同一回合内提出问题又自行回答并继续执行 = 违规（实测 Claude 会把"先问"叙述出来然后自己答掉一路跑完）。
• 回答含糊（"都行""好""随便"）≠ 明确选择，必须再问；无确认 = 0 条写入，绝不默认全选。

裸调用 /lzl-worklog（或 /worklog，无参数、未指向任何模式）→ 先闸口①问："全量扫描（建初始底账） / 梳理最近做了什么 / 随手记 / 出周报？"。用户话里已明确指向时直接进入："记录一下：…"→模式 B；"全量扫描/全量梳理"→模式 A（全量，跳过闸口②）；"梳理一下"→模式 A；"周报/汇报/产出/站会"→汇报。

存储布局

数据根 $DATA_ROOT 可通过环境变量 LZL_WORKLOG_DATA_ROOT（兼容 WORKLOG_DATA_ROOT）或配置文件 ~/.config/lzl-worklog/config.json 指定。未配置时默认为当前工作区 报告文档/需求/ 或全局 ~/worklog。

首次使用初始化（闸口⓪，硬停轮）

若未设置环境变量，且 ~/.config/lzl-worklog/config.json 不存在，且当前目录没有既有 报告文档/需求/： 向用户展示下列选项并立即结束本轮回复，停轮等待用户选择：

1. 【推荐】全局统一存储：~/worklog（跨项目统一记录，不会把周报写进代码仓库，安全且便于统一统计）
2. 当前项目工作区：./报告文档/需求/（与当前代码仓库同放，适合单项目强隔离）
3. 自定义路径：指定任意绝对路径

用户选定后，写入 ~/.config/lzl-worklog/config.json（格式形如 {"data_root": "<选中路径>"}），后续调用自动读取，不再重复询问。

目录结构

周粒度，以本周周一日期命名（周一为一周起始）：

$DATA_ROOT/  （支持 报告文档/需求/ 或 ~/worklog/）
├── 日志/<周一日期>.md        # 主动记录流水，只追加从不覆盖
└── 周报/
    ├── md形式/
    │   ├── <起点日期>.md             # 工作记录类，兼容既有文件名
    │   └── <起点日期>-云端提交.md     # 云端提交类
    └── word形式/                     # 导出时使用相同文件名主干及 .docx

为保持向下兼容，默认环境与原有规则下对应 报告文档/需求/日志 与 报告文档/需求/周报。

周起算

DOW=$(date +%u)                                  # 1=周一 ... 7=周日
MONDAY=$(date -d "$(date +%F) -$((DOW-1)) days" +%F)   # 本周一

<周一日期> 即 $MONDAY。周内任意调用都用它定位同一份文件。

上次搜索断点

模式 A 与汇报的日期范围选项「从上次搜索-现在」依赖一个断点文件：

$DATA_ROOT/.last-scan    # 一行，YYYY-MM-DD，= 上次执行会话扫描当天的日期（默认 报告文档/需求/.last-scan）

• 写入时机：模式 A 第 2 步五源扫描完成后、汇报第 3 步五源挖完后，执行 date +%F > "$DATA_ROOT/.last-scan"。只记录"扫描动作发生的日期"，与本次扫描选的范围起点无关。
• 读取：用户选「从上次搜索-现在」时 $START=$(cat "$DATA_ROOT/.last-scan" 2>/dev/null)；文件不存在或为空 → 告知无上次搜索记录，重新展示其余选项（仍在闸口②停轮语义内）。
• 断点按天粒度衔接：上次扫描当天的新会话会被重扫一次，由「去重」小节兜底跳过，不产生重复条目。

数据源

时区归一（重要，防边界日漏记录）

• CC timestamp 是 UTC（如 2026-08-12T02:00:00.000Z，本地 UTC+8 → 08-12 10:00）。
• 按日期过滤"本周/起点之后"前，统一把 CC timestamp 转本地再比较（date -d "<TS>" +%F）。
• 否则周一 00:00–07:59 落地的 UTC 记录（仍是上周日期）会被漏掉。
• Codex 目录/文件名已是本地时间，直接比较。
• ZCode 时间戳是 epoch 毫秒（绝对时间），无时区换算问题：起点转毫秒 $START_MS=$(( $(date -d "$START 00:00:00" +%s) * 1000 )) 后直接比较。
• MiniMax Code 时间戳同为 epoch 毫秒，无换算问题，比较方式同 ZCode；不要用目录名日期过滤（跨天长会话会漏，须用消息内末条 timestamp 判断）。
• Antigravity 时间戳为 UTC ISO 8601 字符串（如 2026-10-15 08:22:44+00:00），转本地再比较。桌面端（IDE / 2.0）与 CLI（agy）物理路径不同源，但底层表与 transcript 结构完全同构，统一双端扫描合并。

周报结构与表达

以下规则用于记录、候选提炼和周报成稿；用户明确指定的结构优先。

1. 项目 → 功能主线 → 各仓具体改动：以项目为主标题，先识别并概括读者关心的功能或工作主线，说明完成或完善了什么，再在同一功能下按实际涉及的仓库或模块说明各自的具体行为。例如在“AI 解读”下分别写 Web 页面、Server 解读能力，在“环境权限授权”下分别写各端职责。零散修复和验证归入相应功能，不抢占主线；独立事项单列。只写实际涉及的仓库，单仓或非代码项目按真实模块、交付物灵活组织；多个项目分别成节。
2. 每条信息适中：用简短功能名加一至三句，说明改了什么、影响哪个行为，以及需要保留的关键细节。合并同一事项的多轮修改，保留不同功能的差异。避免只有“优化体验、提升稳定性”等结论，也避免逐文件、逐命令、逐测试复述过程；不以固定条数或字数凑内容。
3. 不强制叙事标签：不要求每条都有“痛点问题—关键改动—实际效果”，也不换成另一套固定三段或四段。背景确有解释作用时融入一句；验证、提交或部署状态可放在条目末或各仓结尾，避免逐条重复。用户要求分析需求背景或业务价值时，再按需展开。
4. 仓库归属准确：跨仓功能分别说明各仓承担的实际改动，如命令行入口、服务端权限校验、前端授权反馈；不把同一个整体验证结果在各仓重复算作独立成果。维护在线表等协作事项可用简短附注承接，不为凑分类新增仓库。
5. 事实与时间准确：请求、计划、调查结论和实际修复分别陈述；未知不补造。区分工作发生日期、会话活跃日期和补录日期，不能把上周工作因本周补录而计成本周新增。区分本地验证、本地提交、推送分支、发布安装包和部署；技能发现与离线测试不能替代真实业务验收。
6. 术语服务于准确表达：保留读者需要辨认的项目、仓库、模块和功能名；陌生私有代号首次出现时补充职能说明。不要把具体功能过度泛化成空泛业务价值，也不要将“排查提交拦截原因”拔高成未经证实的“完善规则并解除阻塞”。省略 AI 调度、工具调试流水账及密钥等敏感内容。
7. 附加章节按需：不默认添加“下周重点与协作项”、风险清单或无依据的“暂无阻碍”。用户要求计划、记录里已有明确安排或站会场景需要时再写；建议与已确认安排分别标明。

记录与汇报的衔接

• 新记录和扫描素材尽量保留项目、仓库、实际发生日期、具体改动、验证与交付状态；未知归属不猜测，只有影响分组或结论时才询问。
• 历史日志中的三段式仍可作为事实材料读取，不为套用新格式回写旧日志。
• 用户已给出项目、日期、资料或已确认条目时直接沿用；工作记录类优先使用指定记录，不为凑五源重新全量扫描。云端提交类可用日志定位相关仓库、分支和本人工作范围，但成果本身必须由云端提交支持。只有资料不足以判断归属或完成状态时才补证。
• 用户只要求修改已展示草案时，直接按反馈重写；正式归档仍遵守清单确认闸口，不重复索要已明确的范围与结构。

ZCode 会话查询（SQLite）

ZCode 会话存在 SQLite 库里，必须只读打开（ZCode 运行时正占用该库，mode=ro 与 WAL 并发安全，已实测）：

START_MS=$(( $(date -d "$START 00:00:00" +%s) * 1000 ))   # $START=起点日期 YYYY-MM-DD
python - "$START_MS" <<'EOF'
import sqlite3, json, sys, os, datetime, pathlib
db = os.path.expanduser('~/.zcode/cli/db/db.sqlite')
con = sqlite3.connect(pathlib.Path(db).as_uri() + '?mode=ro', uri=True)
cur = con.cursor()
for sid, title, d, tc in cur.execute(
    "SELECT id, title, directory, time_created FROM session "
    "WHERE time_updated >= ? ORDER BY time_created", (sys.argv[1],)).fetchall():
    print(f"== {datetime.datetime.fromtimestamp(tc/1000):%m-%d %H:%M}  {title or '(无标题)'}  [{d}]")
    for (p,) in cur.execute("""SELECT p.data FROM part p JOIN message m ON p.message_id = m.id
        WHERE p.session_id = ? AND json_extract(m.data,'$.role') = 'user'
          AND json_extract(p.data,'$.type') = 'text'
          AND COALESCE(json_extract(p.data,'$.synthetic'), 0) = 0
        ORDER BY p.time_created""", (sid,)):
        t = json.loads(p).get('text', '').strip()
        if t: print('  U>', t[:120].replace('\n', ' '))
    tools = cur.execute("""SELECT DISTINCT json_extract(data,'$.tool') FROM part
        WHERE session_id = ? AND json_extract(data,'$.type') = 'tool'""", (sid,)).fetchall()
    print('  tools:', ', '.join(sorted(str(t[0]) for t in tools if t[0])))
EOF

• ~/.zcode/cli/db/db.sqlite 不存在 → 跳过该源并提示。
• session.title 由 CLI 维护（title_source 字段），质量可靠，可直接作会话主题（不像 CC 的 thread_name 实测多为"你好"）。
• synthetic=1 的 part 是系统注入（如 TodoWrite 提醒），不是真实用户输入，查询已排除。
• 仓库里 scripts/zcode_sessions.py 是同一条查询的可执行副本（python scripts/zcode_sessions.py <START_MS> [db]），单测直接驱动它。

MiniMax Code 会话查询

MiniMax Code（ZCode 系内核）会话按日期分层存 ~/.minimax/v2/sessions/YYYY/MM/DD/HH-MM-SS-mmm-session_*/，核心是 messages.jsonl，每行一个消息对象：message.role（user/assistant）+ message.content[]（text 块）+ message.timestamp（epoch 毫秒）。扫描脚本：

START_MS=$(( $(date -d "$START 00:00:00" +%s) * 1000 ))   # $START=起点日期 YYYY-MM-DD
python - "$START_MS" <<'EOF'
import json, glob, os, sys, datetime
sys.stdout.reconfigure(encoding='utf-8')   # 必须：Windows 下中文输出防 GBK 乱码
START_MS = int(sys.argv[1])
SKIP_PREFIX = ('<system-reminder', 'Base directory for this skill', 'This is a skill', '<background-task-finished', '[Request interrupted')
for f in sorted(glob.glob(os.path.expanduser('~/.minimax/v2/sessions/*/*/*/*-session_*/messages.jsonl'))):
    last_ms = 0; msgs = []
    for line in open(f, encoding='utf-8', errors='ignore'):
        try: o = json.loads(line)
        except: continue
        m = o.get('message') or {}
        ts = m.get('timestamp')
        if ts: last_ms = max(last_ms, ts)                      # 全文件末条，跨天会话不漏
        if m.get('role') != 'user': continue
        c = m.get('content', [])
        if not isinstance(c, list): continue
        for x in c:
            if isinstance(x, dict) and x.get('type') == 'text':
                t = x.get('text', '').strip()
                if t and not t.startswith(SKIP_PREFIX): msgs.append(t)
    if not msgs or last_ms < START_MS: continue                # msgs 空 = 纯注入会话，跳过
    print(f"{datetime.datetime.fromtimestamp(last_ms/1000):%Y-%m-%d}  {f}  {msgs[0][:80]}")
EOF

• 时间基准是消息内 timestamp，不是目录名日期（目录名是会话创建时刻，跨天长会话按它过滤会漏掉末条之后的日期）。
• <system-reminder>/skill 注入开头的 user 消息是系统注入不是真实输入，脚本已排除；全被排除的会话跳过。
• manifest.json 有 createdAtMs/updatedAtMs 但无标题与工作目录，会话主题只能用首条真实用户消息。
• ~/.minimax/ 不存在 → 跳过该源并提示。

Antigravity 会话查询（桌面端 + CLI 双端全覆盖）

Antigravity（AGY）提供独立 IDE/桌面端与 agy 命令行 CLI。桌面端与 CLI 物理存储不同源（桌面端保存在 ~/.gemini/antigravity/，CLI 保存在 ~/.gemini/antigravity-cli/），但两者底层架构完全同构：均由 conversation_summaries.db 管理元数据，brain/<id>/.system_generated/logs/transcript.jsonl 保存完整轨迹。脚本执行双端探测与合并：

python - "$START" <<'EOF'
import sqlite3, os, sys, datetime, pathlib, json
sys.stdout.reconfigure(encoding='utf-8')
START = sys.argv[1]            # YYYY-MM-DD；全量传 0000-00-00
dirs = [
    ('IDE', os.path.expanduser('~/.gemini/antigravity')),
    ('CLI', os.path.expanduser('~/.gemini/antigravity-cli')),
]
seen = set()
for label, base in dirs:
    db = os.path.join(base, 'conversation_summaries.db')
    if not os.path.exists(db): continue
    try:
        con = sqlite3.connect(pathlib.Path(db).as_uri() + '?mode=ro', uri=True)
        cur = con.cursor()
        for cid, title, lmt, uris in cur.execute(
            "SELECT conversation_id, title, last_modified_time, workspace_uris "
            "FROM conversation_summaries ORDER BY last_modified_time DESC"):
            if not lmt or cid in seen: continue
            dt_local = datetime.datetime.fromisoformat(lmt).astimezone()
            if dt_local.strftime('%Y-%m-%d') >= START:
                seen.add(cid)
                # 尝试轻读第一条真实用户输入作为补充说明
                prompt = ''
                tr = os.path.join(base, 'brain', cid, '.system_generated', 'logs', 'transcript.jsonl')
                if os.path.exists(tr):
                    for line in open(tr, encoding='utf-8', errors='ignore'):
                        try:
                            o = json.loads(line)
                            if o.get('type') == 'USER_INPUT' and o.get('content'):
                                t = o['content'].strip().replace('\n', ' ')
                                if not t.startswith('<system-reminder'):
                                    prompt = t[:80]; break
                        except Exception: pass
                print(f"[{label}] {dt_local:%Y-%m-%d %H:%M}  {title or '(无标题)'}  {prompt}")
    except Exception: pass
EOF

• 任一目录不存在则跳过该目录；两端均不存在则跳过该源并提示。
• title 由高精度模型生成，质量极佳，可直接作为候选主题。

记录 · 模式 B：随手记录

触发词："记录一下：..."、"记一下：..."。零摩擦，用户说啥记啥。

1. 计算本周一 $MONDAY（见"周起算"）。
2. 定位 $DATA_ROOT/日志/$MONDAY.md（默认 报告文档/需求/日志/$MONDAY.md），不存在则创建（含目录）。
3. 以当天日期 MM-DD 分节，追加具体改动。保留项目/仓库归属、已知发生日期和必要交付状态，不要求补齐痛点或效果标签；用户只提供一句事实时可单行记录：

## 08-12
### [集群数仓-命令行-输出格式] 统一费用查询的 CSV 输出
- 命令行工具：将费用查询结果统一为可解析的 CSV，补齐字段转义和错误退出码；已完成本地回归，尚未推送。

4. 当天节已存在则在其下追加；只追加，绝不覆盖或改动历史条目。

记录 · 模式 A：主动梳理

触发词："梳理一下最近做了什么"、"梳理一下"、"全量扫描"、"全量梳理"。在功能完成/阶段性完成或首次建账时使用。

1. 选日期范围（闸口②，硬停轮；全量扫描模式直接跳过本步）：
   • 穿透闸口②规则：若在闸口①选择了「全量扫描」，或用户指令明确包含「全量扫描」「全量梳理」「建初始底账」等全量意图，意图已锁定为全部历史，严禁再次询问日期范围，直接将起点设为全部（$START=0000-00-00，$START_MS=0），立即开始第 2 步扫描！
   • 若用户进入的是普通梳理，展示下列选项后立即结束本轮回复，用户明确选择后再扫描：
     • A. 本周一-现在（默认）——本周已有日志时起点取日志最后一个 ## MM-DD 节，跳过已记录项
     • B. 七天前-现在
     • C. 从上次搜索-现在——起点读「上次搜索断点」（见「上次搜索断点」小节）；无断点记录时告知用户"没有上次搜索记录"并重新展示其余选项等其选择
     • D. 全部历史——全量挖掘历史全部会话（$START=0000-00-00，$START_MS=0）
     • E. 自定义——向用户要起止日期
2. 扫最近/全量会话（五源探测）：
   • CC：~/.claude/projects/**/*.jsonl，按 JSONL 内 "timestamp"（转本地时区）筛选 ≥ 起点（全量时不作起点过滤）。
   • Codex：~/.codex/sessions/YYYY/MM/DD/*.jsonl（本地时间）+ archived_sessions/ 兜底，目录/文件名日期 ≥ 起点（全量时扫全部日期）。~/.codex/ 不存在则跳过该源并提示。
   • ZCode：~/.zcode/cli/db/db.sqlite 按「ZCode 会话查询」小节执行，time_updated >= $START_MS 筛选（全量时 $START_MS=0）。库不存在则跳过该源并提示。
   • MiniMax Code：~/.minimax/v2/sessions/*/*/*/*-session_*/messages.jsonl 按「MiniMax Code 会话查询」小节执行，消息内 timestamp（epoch 毫秒）≥ $START_MS 筛选（全量时 $START_MS=0）。目录不存在则跳过该源并提示。
   • Antigravity：按「Antigravity 会话查询」小节同时扫描桌面端 ~/.gemini/antigravity 与 CLI ~/.gemini/antigravity-cli，last_modified_time 转本地时区 ≥ 起点（全量时不作过滤）。两端均不存在则跳过该源并提示。
   • 五源扫完后执行「上次搜索断点」小节的写入动作。
3. 提炼候选（按项目与仓库分组，仅供展示，禁止直接落盘）：
   • 轻读各源真实用户消息、工具调用及结果，合并同一事项的重复记录。按项目、实际仓库分组，保持候选连续编号；每条写具体改动、必要细节及可证实的验证/交付状态，不强制补写背景或效果：

     集群数仓相关开发 / 命令行工具
     1. **统一查询输出**：修复 CSV 转义和错误退出码，完成本地回归；尚未推送。
     集群数仓相关开发 / 服务端
     2. **补充凭证接口校验**：校验操作人身份与目标集群，保留权限不足提示；真实授权待配套环境验收。

   • 按「周报结构与表达」保持具体、适度；保留必要仓库与功能名，省略 AI 调度、调试流水账及密钥。记录实际发生日期，勿将会话活跃时间直接当成全部工作的发生日期。
4. 用户确认（闸口③，硬停轮，必须精确到条目）：展示编号候选 + "要记哪几条？"（如"记 1、3"或"只记第 2 条"）后立即结束本轮回复。用户未明确选择的条目，一律不得写入。 回答含糊（"都行""好"）≠ 选择，必须再次询问，不得默认全选。
5. 落盘（只写用户确认的条目）：严格按用户确认的编号/条目，将具体改动及项目/仓库归属、已知发生日期和必要交付状态追加到 $DATA_ROOT/日志/$MONDAY.md（默认 报告文档/需求/日志/$MONDAY.md）。落盘后回执："已写入 N 条：<条目列表>"；未写入的候选列出提醒（可改天再记）。

去重与防丢失

去重（两种模式落盘前都执行）

1. 读 $DATA_ROOT/日志/$MONDAY.md（默认 报告文档/需求/日志/$MONDAY.md）现有条目，提取所有 [需求名] 标签（- [XX] ...）。
2. 新条目 [需求名] 已存在 → 跳过并提示"该需求已记录，跳过"，不重复追加。
3. 语义相近但标签不同 → 模式 A 由用户确认时人工去重；模式 B 提示用户"是否合并到已有条目"。

防丢失

• 日志文件只追加从不覆盖；生成周报只写 周报/，绝不改动 日志/。
• 模式 A 定期（阶段完成时）捞会话兜底，与随手记录互为备份。

汇报（触发词：周报 / 汇报 / 产出 / 站会）

1. 计算本周一 $MONDAY，依据「两类周报」确定来源口径，沿用用户已选类型。
2. 工作记录类优先使用用户指定材料，需要补充主动记录时再读 $DATA_ROOT/日志/$MONDAY.md。云端提交类先按 references/cloud-weekly.md 核验仓库、远端引用和范围内实际差异；不把会话中的“已推送”声明直接当作云端证据。仅展示草案且给定材料已足够时，不要求先读取存储配置或无关日志。
3. 确定日期与材料范围：用户已明确“本周”等日期或指定“这些记录”时直接沿用；范围不明时才进入闸口②，展示 A. 本周一-现在（默认）/ B. 七天前-现在 / C. 从上次搜索-现在（无断点记录时说明并重新展示其余选项）/ D. 自定义后立即结束本轮回复。先核对实际工作日期，剔除只在本周补录的上周工作；前期成果的本周整合、验证和交付可如实记录为本周进展。材料已足够时无需再扫描。工作记录类需要补证时读取范围内相关会话源；云端提交类依据云端流程核对提交日期、基线与引用，不强制扫描五源。任一源不可读则披露，不当作没有工作。只有实际会话扫描才更新会话搜索断点，云端核验不更新该断点。记范围起点 $START（周报文件名据此）：
   • A → $START=$MONDAY
   • B → $START=$(date -d "-6 days" +%F)（含今天共 7 天）
   • C → $START= 断点文件里存的日期
   • D → $START= 用户给的起始日期
4. 材料较多或需要补证时，按需并行派代理提炼素材（契约见 references/agent-team-contract.md），受宿主并发能力约束。工作记录类可按五源分工；云端提交类宜按仓库分工，提供范围、相关分支和取证边界。代理可直接返回素材或写到指定中间文件。被跳过的源不派代理、不产空草稿；已有材料足够时不重复派任务。
5. 主线程合成草案（暂不落盘）：按选定类型的证据提炼成果，按「周报结构与表达」先概括项目的功能主线，再说明各仓具体改动。云端提交类将多分支的同一改动整合去重，不按分支列标题、不混入未推送工作；互斥实现不假装已经合为同一版本。跨仓事项说明各自承担部分，保留必要状态，不泛化为空泛价值，不强制三段式或下周计划。附简短编号清单用于正式归档确认，可引用正文已有编号，不重复整份内容。
6. 正式归档前的清单确认（闸口③，硬停轮）：需要正式保存且尚无本次内容确认时，展示编号清单，问"全部写入，还是删掉哪几条？"后立即结束本轮回复。用户确认后才写入；点名删除的条目剔除；含糊回答必须再问，无确认不写。仅展示或修改草案时直接返回正文，不为归档另行提问。
7. 正式保存时确定 $REPORT_STEM：工作记录类为 $START，云端提交类为 ${START}-云端提交；写入 $DATA_ROOT/周报/md形式/$REPORT_STEM.md。只清理本次实际生成的中间草稿，不删除另一类周报或既有成果。
8. 触发词含"站会/晨会" → 内容自动对齐 Scrum 节奏，直接作为站会发言稿。

周报模板（项目 → 功能主线 → 各仓具体改动）

两类共用以下结构；按实际功能、涉及的仓库和用户要求调整。正式正文保留读者需要的具体改动，来源定位留在素材中；云端取证时涉及的分支不成为正文副标题。

# <项目名称及本周工作，如：集群数仓相关开发>

时间：<起点>—<终点>

## 一、<功能主线>

<简要概括功能及其用户可见行为。>

- **Web — <具体改动>**：<页面或交互的实际变化>。
- **Server — <具体改动>**：<接口、校验或数据处理的实际变化>。
- **CLI — <具体改动>**：<命令行实际承担的变化>。

<必要时集中说明验证及交付状态。>

## 二、<另一功能主线>

- **<实际涉及的仓库或模块> — <具体改动>**：<说明具体行为>。

<如有必要，用短句附注交付表或协作资料更新；不默认添加下周计划。>

9. 正式写入后告知日期、周报路径与材料覆盖情况；仅展示草案时不宣称已保存。无记录无会话时提示先"记录一下"或"梳理一下"。
10. 正式周报写入后，可询问用户是否需要导出 Word；仅展示或修改聊天草案时不追加此问题。需要则查本地 docx 相关 skill，将本次 $DATA_ROOT/周报/md形式/$REPORT_STEM.md 转为 $DATA_ROOT/周报/word形式/$REPORT_STEM.docx，两类文件不互相覆盖；查不到则告知用户并询问替代方案。