skill-forge-hub 0.0.0-stage → 0.2.0

package/spec-spec2doc/resources/pdf-path.md

@@ -0,0 +1,21 @@
+# PDF 双路径
+
+## 路径 A：LaTeX（排版质量高，需安装引擎）
+
+- 引擎探测：`xelatex --version`（xelatex 原生支持 UTF-8 中文）
+- 安装（跨系统）：macOS `brew install --cask basictex`（体积小，装完按需 `sudo tlmgr install ctex`）；Windows `winget install MiKTeX.MiKTeX`；Linux Debian/Ubuntu `sudo apt-get install texlive-xetex texlive-lang-chinese`
+- CJK 字体：`pandoc <输入.md> -o <输出.pdf> --pdf-engine=xelatex -V CJKmainfont="<字体>"`
+  - 字体探测：macOS `fc-list :lang=zh`（常见 Songti SC / PingFang SC）；Windows SimSun / Microsoft YaHei；Linux Noto Sans CJK SC
+  - 未指定时列出可用字体让用户选；探测不到中文字体时放弃 LaTeX 路径走 Chrome 打印路径
+- 转换：`pandoc <输入.md> -o <输出.pdf> --pdf-engine=xelatex -V CJKmainfont="<字体>" -V geometry:margin=2.5cm [--toc]`
+
+## 路径 B：Chrome headless 打印（免 LaTeX，跨系统兜底）
+
+- 流程：`pandoc <输入.md> -s --self-contained -o <输出.html>` → Chrome headless `--headless --print-to-pdf=<输出.pdf> --no-pdf-header-footer <输出.html>`（--no-pdf-header-footer 去掉默认页眉页脚；不支持的老版本 Chrome 用 --print-to-pdf-no-header）
+- Chrome 路径探测（跨系统）：macOS `/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`；Windows 按序探测 `C:\Program Files\Google\Chrome\Application\chrome.exe` → `C:\Program Files (x86)\Google\Chrome\Application\chrome.exe` → `%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`；Linux `google-chrome` / `chromium`；均无则换 Edge（路径同族探测）
+- 版式：可加 `--css=<样式.css>` 定制打印版式（页边距、字体）
+- 引擎决策：PDF_ENGINE=auto 时先探测 xelatex，无则走 Chrome 打印路径并在报告注明「PDF 由 HTML 打印生成」
+
+## 引擎缺失兜底
+
+- xelatex 与 Chrome 都缺失：先出 Word（主路径），提示用户用 Word「另存为 PDF」

package/spec-spec2doc/resources/usage-guide.md

@@ -0,0 +1,32 @@
+# spec2doc 使用指南
+
+## 能干什么
+
+把 Markdown 规格 / 技术文档导出为 Word / PDF 交付文档：AI 先整理排版，Pandoc 机械转换，AI 回验纠错直到通过。Word 支持模板（默认探测源目录 template.docx，可配置）；PDF 双路径（LaTeX 或 Chrome 打印，免装 LaTeX 也有兜底）；输出默认与源文档同目录，可配置。
+
+## 使用方式
+
+1. 直接说「把这份规格导出成 Word」「生成 PDF 交付文档」并给出文件路径
+2. 未装 Pandoc 时按引导安装（macOS brew / Windows winget / Linux apt-get）
+3. AI 整理排版（标题层级/表格/图片路径），Pandoc 输出 .docx（主路径）或 .pdf（xelatex / Chrome 打印双路径）
+4. AI 回验内容完整与格式正确（发现问题修正重转，≤3 轮）后交付
+
+## 支持格式
+
+- 输出 Word（.docx，主路径，支持模板与目录）
+- 输出 PDF（.pdf，LaTeX 引擎或 Chrome 打印）
+
+## 常用说法
+
+- 「输出到桌面」→ 临时改输出目录
+- 「用公司模板」+ 路径 → 指定 Word 模板
+- 「不要目录」→ 去掉 TOC
+- 「必须用 LaTeX 出 PDF」→ 强制 LaTeX 路径（无引擎则引导安装）
+
+## 产出
+
+与源文档同目录的 .docx / .pdf，附回验结论与兜底说明。
+
+## 触发词
+
+导出成 Word / 生成 PDF / 规格转文档 / 打包交付文档 / /spec2doc

package/template/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: skill-name            # 技能名（英文短横线，与目录名一致）
+description: 一句话说清做什么 + 触发词。当用户请求 … 或询问 … 时使用。
+allowed-tools: Bash, Read, Write   # 按需裁剪
+disable-model-invocation: false
+---
+
+# 技能标题
+
+一句话说明技能产出与默认行为。
+
+## 生成流程
+
+1. **阶段一（做什么）** → 读 `resources/xxx.md`
+2. **阶段二（做什么）** → 读 `resources/yyy.md`
+3. **阶段三（做什么）** → 读 `resources/zzz.md`
+4. **使用咨询**（用户只问用法、未要求生成）→ 读 `resources/usage-guide.md` 原样输出（首行标题改为「XX使用指南」），不执行任何生成动作
+
+## ⚙️ 默认配置（用户可手动修改；临时口头要求永远优先）
+
+```yaml
+DISK: true      # 示例配置项：是否落盘写文件；false = 默认只在对话输出
+DIR: auto       # 示例配置项：落盘根目录
+```
+
+> 临时口头要求（仅对当次生效，不修改上方配置）：说「xxx」→ 当次改某行为；……
+
+## 📝 自定义模板（TEMPLATE: custom 时启用，用户可手改）
+
+把顶部 TEMPLATE 改为 custom 后，按下面结构生成（段名、段数、条目格式均可改）：
+
+```text
+段一：……（每条：……）
+段二：……（每条：……）
+```
+
+> 只写段结构与条目格式即可；未写明的细节沿用默认规范。
+
+## 规则速览
+
+- 硬性规则 3-5 条（序号格式 / 条目数量 / 兜底 / 单位等）
+- 完整规则见 `resources/content-rules.md`

package/template/resources/README.md

@@ -0,0 +1,20 @@
+# resources/ 拆分规范
+
+重内容按生成阶段一文件一职责拆分；SKILL.md 流程节点标注「读 resources/xxx.md」，AI 执行到对应阶段才读取对应文件，不提前全部加载。
+
+常用拆分（按技能实际情况增删）：
+
+| 文件 | 职责 |
+|:---|:---|
+| `usage-guide.md` | 用户可读使用说明；咨询应答（只问用法）时的原样输出源 |
+| `date-parsing.md` | 时间/日期/周的自然语言解析规则 |
+| `data-collection.md` | 数据收集：来源清单 / 命令模板 / 口径过滤规则 |
+| `content-rules.md` | 内容聚合与写作规则 + 输出格式模板 |
+| `industry-dictionary.md` | 行业 / 角色词典（触发词与词条表） |
+| `disk-and-html.md` | 落盘行为 / HTML 样式 / 截图规范 |
+
+约定：
+
+- 每份 resource 独立可读，不互相引用（避免读取链断裂）
+- 用户可手改的配置（默认配置 / 自定义模板）必须留在 SKILL.md，不进 resources
+- resource 内标题用原章节标题，内容从旧版单文件 SKILL.md 原样迁移

package/weekly-report/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: weekly-report
+description: 生成工作周报（默认本周完成任务/下周计划/风险阻塞点三段结构，中文顿号序号，1D=8H），适配各行业（内置 12 行业职业词典，可指定角色身份）。数据来源灵活：各仓库 git 提交聚合、纯文字、图片或文件整理，无 git 也适用。支持自定义模板（可永久或临时指定）、周结束日可配置（默认周五，可改周日等）。支持自然语言定位周（本周/上周/10月第2周/10月20号所在周等）。当用户请求写周报、本周周报、上周周报、生成周报、/weekly-report，或询问周报用法（周报怎么用/周报使用说明/周报有哪些使用方式）时使用。
+allowed-tools: Bash, Read, Write
+disable-model-invocation: false
+---
+
+# 周报生成
+
+聚合各仓库 git 提交 + 本次会话口述内容生成三段式周报（本周完成任务/下周计划/风险阻塞点 + 本周概览卡），对话输出 md 正文 + 落盘 md/txt/html/content-png 并自动打开 html。
+
+## 生成流程
+
+0. **读用户配置**（DISK/FORMATS/DIR/OPEN_HTML/TEMPLATE/ROLE/CONFIRM、自定义模板）→ 先 Read 同目录 `user-config.md`
+1. **解析周**（自然语言 → 目标周：周一起点、WEEK_END 结束日）→ 读 `resources/date-parsing.md`
+2. **收集数据**（本周 git + 会话口述 + 口头补充，合并去重；同取上周数据供概览环比）→ 读 `resources/data-collection.md`
+3. **内容归类与润色**（聚合来源 / 补充任务 / 纯文字模式 / 输出格式 / 写作风格）→ 读 `resources/content-rules.md`
+4. **行业词条**（话术含职业词时按词典取词）→ 读 `resources/industry-dictionary.md`
+5. **落盘与截图**（md/txt/html/content-png + 自动打开 html）→ 读 `resources/disk-and-html.md`
+6. **使用咨询**（用户只问「周报怎么用」等用法、未要求生成）→ 读 `resources/usage-guide.md`，将其内容原样输出（首行标题改为「周报生成器使用指南」），不收集 git、不生成报告、不落盘、不开浏览器
+
+## ⚙️ 配置与自定义模板
+
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（DISK/FORMATS/DIR/OPEN_HTML/TEMPLATE/ROLE/CONFIRM）与自定义模板都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留。
+
+## 规则速览
+
+- 完成任务 5-15 点、每点 30-60 字；序号用中文顿号（1、2、3）
+- 三段兜底写「暂无」；计划点带进度百分比与预估用时；风险阻塞点三环（问题+影响+建议）
+- 用时单位 X.XD（天，1D=8H），估算值注明「约」；落盘子目录名 = 当周最后一天（WEEK_END）日期
+- 完整规则（聚合来源 / 纯文字模式 / 写作风格约束 / 使用提示）见 `resources/content-rules.md`

package/weekly-report/resources/content-rules.md

@@ -0,0 +1,82 @@
+# 内容规则
+
+## 输出内容与数据来源
+- 三段结构：本周完成任务（5-15 点）/ 下周计划 / 风险阻塞点
+- 任务点格式：1、任务描述（量化数据：文件数/行数/提交次数）- 进度XX% - 用时X.XD（1D=8H）
+- 任务来源（默认）：各仓库本周 git 提交自动聚合（同主题多日提交合并为一条）+ 本次会话中用户已提及/口述的工作内容 + 用户口头补充，全部合并去重；仅当用户明确说"只整理这段文字/只按这段"时才忽略 git 与会话上下文、只用指定文字（见「纯文字整理模式」）
+- 「下周计划」取材双通道：①用户口述/文字补充的计划（优先并入）；②一次生成多周周报、或后续日期日报已生成时（本次批量生成中下一周的周报，或 reports 目录中已存在的后续日报/下周周报），从下一周周报的「本周完成任务」（无下周周报时从下周各日报的完成任务）中抽取任务作为「下周计划」（抽取数量灵活、不设死上限：下周完成任务多且连续性强时可多抽至 5-6 条，少则抽 2-3 条，与下一周内容形成呼应即可），描述改写为计划语气（完成态改进行态：如「完成 XX 重构」→「推进 XX 重构」「继续 XX 开发」，去掉量化数据/进度/用时）；批量多周时优先保证跨周连续性：抽取时尽量让本周「下周计划」与下一周「本周完成任务」形成「计划→完成」的同主题承接链（如本周计划「启动 XX 重构」→ 下周完成「完成 XX 重构」，长期任务串成连续的工作链）；无后续数据时，该段按口述或「暂无」处理
+- 量化数据取自 git --stat（文件数、增删行数）；用时为合理估算（git 不记录耗时，估算值注明"约"，可口头修正）
+- 数据收集范围（按当前系统自动选择，另一系统的仓库自动跳过）：macOS = NearCast / nearcast-server / nearcast-go / nearcast-admin / SmartCanteenConsumerMachineApp / TrustPay 共 6 个仓库；Windows = srf-app / srf-manage / srf-operation / srf-service / srf-web-user / srf-web-operation / srf-web-wx / srf-web-h5-teacher / srf-web-uop / Spec-Core-Smart-Canteen 共 10 个仓库；本周无提交的仓库不写入
+- HTML 版为参考图式深蓝面板卡片美化样式（实心深蓝卡片 + 细密水平条纹 + 上下边缘高光线 + 左缘节色条，保留 ask 同款发光动效）：附「本周概览」Bento 卡片（完成率圆环大卡 + 提交热力图 5天×3时段 + 提交数/活跃天数/涉及文件/代码行数四指标 + 提交节奏柱图带 hover 明细 + 环比行）、顶部「一键复制」按钮（复制纯文本版）+ TL;DR 摘要行、「本周完成任务」标题右侧带周范围徽章（跟随 WEEK_END）+ 进度条终点圆点与流星扫描填充 + 液态玻璃卡片（@supports 兜底）+ CRT 扫描光带 + 全页 3D 微倾斜（±0.75°）、页脚署名 GENERATED BY SPECCORE TEAM（周范围动态跟随 WEEK_END），并随 FORMATS 默认落一张内容区截图 content-png（概览与卡片整体 + 四周留白 + 周范围徽章）
+
+## 用户补充任务
+
+用户调用时可能口头追加任务（如"还有一件事：这周处理了两天的支付问题"），按以下规则处理：
+
+- **触发**：话术含"补充/加上/还有/另外/以及/对了"等追加词，或直接口述任务内容（说"整理成周报/只整理这段文字/只按这段/不用 git"时走「纯文字整理模式」，不是追加）
+- **分段**：补充内容带分段词时按段并入——"下周计划/计划：xxx"→ 下周计划段；"风险/阻塞：xxx"→ 风险阻塞点段（说"风险暂无/无风险"→ 风险段写「暂无」）；不带分段词默认并入"本周完成任务"
+- **拆条**：按语义主题拆分，一个主题一条；拆分信号：时间词（周几/上几天）、追加连接词、分号顿号列举、数字列举（1、2、3）
+- **润色**：口语整理为规范任务描述（动词开头、说清对象与结果）；周报粒度较粗，多条零散小任务合并为一个周交付物条目（30-60 字）；用户未给量化数据时，优先从 git 提交补文件数/行数，无记录则省略量化、只写进度与用时（估算值注明"约"）
+- **去重**：与 git 聚合任务合并时，同一件事只保留一条
+- **格式**：与 git 聚合条目同格式，接在"本周完成任务"下继续编号
+
+## 纯文字整理模式（用户贴一段文字，无 git 提交）
+
+用户调用时直接贴一段文字并说"整理成周报/根据这段生成周报"（可能不是开发岗位，没有任何 git 提交），按以下规则处理：
+
+- **触发**：话术含"整理/根据这段/以下内容/帮我梳理"等 + 附了一段多句文字/图片/文件，或明说"只整理这段文字/只按这段/不用 git/别收集 git"（与"写周报 + 补充一下"的区别：文字/图片/文件是唯一主源、跳过 git 与会话上下文，不是追加）
+- **数据来源**：用户文字/图片/文件为主源，**跳过 git 收集**（不跑 git 命令）且忽略本次会话其它工作内容；图片用 Read 视觉理解提取图中文字信息，md/txt 直接读文本，docx/pdf 优先尝试 pandoc 转文本（无 pandoc 则请用户粘贴文字）；用户是开发且内容提到代码相关工作时，可仍收集 git 用于补量化数据
+- **三段归类**（用户文字没按段写明时用信号词归类）：
+  - 含"下周/接下来/计划/准备/打算/将要/待办" → 下周计划
+  - 含"风险/阻塞/问题/卡住/困难/待定/依赖/遗留" → 风险阻塞点
+  - 其余 → 本周完成任务；全段无任何信号词 → 全部归入本周完成任务
+  - 用户已明确分段（"本周完成：A；下周计划：B；风险：C"）→ 按用户分段，不猜
+- **拆条**：按语义主题拆分，一个主题一条；拆分信号：时间词（周几/前几天）、连接词（还有/另外/以及）、分号顿号列举、数字列举（1、2、3）、换行/段落边界
+- **润色**：口语整理为规范任务描述（动词开头、说清对象与结果）；周报粒度较粗，多条零散小任务合并为一个周交付物条目（30-60 字）
+- **量化数据**：无 git 提交 → 不写文件数/行数/提交次数；格式退化为「1、任务描述 - 进度XX% - 用时X.XD」
+- **进度与用时**：文字没给进度时，完成任务默认 100%、计划默认 0%；用时/预估用时仅在用户文字给出时才写，没给就省略（不瞎编估算值）
+- **风险阻塞点**：只列描述
+- **周定位/落盘/HTML**：与常规流程一致（默认本周、md/txt/html 三文件 + 内容区截图落盘、html 自动打开）；html 概览卡片无 git 数据时只显示完成任务/计划/风险条数统计
+
+## 输出格式
+
+```markdown
+# 本周周报 - YYYYMMDD ~ YYYYMMDD
+
+> 生成时间：YYYY-MM-DD HH:MM:SS
+
+## 本周完成任务
+1、任务描述（量化数据：文件数/行数/提交次数）- 进度XX% - 用时X.XD
+
+## 下周计划
+1、任务描述 - 进度XX% - 预估用时X.XD
+
+## 风险阻塞点
+- 阻塞描述
+```
+
+## 规则
+
+- 完成任务 5-15 点，每点 30-60 字；序号用中文顿号（1、2、）
+- 聚合后任务数超上限（15 点）时，同类小任务合并压缩到上限内；用户说「精简点/太长了」→ 条目数取下限、每点压缩到 30 字左右；说「详细点」→ 条目数取上限、每点写足 60 字
+- 三段兜底：完成任务默认进度 100%；本周完成任务/下周计划/风险阻塞点无任何内容时该段写「暂无」（默认聚合时下周计划无 git 来源，用户没给计划就写「暂无」）
+- 计划每点带进度百分比与预估用时
+- 风险阻塞点三环结构：问题+影响+建议，不写进度用时
+- 用时单位：X.XD（天，1D=8H），估算值注明"约"
+- 文字风格约束：①下周计划用计划态陈述句，动词取「推进/启动/开展/跟进/梳理/筹备/验证/排查/联调」等计划态词，禁用完成态词（完成/搞定/已实现/做完），可带「计划/预计/拟」字样（不必每条都有），句式「动词+对象+目标范围」（如「推进底部导航重构，完成主流程交互调整」），禁祈使句（「去做 xx」）与口语（「把 xx 弄一下/搞搞」）；②完成任务用动词开头的完成态陈述句（完成/修复/优化/重构/开发/实现/接入/升级/排查/联调/上线），说清对象与结果（如「完成底部导航重构」）；③风险阻塞点三环结构：问题+影响+建议（问题客观陈述、影响说明后果、建议给出可执行对策），不写抱怨与情绪话；④全文通用：不用第一人称「我」、不用口语语气词（啦/啊/吧/哈/哦/呢）、不用 emoji、不用口语形容词（差不多/还行/基本上/搞不定/一堆）；用户口述/补充的口语内容一律先润色为规范书面语再写入（「上午改了角标接口」→「完成角标接口改造」），量化数据（文件数/行数/进度/用时）格式不变
+- 报告标题下输出生成时间，精确到时分秒（YYYY-MM-DD HH:MM:SS）
+- 生成报告时，对话中先输出简要「使用提示」（几条速览 + 完整说明引用）再输出报告正文，固定条目：
+  - 默认生成本周；「上周周报 / 10月第2周的周报 / 10月20号所在周的周报」指定周
+  - 「补充一下：xxx」追加任务（「下周计划：/风险：」分段词自动归段）；贴文字/发图片/给文件「整理成周报」默认直接生成，说「先看看效果」→ 确认后再落盘
+  - 默认聚合 git 提交 + 本次会话已提的工作内容；说「只整理这段文字」→ 仅用该文字
+  - 「写到桌面 / 不落盘 / 只要 md / 只要截图 / 这次不截图 / 别开浏览器 / 保留之前的」临时控制落盘；「这次按 xxx 模板来」临时换模板；「这周按周日收尾」临时改周结束日
+  - 生成完成后在对话中告知本次落盘的文件完整路径清单（目录 + 各文件名，Windows 用反斜杠）
+  - 默认配置长期生效：改 skill 文件顶部「默认配置」节（DISK/FORMATS/DIR/OPEN_HTML/TEMPLATE/WEEK_END/CONFIRM）
+  - 📖 完整使用说明：问「周报怎么用」
+- 默认聚合来源：git 提交 + 本次会话中用户已提及/口述的工作内容全部合并去重；仅当用户明确说"只整理这段文字/只按这段"时，才只用指定文字、忽略其它来源
+- 纯文字整理模式：用户贴一段文字/发图片/给文件说"整理成周报/只按这段"时跳过 git 收集与会话上下文，内容为主源（图片 Read 视觉提取、md/txt 直接读、docx/pdf 优先 pandoc 转文本）；按信号词自动三段归类（用户已分段则按用户分段）；无量化数据不写文件数/行数，进度默认完成 100%/计划 0%，用时用户没给就省略；CONFIRM: never 默认直接生成落盘不确认，CONFIRM: text/always 或用户说"先看看效果"时先出整理效果、用户说"可以/确认/落盘"后再落盘，说"改一下 xxx"按意见修改后重新确认，说"不用确认/直接落盘"跳过确认（CONFIRM 配置控制，临时口头要求优先）
+- 模板优先级：用户临时口头指定的模板 > 顶部 TEMPLATE 配置（custom 用「📝 自定义模板」节结构，default 用内置三段式）；自定义模板只改段名/段数/条目格式，其余规范（中文顿号序号、生成时间、落盘、HTML 样式）不变
+- 目录名 = 当周最后一天（顶部 WEEK_END，默认周五）的日期，不是生成时刻：本周周报目录用本周五日期；用户可改 WEEK_END: sunday 等（则用周日日期）；周范围、标题日期范围、git 收集范围同步跟随 WEEK_END
+- 周定位优先按自然语言解析（如"10月第2周"、"10月20号所在周"）；显式参数 `/weekly-report [YYYYMMDD] [md|txt|html]`（参数为该周任一日期）等价于自然语言，缺省为本周 + md
+- 跨系统兼容：执行时先检测当前系统（macOS/Windows），所有路径、命令、浏览器均按系统分支取值（DIR auto→DIR_MAC/DIR_WIN、仓库表对应路径列、Chrome/Edge 路径、open/Start-Process、桌面/回退目录）；禁止假设单一系统
+- 落盘行为读取顶部「默认配置」（DISK/FORMATS/DIR/OPEN_HTML/TEMPLATE/WEEK_END/CONFIRM）；优先级：用户临时口头要求（不落盘/写到桌面/只要 md/只要内容区截图/只要截图/这次不截图/别开浏览器/临时换模板/临时改周结束日/先看看效果/不用确认等，仅当次生效）> 顶部默认配置；DIR（按系统解析）目录/盘符不存在时回退用户主目录 reports（macOS=~/reports、Windows=%USERPROFILE%\reports）；同一周重复生成覆盖原文件，用户说"保留之前的"则时间戳另存

package/weekly-report/resources/data-collection.md

@@ -0,0 +1,41 @@
+# 数据收集
+
+先检测当前系统再取对应路径列（macOS：`uname -s` 返回 Darwin；Windows：`node -e "console.log(process.platform)"` 返回 win32），按需检查以下工作区本周（周一至周结束日 WEEK_END，默认周五）提交，聚合产出；同时统计上周同范围（周一至上周周结束日）提交数/完成任务数，供概览卡环比行使用。只汇总有提交的仓库：
+
+| 仓库 | macOS 路径 | Windows 路径 |
+|---|---|---|
+| NearCast | /Users/luzhaosheng/SmartDeveloper/DevWorkspace/Android_Studio/NearCast | - |
+| nearcast-server | /Users/luzhaosheng/SmartDeveloper/DevWorkspace/IntelliJ_IDEA/nearcast-server | - |
+| nearcast-go | /Users/luzhaosheng/SmartDeveloper/DevWorkspace/GoProject/nearcast-go | - |
+| nearcast-admin | /Users/luzhaosheng/SmartDeveloper/DevWorkspace/WebProject/nearcast-admin | - |
+| SmartCanteenConsumerMachineApp | /Users/luzhaosheng/SmartDeveloper/DevWorkspace/Android_Studio/SmartCanteenConsumerMachineApp | - |
+| TrustPay | /Users/luzhaosheng/SmartDeveloper/DevWorkspace/Android_Studio/TrustPay | - |
+| srf-app | - | d:\Workspace_Java\srf-app |
+| srf-manage | - | d:\Workspace_Java\srf-manage |
+| srf-operation | - | d:\Workspace_Java\srf-operation |
+| srf-service | - | d:\Workspace_Java\srf-service |
+| srf-web-user | - | d:\Web_Projects\srf-web-user |
+| srf-web-operation | - | d:\Web_Projects\srf-web-operation |
+| srf-web-wx | - | d:\Web_Projects\srf-web-wx |
+| srf-web-h5-teacher | - | d:\Web_Projects\srf-web-h5-teacher |
+| srf-web-uop | - | d:\Web_Projects\srf-web-uop |
+| Spec-Core-Smart-Canteen | - | d:\Workspace_QCoder\Spec-Core-Smart-Canteen |
+
+- 「-」= 该仓库在当前系统不存在，跳过；当前系统对应列全为「-」（陌生机器）时跳过 git 收集，只按会话/文字内容生成
+
+命令模板：
+
+```bash
+git -C <仓库路径> log --since="YYYY-MM-DD 00:00:00" --until="YYYY-MM-DD 23:59:59" --pretty=format:"%h %s" --stat
+```
+
+- 日期范围取本周周一 00:00 至周结束日（WEEK_END，默认周五）23:59，缺省参数时以当前日期所在周为准
+- 汇总每个提交涉及的**文件数**与**增删行数**（来自 --stat），作为量化数据
+- **行数统计口径（防生成物噪音）**：统计增删行数前必须先剔除生成物路径（如 `.speccore/code-graph/` 下的 graph.json：单文件可能贡献数十万行，会撑爆指标）；numstat 输出为 `add\tdel\tpath` 三列，用 `grep -vE $'\t\.speccore/code-graph/'` 按制表符+路径过滤（正则匹配行首无效）；统计后若行数仍异常巨大（>5 万行），用 `sort -rn | head -8` 定位元凶文件再排除；周报指标卡（提交数/活跃天数/涉及文件/代码行数）与 HTML 热力图/柱图均用过滤后口径
+- 同主题多日提交合并为一条任务点，量化数据累加
+- git 无法给出实际耗时，用时取合理估算值，允许用户事后修正
+- 本周无提交的仓库不写入周报
+- 仓库路径（当前系统列）不存在/非 git 仓库时静默跳过该仓库（不报错、不写入）
+- 用户说「只写 xxx 的周报 / 只聚合 xxx 仓库」时只收集指定仓库
+- git 之外的默认来源：本次会话中用户已提及/口述的工作内容（任务、进度、风险等对话信息）一并聚合，与 git 记录去重合并
+- 用户明确说"只整理这段文字/只按这段"时，忽略 git 与会话上下文，只用指定文字

package/weekly-report/resources/date-parsing.md

@@ -0,0 +1,20 @@
+# 周定位解析（自然语言优先）
+
+先解析用户话术得到目标周（周一为一周起点，结束日为顶部 WEEK_END 配置的周结束日，默认周五），再收集该周提交。解析规则：
+
+| 说法示例 | 解析规则 |
+|---|---|
+| 写周报 / 生成周报（未提任何时间） | **默认本周，不追问** |
+| 本周周报 / 这周周报 / 这一周的周报 | 今天所在周 |
+| 上周周报 / 上上周周报 | 今天所在周 -1 / -2 周 |
+| N 周前的周报 | 今天所在周 -N 周 |
+| 10月第2周的周报 | 该月第 2 个周一起始的周（该月 1 日所在周计第 1 周）；缺年份默认当前年 |
+| 10月20号所在周的周报 | 该日期所在周（周一至周结束日 WEEK_END）；缺年份默认当前年，若晚于今天取去年同日 |
+| 20261020 所在周的周报 | 同上，日期直接给定 |
+| 国庆那周 / 春节那周 / 元旦那周 / 五一那周 / 端午那周 等节假日锚定 / 国庆前那周 / 春节后那周 等 | 现场推算该节日的公历日期（农历节日按农历换算，AI 实时计算）定位所在周；今年该节日已过取今年、未到取去年（最近的过去一次）；「X节前/后 N 周」= 节日所在周 ±N 周，推算结果在标题旁注明 |
+| 10月第2周到第3周的周报 / 10月20号到11月6号的周报 / 上上周到上周 | 连续多周批量生成：按周区间切片（每个周区间一份周报，周一起点、WEEK_END 结束日），两端分别按本表单点规则解析（终点缺年份沿用起点年份、终点月份早于起点月份视为下一年；终点可写「本周/上周」），按时间正序逐周生成一份周报 |
+
+- 解析出目标周周一后，周结束日 = 周一 + N 天（friday=+4、sunday=+6、saturday=+5），写入标题与 git log 的 --since/--until；落盘子目录名 = 周结束日日期
+- 批量生成流程：先一次性收集区间内所有周的提交（逐周分片 --since/--until），再按时间正序逐周生成（本周可引用下一周数据做「下周计划」，见「输出内容与数据来源」节），最后统一落盘与截图；批量时只自动打开最后一周的 html、其余仅落盘不开浏览器，避免开多个标签页；对话中按周分隔输出各周 md 正文
+- 未提及任何时间词（如"本周/上周/10月第2周"）时，一律默认本周直接生成，不追问用户
+- 解析结果有歧义时以最近过去的周为默认，并在标题中注明解析出的周范围

package/weekly-report/resources/disk-and-html.md

@@ -0,0 +1,14 @@
+# 本地落盘（默认行为）
+
+- 落盘根目录读取顶部「默认配置」的 `DIR`（默认 `auto`：按当前系统自动选 `DIR_MAC` / `DIR_WIN`），按当周最后一天（WEEK_END 对应的日期，默认周五）建子目录（macOS：`<DIR>/YYYY-MM-DD/`；Windows：`<DIR>\YYYY-MM-DD\`，目录不存在则自动创建）；改配置节里的 DIR / DIR_MAC / DIR_WIN 即可改变全局默认位置，改 WEEK_END 即可改变目录锚点日期
+- 换机器/目录不存在回退：落盘前检测 DIR 是否存在（macOS：`test -d <DIR>`；Windows：PowerShell `Test-Path '<DIR>'` 或 node `fs.existsSync`），目录/盘符不存在时默认根目录自动改用用户主目录下 reports（macOS=`~/reports`、Windows=`%USERPROFILE%\reports`，不存在则自动创建），保证任何机器都能落盘
+- 使用时用户临时指明位置（如"写到桌面"、"存到 ~/report（macOS）/ D:\report（Windows）"，覆盖 DIR、仅当次生效）：以用户指定位置为根目录，同样按当周最后一天日期子目录；"桌面"映射：macOS=`~/Desktop`、Windows=`%USERPROFILE%\Desktop`；目录不存在自动创建
+- 每次生成落盘哪些文件读取顶部「默认配置」的 `FORMATS`（默认 md/txt/html/content-png 四个，md/txt/html 文件名 `weekly-report-YYYYMMDD~YYYYMMDD.<格式>`、截图文件名 `weekly-report-YYYYMMDD~YYYYMMDD-content.png`；txt 为纯文本版）；`DISK: false` 时全部不落盘
+- 对话中照常输出 md 正文（不受 FORMATS 影响）；`OPEN_HTML: true` 且本次落盘了 html 时，自动打开浏览器（macOS：`open <html文件>`；Windows PowerShell：`Start-Process <html文件>`）
+- FORMATS 含 content-png 时额外生成内容区截图 `weekly-report-YYYYMMDD~YYYYMMDD-content.png`：整页内容区截图一张（头部标题卡片 + 本周概览卡片与本周完成任务/下周计划/风险阻塞点分节卡片整体截出，头部卡片必须带上，图片四周保留对称合适的外边距约 40px 留白）：html 内置 `?shot=content` 参数（页面 JS 检测后仅统一 body 四周 padding 40px、不隐藏任何元素（头部标题卡/概览卡/三张分节卡/页脚全部保留），正常浏览不受影响）；用 Chrome headless 访问带参 URL 截图（路径按系统选：macOS=`/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`；Windows 按序探测 `C:\Program Files\Google\Chrome\Application\chrome.exe` → `C:\Program Files (x86)\Google\Chrome\Application\chrome.exe` → `%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`，经 node child_process 执行 `--headless --disable-gpu --no-sandbox --hide-scrollbars --user-data-dir=<临时目录> --screenshot=<png路径> --window-size=760,<估算高度> --virtual-time-budget=4000 "file:///<html路径>?shot=content"`（Windows 下 URL 写作 file:///C:/...，用 node url.pathToFileURL 生成），跑完删除临时目录；禁止用 `--headless=new`（单例模式会静默失败生成占位图）；若 Chrome 不存在则换 Edge（macOS=`/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge`；Windows=`C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe` → `C:\Program Files\Microsoft\Edge\Application\msedge.exe`），都找不到时跳过截图并在对话注明）；高度按整页内容区估算（body 上下留白~80 + 头部标题卡片~180 + 概览卡片~120 + 每节卡片(45+条目数×70+40，含各卡片 margin-bottom 18) + 余量~15，底部留白仅 body 下 padding 40px、与顶部对称，余量只防截断不可多给），截图后用 Read 校验：头部标题卡片、概览卡片与三张分节卡片整体完整在图内、四周留白对称合适、不截断，底部留白过大则减高度、截断则加高度重截
+- md/txt/html 均含生成时间行，精确到时分秒（如 2026-10-22 19:10:38）；HTML 采用参考图式深蓝面板风格 + ask 同款发光动效的融合样式（不换其它色系，颜色全部用 CSS 变量统一 ask 色板：--cyan #0ea5e9、--bg #0a1929、--card #0b1e37、--border rgba(14,165,233,.15)、--text #bae6fd、--muted #5b7fa5、--green #14b8a6、--orange #f97316、--purple #6366f1、--rose #f43f5e）：禁用任何 CDN 与外部网络引用（@import、外链 CSS/JS/图片/网络字体一律禁止，页面必须公司内网离线双击可打开、零外部依赖），字体全用系统本地字体栈 ui-monospace/'SF Mono'/SFMono-Regular/Menlo/Consolas/'Microsoft YaHei'/monospace（macOS 走 SF Mono/Menlo、Windows 走 Consolas，中文回退 Microsoft YaHei；字母数字等宽自带科技感），正文同栈 400、标题同栈 900 渐变文字（var(--cyan) #0ea5e9→var(--purple) #6366f1，background-clip:text，发光用 ask-result 模板同款 text-shadow 双圈（titleGlow 动画 3s 呼吸：基线 20px/.4 + 60px/.15 ↔ 峰值 30px/.7 + 80px/.3，h1 留静态基线；24px 小字同参数观感与官方一致，禁止改三圈小模糊——会糊在字内边界不清））；页面背景纯深蓝黑 #0a1929（参考图同款色值）、正文浅青 #bae6fd、全屏极轻微噪点纹理（body::before fixed 覆盖层，background-image 用 SVG feTurbulence data URI（<svg xmlns='http://www.w3.org/2000/svg' width='240' height='240'><filter id='n'><feTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='2' stitchTiles='stitch'/><feColorMatrix type='saturate' values='0'/></filter><rect width='100%' height='100%' filter='url(#n)'/></svg>），opacity .04，pointer-events:none，z-index 0 在卡片之下，消除大面积纯色死板感），body 纯 #0a1929 背景不加径向辉光（onboarding 同款）；全屏背景叠加 speccore dashboard 同款三层科技感底纹：60px 网格底纹（.grid-pattern fixed inset 0，background-image linear-gradient(rgba(0,240,255,.03) 1px, transparent 1px) 纵横双向、background-size 60px 60px、z-index 0）+ 彩色星点层（.stars fixed inset 0，8 个 1-1.5px 星点 radial-gradient(1px 1px at <位置>, <色>, transparent) 多背景组合：白色 rgba(255,255,255,.3-.4) 与青色 rgba(0,240,255,.45-.5)、紫色 rgba(168,85,247,.4)、绿色 rgba(0,255,136,.4)，位置分散 10%-90%，z-index 0）+ 全屏 2px 周期细扫描线（.scanlines fixed inset 0，repeating-linear-gradient(0deg, transparent 0 2px, rgba(0,240,255,.015) 2px 4px)，z-index 999 罩最上层，pointer-events none；三层均 fixed 不随滚动，营造星野+网格+扫描的科技氛围，不破坏参考图纯深蓝黑质感）；内容区宽度响应窗口自适应（.wrap width:clamp(640px, 60%, 1200px) + margin:0 auto：最小 640px、最大 1200px、中间按窗口 60% 缩放，页面左右留白对称）；头部卡片参考图式实心深蓝底（var(--card) 实心 #0b1e37，略亮于背景、更偏蓝）+ 8px 周期细密水平条纹（background-image 叠加 repeating-linear-gradient(180deg, rgba(255,255,255,.012) 0 1px, transparent 1px 8px)）+ 上下边缘 1px 微亮描边（border-top/border-bottom 1px solid #0f3350，参考图「边缘点亮一线」效果，与 ask 四边浮光扫描线动画共存、动画层在上）+ 圆角 6px + 外发光与 inset 内发光（0 0 20px rgba(14,165,233,.08) + inset 0 1px 24px rgba(14,165,233,.04)），overflow:hidden，标题区仅标题与青色胶囊生成时间徽章（badge 后直接收尾，不加底部细线/装饰光带，避免悬空多余线）；标题与徽章下加 TL;DR 一句话摘要行（.summary-line flex 布局 max-width 540px 居中：左侧 .summary-tag「TL;DR」青色小标签 系统等宽 10px 粗体、rgba(14,165,233,.35) 细边圆角 4px、rgba(14,165,233,.07) 底、青色 text-shadow 光晕 + 右侧 .summary-text 12.5px 浅青正文 line-height 1.75 text-align left；摘要带判断给结论——整体节奏/主要风险/下周重点，不罗列条目）；「本周概览」摘要卡片 Bento 网格布局（参考图式质感：实心深蓝底 #0b1e37 + 8px 周期细密水平条纹 + 上下边缘 1px 微亮描边 + 左缘 8px 亮蓝色条 linear-gradient(180deg,#38bdf8,#0ea5e9) 带同色光晕 + 圆角 6px + overflow:hidden + 内放 .card-glow 光斑层；.ov-bento display:grid、grid-template-columns:104px 1fr 1fr、grid-template-rows:auto auto auto、gap:10px）：完成率圆环大卡（.ring-box 跨 col1 row1/4 整列贯穿、内放青色渐变描边完成率圆环 + 中央大数字 + .ring-label「N/N 项已交付」小字）+ 提交热力图卡（.heat-card 跨 col2/4 row1：标题行「提交热力图」+ .heat-grid 5天×3时段（上午/下午/晚上）15 格 GitHub 式色阶 .hm[data-v="0"~"3"] 四档（0 rgba(14,165,233,.07) 底 / 1 rgba(14,165,233,.3) / 2 rgba(14,165,233,.55) / 3 rgba(34,211,238,.8) 带 glow）+ .heat-days 底部周几标签（padding-left:26px 补偿时段标签列）+ .htip hover 浮层（深蓝底青边圆角 tooltip 显示「周X上/下/晚 · N 次」）；热力图格子 JS 入场错峰 animationDelay .55+i*.04s）+ 四个 .ov-item 指标胶囊（自动流排入剩余格：提交数 data-count、活跃天数 data-count、涉及文件 data-count、代码行数 .ov-num-static 双行（主数字 +18.4k + small 行 −12.7k 删行 --rose 玫红），每个 .ov-item 胶囊细边单元格 rgba(14,165,233,.12) 1px 边 + rgba(14,165,233,.03) 底，.ov-num 系统等宽 24px 青色发光数字 + .ov-label 11px 青灰标签）+ 底部 .ov-compare 环比行（11.5px 青灰小字居中「vs 上周：提交 14 → 18（+29%）· 完成任务 3 → 5（+67%）」，上涨用 --green 绿、下跌用 --rose 红；环比数据来自上周同范围 git log 与完成条目统计）+ 提交节奏柱图（.cb-col 5 根柱周一到周五、.cb-bar width:32px 柱宽（太小显细弱）、柱高按提交数、position:relative 柱上带 .cb-tip hover 浮层显示「周X · N 次提交 · 主题词」）+ 分节卡片同参考图式质感（实心深蓝底 #0b1e37 + 8px 周期细密水平条纹 + 上下边缘 1px 微亮描边 #0f3350 + 圆角缩小至 6px + overflow:hidden，保留阴影与 inset 内发光，去掉原全框青色细边），每张分节卡片左侧带参考图式左缘色条（8px 宽竖线贯穿整卡高度，节色渐变带同色光晕：完成 linear-gradient(180deg,#5eead4,#14b8a6) / 计划 linear-gradient(180deg,#fdba74,#f97316) / 风险 linear-gradient(180deg,#fda4af,#e11d48)，box-shadow 0 0 12px 同色 30% 透明度；卡片内容 padding-left 24px 避让色条），节标题带 18px 同色渐变 SVG 语义图标+文字微光晕（h2 flex 布局 gap 10px，图标替换原竖向短条：完成=圆形对勾、计划=日历、风险=三角警示；inline SVG 内 linearGradient 同节色系渐变 完成 #5eead4→#14b8a6 / 计划 #fdba74→#f97316 / 风险 #fda4af→#e11d48 + 白色描边细节 + drop-shadow 同色光晕；标题色：完成青绿 #5eead4、计划橙 #fdba74、风险玫红 #fda4af + h2 文字同色双圈发光字 3s 呼吸 secGlow 动画（基线 14px/.45+40px/.18 ↔ 峰值 22px/.75+60px/.3，各节动画用本节主题色，与主标题同节奏；仅节标题文字发光，SVG 图标与日期徽章不加））+ 「本周完成任务」节标题右侧带周范围小胶囊徽章 sec-date（margin-left:auto 推右、flex:0 0 auto；11px var(--muted) 字、padding 3px 10px、圆角 999px、青色细边 rgba(14,165,233,.18)、背景 rgba(14,165,233,.05)，如 2026-10-19 ~ 2026-10-25；徽章周范围与周报标题/目录名/git 收集范围完全同源、同步跟随 WEEK_END 配置（含临时说「这周按周日收尾」）；仅完成节显示、计划/风险节不加，让截图自带具体周范围）+ 条目 3D 立体圆球序号徽章（28px 白字，立体感克制的柔和球面——弱化版三段收窄色阶：受光球面渐变 radial-gradient（受光点 circle at 30% 28%，浅亮→主色→深色：完成 #7dd9cf→#14b8a6→#0d9488、计划 #fdc69a→#f97316→#ea580c、风险 #fdaab4→#f43f5e→#e11d48）+ inset 右下内暗影 -3px -4px 6px rgba(0,0,0,.3) 与左上内亮缘 1px 2px 3px rgba(255,255,255,.2) + ::before 左上椭圆高光点（position:relative 定位，top 5px/left 7px、8x6px、rotate -28deg、白色径向渐隐 rgba(255,255,255,.7)→0）+ 底部投影 0 2px 4px rgba(0,0,0,.25) 与同色光晕 0 0 8px + 数字 text-shadow 0 1px 1px rgba(0,0,0,.25) 贴球面） + 条目内部留白：li 水平 padding 10px（hover 淡青底 rgba(14,165,233,.06) 与文字间留 10px 间距）+ 序号圆形徽章 28px（数字距圆边约 8px，不贴圆边）+ 列表轻微缩进 12px（ol/ul padding 0 12px）+ 描述与进度双层错落排版（描述 15px、进度用时 12px 青灰小字 #5b7fa5、百分比加粗强调且两侧 margin 0 2px 呼吸留白、进度与用时之间用「 - 」连接（与 md/txt 版一致，不用 · ）、条目间青色虚线分隔）；风险节条目三环展开：desc 主行（问题）+ meta 影响行（12px 青灰小字「影响：xxx」）+ .advice 建议行（12px 青色小字，「建议：」加粗前缀，margin-top 6px）；md/txt 版同条目依次写问题、影响、建议，文本格式不变+ 青色渐变 40px 大胶囊「一键复制」按钮（var(--cyan)→#0284c7，30px 青色光晕，hover 45px 光晕上浮，模板同款；flex 居中布局，内置 16px 内联 SVG 双矩形复制图标（白色 currentColor 描边、图标与文字 gap 8px、禁用 emoji 图标），复制成功后图标切换为对勾 SVG、文字短暂变「已复制」）；头部 speccore ask 风格发光特效（与 ask 页面完全同款）：四边 1px 青色浮光线，渐变 transparent→var(--cyan)→transparent 整条线平移扫动（亮段长、无 box-shadow 光晕，四边亮段构成顺时针环绕循环，与 ask 看板卡片完全同款（上横线 scanX 左→右、右竖线 scanY 上→下、下横线 scanX-rev 右→左、左竖线 scanY-rev 下→上，四线同周期同速度 3s linear 单向平移）；实现为 1px 整线渐变元素平铺整条边（上/下横线 left:0/right:0 + height:1px + linear-gradient(90deg, transparent, var(--cyan), transparent)；左/右竖线 top:0/bottom:0 + width:1px + linear-gradient(180deg, transparent, var(--cyan), transparent)），随线体 translateX/translateY 平移 ±100%（相对线长）：scanX -100%→100%、scanX-rev 100%→-100%、scanY -100%→100%、scanY-rev 100%→-100%；亮段（线中央渐变段）完整穿越卡片后消失于两端界外（卡片 overflow:hidden 裁剪），带「出现→穿越→消失」节奏；禁止自创 background-position 滚动/常驻辉光/往返摆动/亮段半嵌常驻等变体）+ 顶部光斑 ask 同款 cardGlow（radial-gradient ellipse at 50% 10% rgba(14,165,233,.25)→transparent 70%，opacity .5→1 + scale 1→1.6，transform-origin top center，3s 循环；头部卡片与每张分节卡片内均放 .card-glow 光斑层，覆盖整卡顶部）+ 标题文字青色光晕呼吸（text-shadow 双圈 3s 循环）；入场动画：头部淡入下滑、卡片依次错峰上浮淡入（完成 0.26s/计划 0.4s/风险 0.54s）、按钮弹入（卡片入场动画 fadeDown/fadeUp/riseIn 的 fill-mode 必须用 backwards 严禁 both——both 使动画结束后最后一帧 transform:none 永久覆盖 hover 的 3D 偏转 transform，CSS 动画 applied 值优先级高于普通声明，hover 偏转会完全失效；cometFade 与按钮 pop 保持 both 不受此限）；hover 微交互：卡片上浮+阴影加深+inset 发光增强、条目淡青底、序号徽章放大微旋、按钮上浮/按压回缩；页脚 10px muted 文字（无分隔线、不加边框），署名固定 GENERATED BY SPECCORE TEAM · <周范围>（动态跟随 WEEK_END，如 GENERATED BY SPECCORE TEAM · 20261019 ~ 20261025）；三段分节列表，任务点保持中文顿号序号；进度条终点圆点 + 流星扫描填充（.pbar-fill 必须 display:block + position:relative——行内 span 忽略 width/height 会变成 0×0，填充与圆点全部不可见；.pbar-fill::before 终点圆点 7px 径向渐变圆 right:0 + transform:translate(50%,-50%) 骑在填充右缘（done 青绿 radial-gradient(circle at 35% 30%,#a7f3d0,#2dd4bf 62%,#0d9488)、plan 橙 #fdba74/#f97316/#c2410c，box-shadow 同色光晕、z-index:2；.pbar-track/.pbar-fill 均不得加 overflow:hidden——圆点右半伸出填充 3.5px 骑边渲染）；流星 = JS 注入 .pbar-track 内的 .pbar-sweep（absolute 左贴轨道、width:0 起点隐藏、height:16px、transform:translateY(-50%) 垂直居中、z-index:1、pointer-events:none）+ sweep 右缘 .pbar-comet 光体（absolute left:100% 贴 sweep 右缘随宽度移动，严禁 right:62%/right:100% 等右侧定位——彗星会停在轨道中段、进度 100% 时也到不了终点；子弹头形光核：20×11px 横向泪滴 border-radius:55% 100% 100% 55% / 85% 100% 100% 85%（右端全圆弧=前进弹头、左端 55%/85% 大圆角=后部饱满钝圆接尾不露尖（比 35%/60% 更钝，禁尖窄收尾），严禁 13×7 小椭圆方块感、严禁 20px 大圆球形态）background 三层：底层 linear-gradient(90deg,rgba(153,246,228,.3),rgba(224,254,255,.6) 55%,#fff) 铺底（形状内不得透底）+ 右前缘青蓝冷光 radial-gradient(ellipse 70% 85% at 74% 45%,rgba(125,211,252,.9),transparent) + 青白核 radial-gradient(circle 12px at 66% 50%,#fff,rgba(224,254,255,.95) 45%,rgba(153,246,228,.5) 75%,transparent)（circle 半径必须显式 12px——自动半径按最远角计、四角渐隐至透明会露出轨道深色背景成「黑三角」，显式半径让光核饱满），box-shadow 双圈柔光 0 0 5px 2px rgba(186,230,253,.75) + 0 0 12px 4px rgba(45,212,191,.3)——光晕总高控制在 2~2.5 倍条高以内，不用 drop-shadow；整体前大后收窄的扫帚流星：头部 20×11 大头 → ::after 彗尾 right:40%、84×12px 细长锥形拖尾 linear-gradient(90deg,transparent,rgba(153,246,228,.18) 26%,rgba(186,230,253,.55) 64%,rgba(255,255,255,.9)) + clip-path:polygon(4% 40%,16% 24%,100% 0,100% 100%,16% 76%,4% 60%)（左端收成 2.4px 高平口钝头、右端全高平接光核、16% 处起渐收——远窄近宽，禁矩形方块形、禁 1px 尖点）+ blur 1px + z-index:0——长度约 4 倍头宽；剥落粒子流（JS 为每颗 .pbar-comet 注入 12 个 span.cp，绝对定位在光核中后段出生）：12 粒椭圆小块前大后小（3.2×2.2 → 1.2×0.9px，宽高不等 + rotate -12°~12° 不规则椭圆，禁用标准圆形、禁用 box-shadow 静态星屑——静态点没有剥落飘散的生命感），出生点从头部稍靠后（left 9~17px）开始，y 紧贴中心水平线（中线 ±2.5px，各粒角度基本一致不散乱），cpFlow 1.5~1.8s cubic-bezier(.2,.05,.55,1) infinite + 负延迟 -0.1~-1.5s 错峰：0%→10% 淡入渐现（渐渐出现）、10%→100% 沿水平线加速向后飘 translate3d(-45~-62px, dy, 0)（加速向后）、55% 后 opacity 渐隐 + scale(.16) 渐小（向尾部消失）、dy 取与出生 y 反向小值让飞行终点向中心水平线收敛，box-shadow 光晕 0%→55% 增强再减弱（每粒生命期一次明灭=呼吸发光，周期 1.5~1.8s 与主体 2.4s 呼吸非整数倍错开，禁止同频齐步闪）；粒子 z-index:1 在彗尾之上（尾 z-index:0）、opacity:0 起步呼吸发光分层不同频：主体光核与彗尾 2.4s 周期呼吸（comet 双动画 cometFade + glowPulse 2.4s ease-in-out infinite：box-shadow 双圈光晕 0%↔50% 周期扩缩；::after 挂 tailGlow 2.4s ease-in-out infinite：filter blur(1px) brightness(1) ↔ blur(1.5px) brightness(1.28) 亮度呼吸），粒子 1.5~1.8s 明灭与主体 2.4s 呼吸非整数倍错开（视觉错落不同频）；opacity:0 常驻隐藏）；.pbar-track.sheen-on 时 sweep transition:width 1.1s cubic-bezier(.3,.8,.4,1) 生长（comet 贴 sweep 右缘 left:100% 随宽度从左扫到右），comet 的 animation 严禁写在 .pbar-comet 基类（基类动画页面加载 t=0 即播、1.1s 后 both 定格 opacity:0，而扫动 setTimeout 1.5s 才开始——时序错位会让流星全程不可见）；必须挂在 .pbar-track.sheen-on .pbar-comet 选择器上（cometFade 1.1s ease-out both, glowPulse 2.4s ease-in-out infinite 逗号并列双动画：cometFade 7% 淡入、86% 保持、100% 到终点消失、glowPulse 光晕呼吸循环；::after 彗尾另挂 tailGlow 2.4s ease-in-out infinite 亮度呼吸），靠 playSweep 内 remove/add sheen-on 类切换重启动画，与 dotPulse 同机制；扫动终点按各条目标进度 data-w：sheen 内 sweep inline width 终点 = data-w（done 条 100% 扫满轨道、有进度的 plan 条如 30% 即 30% 停在进度点不越界）——sweep 宽度过渡与 fill 宽度过渡同参数天然同步，comet 与彗尾/星屑无需任何反向补偿（scaleX 压缩方案会把彗尾一同拉长数倍，禁用）；填充同步生长：入场 sheen(el,'wave') 给 fill 设 transition width 1.1s 同 easing + width 0→data-w，与流星同步——流星扫到哪、填充长到哪，流星到终点消失、留下各自进度，之后填充保持不再变化；圆点 .pbar-done/.pbar-plan .pbar-track.sheen-on .pbar-fill::before animation:dotPulse 1.1s（90% 处 filter:brightness(2) + 白光 drop-shadow 爆亮，done/plan 通用）流星到达终点时爆亮——dotPulse 选择器必须与 JS 加类位置一致：JS 把 sheen-on 加在 .pbar-track 上，严禁写 .pbar-fill.sheen-on::before（JS 从不在 fill 上加类，选择器永不命中、爆亮不触发）；流星注入与入场波浪覆盖完成条 + 有进度的计划条（JS 遍历 .pbar-track：plan 且进度<=0 的条 return 跳过——0 进度的计划条不注入流星、不扫、保持静态），其余条 data-w 记录目标进度后 fill 归零；入场波浪：setTimeout 1500+i*420ms 逐条 sheen(el,'wave') 错峰（上→下必然可见）；hover 重扫：li 上 mouseenter+pointerenter 双监听，sheen(el,'hover') 只 remove/add fill 与 track 的 sheen-on 类重放流星扫过（comet 再扫一遍，0 进度的 plan 条同样跳过），fill 宽度与颜色完全不重置（进度不再变化），sheen(el,src) 按来源独立节流（wave 1s / hover 300ms）；重启动画 remove 类→sweep inline 归零 width:0（transition:none 无过渡）→void offsetWidth 强制回流→同步 add 类→sweep inline 目标 width=data-w（恢复 transition；双 RAF 在 headless 虚拟时间下不推进，不可用））；液态玻璃（@supports((backdrop-filter:blur(1px)) or (-webkit-backdrop-filter:blur(1px))) 内 .overview/.section 加 backdrop-filter:blur(16px) saturate(1.35) + background-color:rgba(11,30,55,.42)，不支持的老浏览器走默认实心深蓝不白屏）；CRT 扫描光带（.scanband position:fixed、left:0/right:0、height:150px、linear-gradient(180deg,transparent,rgba(0,240,255,.03) 50%,transparent)、animation:scanMove 11s linear infinite（top -22%→112%）、pointer-events:none、z-index:998，置于 scanlines 之下一层）；卡片级 3D 微倾斜（严禁全页级 mousemove 倾斜——页面容器整页旋转会让所有卡片一起偏转，与「仅当前卡片响应」不符）：每张卡片 hover 时仅该卡片随鼠标偏转，卡片 transform 写 perspective(900px) + rotateY(calc(var(--mx,0)*2.5deg)) rotateX(calc(var(--my,0)*-2.5deg))（±1.25° 极轻微），与 hover 上浮 translateY(-2px) 合并写同一条 transform（严禁拆两条相互覆盖）；hover 态选择器带 tilt（header-card/overview/section 或 header-card/card），非 hover 卡片不倾斜；JS 对每张卡片监听 mousemove 计算卡内相对位置（(clientX-rect.left)/rect.width*2-1 归一化 -1~1）只更新该卡 --mx/--my，mouseleave 归零回正，transition transform .18s 平滑；移动端无 mousemove 保持 0 不倾斜）；禁止写 @media (prefers-reduced-motion: reduce) 禁用动画的媒体查询块（官方模板无此块，用户系统开启减少动画时该块会禁用全部动效，是竖线不动/发光不呼吸的根因）；页面 JS 需支持 `?shot=content` 参数（检测 location.search 含 shot=content 时仅统一 body 四周 padding 40px（不隐藏任何元素），供整页内容区截图用、保证截图四周留白对称合适）
+- HTML 顶部带「一键复制」按钮：点击复制的是 txt 版纯文本全文（复制源必须用 txt 文件内容：含换行、无 #/##/> 等 Markdown 符号，严禁用 md 内容当复制源），按钮短暂变"已复制"；JS 用 navigator.clipboard.writeText，失败回退隐藏 textarea + document.execCommand('copy')（兼容 file:// 打开）
+- 用户临时说"不落盘/别写文件"时（覆盖 DISK）：只在对话输出，不写文件、不开浏览器；临时说"写到桌面/存到 X"（覆盖 DIR）、"只要 md/只出 html/只要内容区截图/只要截图/这次不截图"（覆盖 FORMATS）、"别开浏览器"（覆盖 OPEN_HTML）同理，均只对当次生效、不改配置
+- 同名目录处理：周日期子目录已存在时直接复用（不重建、不清空），仅覆盖 FORMATS 清单内的同名文件（md/txt/html/content-png），目录内其它文件（时间戳另存的历史文件、用户自放文件）一律保留不动、绝不删除或清空（该目录可能是用户此前自建、作其它用途的目录，我们只并列写入自己的专属命名文件，不与用户文件冲突混淆）；落盘前查看目录内已有内容，若存在非本 skill 命名的其它文件（daily-report-/weekly-report- 前缀之外），对话中提示用户「该目录内已有其它文件，本次周报已与它们并列存放，未做任何改动」；同一周重复生成默认直接覆盖原文件，用户说"保留之前的/另存/不覆盖"时，文件名追加时间戳（如 `weekly-report-20261019~20261025-1530.html`）另存不覆盖
+- 落盘完成后，对话回复必须向用户报告落盘位置：列出实际写入的目录完整路径与文件清单（如「已落盘到 /Users/.../reports/2026-10-23/：weekly-report-20261019~20261025.md、.txt、.html、-content.png」），并注明 html 是否已在浏览器打开、截图是否跳过（Chrome/Edge 都不存在时）；DISK=false 或未落盘时注明「本次仅对话输出，未落盘」
+- 落盘文件清单以顶部 FORMATS 为准；显式格式参数（如 `/weekly-report 20261020 md`）只影响对话输出形态，不影响落盘清单

package/weekly-report/resources/industry-dictionary.md

@@ -0,0 +1,19 @@
+# 行业适配（职业词典）
+
+报告骨架（三段式/TL;DR/概览卡/热力图/柱图/风险建议环）行业无关，只有「行业变量」随职业切换。用户对话中声明职业即按词典取词（如「帮我写份销售周报」→ 销售词条）；词典没有的行业走兜底。
+
+| 变量 | 研发 | 销售 | 运营 | 产品 | HR | 财务 | 市场 | 客服 | 项目/PMO | 行政 | 法务 | 设计 |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| 标题 | 研发周报 | 销售周报 | 运营周报 | 产品周报 | 人事周报 | 财务周报 | 市场周报 | 客服周报 | 项目周报 | 行政周报 | 法务周报 | 设计周报 |
+| 工作单元 | 提交/版本/PR | 拜访/商机/回款 | 活动/渠道/内容 | 需求/迭代/上线 | 招聘/培训/入离职 | 报表/对账/税务 | 投放/活动/线索 | 工单/会话/满意度 | 里程碑/需求变更/资源/评审 | 会务/采购/资产/证照 | 合同审核/诉讼/合规/知产 | UI稿/设计规范/走查/交付 |
+| 概览指标 | 提交数·活跃天数·文件数·行数 | 拜访数·商机数·签约额·回款额 | 曝光·转化·GMV·活动数 | 交付数·上线数·需求数 | 简历数·到面率·入职数 | 凭证数·回款额·预算执行率 | 投放额·线索数·ROI | 工单量·解决率·满意度 | 里程碑达成数·任务完成数·变更数 | 会务场次·采购完成数·资产盘点数 | 合同审核数·案件进展·合规项数 | 页面稿数·规范组件数·走查问题数 |
+| 热力图/图表 | 提交热力图+节奏柱图 | 拜访节奏+商机漏斗 | 转化漏斗+渠道占比 | 迭代燃尽图 | 招聘漏斗 | 预算执行仪表 | 投放趋势 | 工单趋势 | 里程碑甘特图 | 会务日历/采购进度 | 合同审核节奏/案件清单 | 设计交付节奏 |
+| 风险话术 | 阻塞点/技术债 | 竞争/预算审批 | 资源/渠道效果 | 需求变更/排期 | 用人缺口 | 资金/合规 | 渠道成本 | 舆情/高峰 | 范围蔓延/资源冲突 | 供应商延期/预算超支 | 合规风险/诉讼时效 | 需求反复/排期挤压 |
+
+- 用户角色画像：顶部「默认配置」的 ROLE 定义用户默认角色与主要工作内容（当前：程序员，企业内技术开发，负责前端、后端方向）；未提职业时按 ROLE 画像取词（当前等价研发词条：git 提交聚合 + 提交/版本术语 + 提交数/活跃天数/文件数/行数指标 + 提交热力图/节奏柱图）
+- 触发：话术含职业词（销售/运营/产品/HR/财务/市场/客服/项目/PMO/行政/法务/设计等）→ 标题、工作单元术语、概览指标、热力图/图表主题、风险话术全部按该词典词条生成
+- 临时换角色：说「以 XX 的身份写周报」（如「以销售经理的身份写」）→ 当次按该角色词条生成，不改配置
+- 永久换角色：说「以后默认用 XX 角色 / 我的职业是 XX / 我的主要工作是 XX」→ 更新顶部 ROLE 配置（永久生效）；词典没有的角色按用户描述新增词条
+- 声明+临时指标覆盖：说「这次指标看拜访数和签约额」→ 词条 + 临时指标（仅当次）；说「以后都用这套指标」→ 固化进词典（永久）
+- 兜底：词典外的行业（工地施工、医生值班等）→ 骨架 + 用户素材（文字/图片/文件）现场生成词条（工作单元/指标从素材提取），本次生效；说「记住这个行业」→ 固化为新词条
+- 行业/角色切换只换内容与指标，HTML 骨架/色板/动效/落盘规范全部不变；纯文字整理模式同样适用词典；无 git 数据时概览卡只显示完成任务/计划/风险条数统计；优先级：临时角色声明 > 顶部 ROLE 配置 > 词典表

package/weekly-report/resources/usage-guide.md

@@ -0,0 +1,68 @@
+# 📖 使用说明（详细条目版，用户可读）
+
+## 基本用法
+- 直接说「写周报」「生成周报」→ 默认生成本周（周一 ~ 周结束日，顶部 WEEK_END 默认周五）的周报，无需指定时间
+- 指定周（多种说法均可）：
+  - 「本周周报」→ 今天所在周；「上周周报」「上上周周报」→ 往前推 1 / 2 周
+  - 「10月第2周的周报」→ 该月第 2 个周一起始的周（该月 1 日所在周计第 1 周）
+  - 「10月20号所在周的周报」→ 该日期所在周（缺年份默认当年，晚于今天取去年同日）
+  - 「20261020 所在周的周报」→ 直接按数字日期定位所在周
+  - 「国庆那周」「春节那周」「春节前那周」→ 节假日锚定，AI 现场推算节日公历日期（农历节日按农历换算）定位所在周
+  - 「10月第2周到第3周的周报」「10月20号到11月6号的周报」「上上周到上周」→ 连续多周批量生成，每周一份（本周下周计划自动从下一周完成任务抽取）
+- 同一周重复生成会直接覆盖原文件；说「保留之前的」→ 文件名追加时间戳另存不覆盖
+- 说「日报和周报都要」→ 日报、周报按各自流程分别生成，同日数据自动去重
+- 说「打开/查看本周周报」→ 该报告文件已存在时直接打开不重新生成；不存在则按正常流程生成
+- 说「只算我的提交」→ 只聚合本人提交（git log 加 --author=<用户名>）；默认仓库内全部提交都计入
+- 说「只写 xxx 的周报 / 只聚合 xxx 仓库」→ 只收集指定仓库的提交，跳过其它仓库
+- 落盘子目录用当周最后一天（WEEK_END）的日期命名；改顶部 WEEK_END（friday/sunday 等）可改变周结束日；临时说「这周按周日收尾/这周算到周日」→ 当次按周日算（仅当次生效）
+
+## 口头追加任务
+- 说「补充一下：这周处理了两天的支付问题」→ 自动按语义拆成多条任务，润色为规范格式并入「本周完成任务」
+- 拆分信号：时间词（周几/上几天）、连接词（还有/另外/以及）、分号顿号列举、数字列举
+- 补充内容带分段词时按段并入：「下周计划：xxx」→ 下周计划段；「风险：xxx」→ 风险阻塞点段（说「风险暂无/无风险」→ 风险段写「暂无」）；不带分段词默认并入「本周完成任务」
+- 与 git 提交聚合出的任务自动去重，同一件事只保留一条
+
+## 贴文字 / 发图片 / 给文件整理周报（无 git 提交也适用）
+- 直接贴一段文字说「整理成周报 / 把这段文字整理成周报」→ 以文字为主源生成，不依赖 git 提交（非开发岗位也可用）；说「只整理这段文字 / 只按这段 / 不用 git」同样跳过 git 与会话上下文
+- 发图片（截图/照片等 jpg/png/webp）或给文件（md/txt/docx/pdf 等）说「整理成周报」→ 先用 Read 读取：图片按视觉理解提取图中文字信息，md/txt 直接读文本，docx/pdf 优先尝试 pandoc 转文本（无 pandoc 则请用户粘贴文字），再按纯文字模式整理
+- 图片模糊/内容读不清时：先把已提取的部分展示给用户确认或补充，不瞎编没读到的内容
+- 自动分段归类：文字里写「下周/接下来/计划…」→ 下周计划；「风险/阻塞/问题/卡住…」→ 风险阻塞点；其余 → 本周完成任务（用户已明确分段则按用户分段）
+- 自动拆条润色：按主题拆成一条条（周报粒度 30-60 字/点），口语整理为动词开头的规范描述
+- 量化与用时：没有代码提交就没有文件数/行数；进度没写默认完成 100%、计划 0%；用时没提就不写，不瞎编
+- 默认直接生成落盘（CONFIRM: never，无需确认）；把顶部 CONFIRM 改为 text/always，或临时说「先看看效果/先出效果」→ 先在对话输出整理好的报告正文，用户说「可以/确认/落盘」→ 再落盘文件与内容区截图并开 html；说「改一下 xxx」→ 按意见修改后重新出效果再确认
+- 说「不用确认/直接落盘」→ 当次跳过确认直接落盘（临时要求优先于配置）
+- 说「不落盘/别写文件」时跳过确认，直接对话输出
+
+## 自定义模板（适配各类岗位）
+- 内置模板为三段式（本周完成任务/下周计划/风险阻塞点），适合开发岗位；其他岗位可自定义模板
+- 临时换模板：说「这次按 xxx 来」→ 口头描述结构（如"按四段：工作内容/存在问题/下周计划/需要支持"），当次按该结构生成，不改配置
+- 永久换模板：把顶部配置 TEMPLATE 改为 custom，并按 SKILL.md 的「📝 自定义模板」节说明修改段结构，之后默认按新模板生成
+- 说「以后都用这个模板」→ 自动把当前口述的结构写入「📝 自定义模板」节并把 TEMPLATE 改为 custom
+- 模板优先于纯文字模式的信号词归类：指定了段名后，文字按段名归类填充
+
+## 角色定制（我的职业画像）
+- 默认按顶部「默认配置」ROLE 生成（当前：程序员，企业内技术开发，负责前端、后端方向）；说「我的职业是 XX / 我的主要工作是 XX / 以后默认用 XX 角色」→ 永久修改 ROLE
+- 说「以 XX 的身份写周报」→ 当次按该角色生成（内置 12 行业词条：研发/销售/运营/产品/HR/财务/市场/客服/项目/行政/法务/设计可直接用），不改配置
+- 词典外行业走兜底：按骨架 + 你提供的素材现场生成词条；说「记住这个行业」→ 固化为新词条
+
+## 控制落盘（临时要求，仅对当次生效）
+- 默认：对话输出 Markdown + md/txt/html 三文件 + 内容区截图 content-png 落盘到 DIR（auto 按系统选：macOS=/Users/luzhaosheng/MyWork/智慧食堂/reports、Windows=d:\Workspace_QCoder\reports）/<当周最后一天日期>/ + html 自动打开（DIR 目录/盘符不存在时自动改用用户主目录下 reports：macOS=~/reports、Windows=%USERPROFILE%\reports）
+- 说「写到桌面」→ 本次落盘到桌面（macOS=~/Desktop、Windows=%USERPROFILE%\Desktop）；说「存到 ~/report / D:\report」→ 本次用指定目录（均自动按当周最后一天建子目录）
+- 说「不落盘/别写文件」→ 本次只在对话输出，不写文件、不开浏览器
+- 说「只要 md」「只出 html」「只要内容区截图」→ 本次只落指定格式文件；说「这次不截图」→ 本次跳过截图（content-png = 本周概览与三张卡片整体一张图，四周约 40px 留白、「本周完成任务」标题右侧带周范围徽章（跟随 WEEK_END），不含头部标题、复制按钮、页脚）
+- 说「只要截图/重新截个图」（如「给上周周报截个图」）→ 本次不重新生成内容，只对现有 html 执行内容区截图（覆盖 content-png，需 html 已存在，找不到则提示先生成）
+- 说「别开浏览器」→ 本次落盘后不自动打开 html
+- 说「保留之前的」→ 同一周重复生成时不覆盖，文件名追加时间戳另存
+
+## 配置开关（改 SKILL.md 顶部「默认配置」节，长期生效）
+| 配置项 | 作用 | 可选值 / 示例 |
+|---|---|---|
+| DISK | 是否落盘写文件 | true（落盘，默认）/ false（默认只在对话输出） |
+| FORMATS | 落盘哪些格式（数组） | [md, txt, html, content-png]（默认，含内容区截图）/ [md, html] / [md, txt, html]（不截图）；content-png = 概览与三张卡片整体截图（四周约 40px 留白、完成节带周范围徽章），不含头部标题/复制按钮/页脚 |
+| DIR | 落盘根目录 | auto（按当前系统自动选 DIR_MAC / DIR_WIN，默认）；DIR_MAC = macOS 根目录（/Users/luzhaosheng/MyWork/智慧食堂/reports）；DIR_WIN = Windows 根目录（d:\Workspace_QCoder\reports） |
+| OPEN_HTML | 落盘后是否自动打开 html | true（自动打开，默认）/ false（不打开） |
+| WEEK_END | 周结束日（当周最后一天，决定周范围与落盘目录名） | friday（默认）/ sunday / saturday 等 |
+| TEMPLATE | 报告模板 | default（内置三段式，默认）/ custom（按「📝 自定义模板」节的结构生成） |
+| CONFIRM | 落盘前先出效果确认 | never（直接生成不确认，默认）/ text（纯文字整理模式确认）/ always（所有生成都确认） |
+- 优先级：临时口头要求（不落盘/写到桌面/只要 md/只要内容区截图/这次不截图/别开浏览器/临时换模板/临时改周结束日等）永远优先于默认配置，仅对当次生效、不改配置
+- DIR（按系统解析）指向的目录/盘符不存在时，自动回退到用户主目录下 reports（macOS=~/reports、Windows=%USERPROFILE%\reports）

package/weekly-report/user-config.md

@@ -0,0 +1,37 @@
+# 用户配置（升级技能时本文件不会被覆盖）
+
+> 你的个人配置全放在这里。skill-forge 升级技能时官方只更新 SKILL.md 与 resources/，
+> 本文件始终保留你的版本——落盘目录、格式、角色画像、自定义模板放心改。
+
+
+## ⚙️ 默认配置（用户可手动修改；临时口头要求永远优先）
+
+```yaml
+DISK: true                     # 是否落盘写文件；false = 默认只在对话输出，不写文件不开浏览器
+FORMATS: [md, txt, html, content-png] # 落盘哪些格式（数组，可删减/增，如 [md, html] / [md, txt, html]（不截图）；content-png = 整页内容区截图（头部标题卡片 + 本周概览卡片与本周完成任务/下周计划/风险阻塞点分节卡片整体截出，头部卡片必须带上），删除该项即不截图；不影响对话中的 md 正文输出）
+DIR: auto                      # 落盘根目录：auto = 按当前系统自动选 DIR_MAC / DIR_WIN（也可直接写死某个绝对路径）
+DIR_MAC: /Users/luzhaosheng/MyWork/智慧食堂/reports    # macOS 落盘根目录（日报按目标日期、周报按当周最后一天建子目录；目录不存在时回退用户主目录下 reports）
+DIR_WIN: d:\Workspace_QCoder\reports                   # Windows 落盘根目录（日报按目标日期、周报按当周最后一天建子目录；目录/盘符不存在时回退用户主目录下 reports）
+OPEN_HTML: true                # 落盘后是否自动用浏览器打开 html（FORMATS 不含 html 时忽略）
+TEMPLATE: default              # 报告模板：default = 内置三段式（本周完成任务/下周计划/风险阻塞点）；custom = 使用下方「📝 自定义模板」节；口头临时指定模板仅当次生效
+ROLE: 全栈开发工程师（企业内技术开发）  # 用户默认职业角色与主要工作内容（两者并存：职业名 + 括号内工作内容，生成内容/术语/量化指标/热力图/柱图/风险话术全部按此画像走）；用户随口描述职业时（如「我搞装修的，天天跑工地」）→ AI 提炼为规范表述（装修项目经理（负责工地现场管理、施工进度与质量巡检））更新此处；说「以 XX 的身份写」→ 当次临时换角色不改配置；说「以后默认用 XX 角色 / 我的职业是 XX / 我的主要工作是 XX」→ 永久更新此处
+WEEK_END: friday               # 周结束日（当周最后一天）：friday = 每周五（默认）；可改 sunday = 每周日、saturday 等；周范围、落盘子目录名均按该天日期
+CONFIRM: never                 # 落盘前确认：never = 直接生成落盘不确认（默认）；text = 纯文字整理模式先出效果确认后再落盘；always = 任何方式生成都先确认；临时说「先看看效果」当次先确认、说「不用确认」当次跳过
+```
+
+> 临时口头要求（仅对当次生效，不修改上方配置）：说「不落盘/别写文件」→ 当次 DISK=false；说「写到桌面/存到 ~/report（macOS）或 D:\report（Windows）」→ 当次改用该 DIR；说「只要 md / 只出 html / 只要内容区截图」→ 当次只落指定格式；说「这次不截图」→ 当次不生成内容区截图；说「只要截图/重新截个图」→ 当次只对现有 html 执行内容区截图（不重新收集 git、不重写 md/txt/html 内容文件）；说「别开浏览器」→ 当次 OPEN_HTML=false；说「这周按周日收尾/这周算到周日」→ 当次 WEEK_END=sunday（当次周范围与目录名跟随）；说「这次按 xxx 模板来」→ 当次临时换模板（不改配置）；说「以后都用这个模板」→ 自动写入下方「📝 自定义模板」节并把 TEMPLATE 改为 custom（永久生效）；说「先看看效果/先出效果再落盘」→ 当次先出效果确认后再落盘；说「不用确认/直接落盘」→ 当次跳过确认直接落盘。
+
+## 📝 自定义模板（TEMPLATE: custom 时启用，用户可手改，适配各类岗位）
+
+把顶部 TEMPLATE 改为 custom 后，按下面结构生成报告（段名、段数、条目格式均可改）：
+
+```text
+段一：本周工作内容（每条：工作描述 - 完成情况）
+段二：存在问题与困难（只列描述）
+段三：下周工作计划（每条：计划描述 - 预计完成时间）
+```
+
+> 只写段结构与条目格式即可；未写明的细节（中文顿号序号、生成时间行、落盘行为、HTML 样式）沿用默认规范。
+
+---
+> 更多用法见 SKILL.md 的「生成流程」与 resources/ 分册。