skill-forge-hub 0.3.0 → 0.5.0

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

@@ -12,7 +12,7 @@
 - 同一周重复生成会直接覆盖原文件；说「保留之前的」→ 文件名追加时间戳另存不覆盖
 - 说「日报和周报都要」→ 日报、周报按各自流程分别生成，同日数据自动去重
 - 说「打开/查看本周周报」→ 该报告文件已存在时直接打开不重新生成；不存在则按正常流程生成
-- 说「只算我的提交」→ 只聚合本人提交（git log 加 --author=<用户名>）；默认仓库内全部提交都计入
+- 开发类用户可说「只算我的提交」→ 只聚合本人提交；默认仓库内全部提交都计入
 - 说「只写 xxx 的周报 / 只聚合 xxx 仓库」→ 只收集指定仓库的提交，跳过其它仓库
 - 落盘子目录用当周最后一天（WEEK_END）的日期命名；改顶部 WEEK_END（friday/sunday 等）可改变周结束日；临时说「这周按周日收尾/这周算到周日」→ 当次按周日算（仅当次生效）
 
@@ -20,10 +20,10 @@
 - 说「补充一下：这周处理了两天的支付问题」→ 自动按语义拆成多条任务，润色为规范格式并入「本周任务进度」
 - 拆分信号：时间词（周几/上几天）、连接词（还有/另外/以及）、分号顿号列举、数字列举
 - 补充内容带分段词时按段并入：「下周计划：xxx」→ 下周计划段；「风险：xxx」→ 风险阻塞点段（说「风险暂无/无风险」→ 风险段写「暂无」）；不带分段词默认并入「本周任务进度」
-- 与 git 提交聚合出的任务自动去重，同一件事只保留一条
+- 与提交记录聚合出的任务自动去重，同一件事只保留一条
 
-## 贴文字 / 发图片 / 给文件整理周报（无 git 提交也适用）
-- 直接贴一段文字说「整理成周报 / 把这段文字整理成周报」→ 以文字为主源生成，不依赖 git 提交（非开发岗位也可用）；说「只整理这段文字 / 只按这段 / 不用 git」同样跳过 git 与会话上下文
+## 贴文字 / 发图片 / 给文件整理周报（没有提交记录也适用）
+- 直接贴一段文字说「整理成周报 / 把这段文字整理成周报」→ 以文字为主源生成，不依赖提交记录（非开发岗位也可用）；说「只整理这段文字 / 只按这段」同样跳过其它来源与会话上下文
 - 发图片（截图/照片等 jpg/png/webp）或给文件（md/txt/docx/pdf 等）说「整理成周报」→ 先用 Read 读取：图片按视觉理解提取图中文字信息，md/txt 直接读文本，docx/pdf 优先尝试 pandoc 转文本（无 pandoc 则请用户粘贴文字），再按纯文字模式整理
 - 图片模糊/内容读不清时：先把已提取的部分展示给用户确认或补充，不瞎编没读到的内容
 - 自动分段归类：文字里写「下周/接下来/计划…」→ 下周计划；「风险/阻塞/问题/卡住…」→ 风险阻塞点；其余 → 本周任务进度（用户已明确分段则按用户分段）
@@ -34,7 +34,7 @@
 - 说「不落盘/别写文件」时跳过确认，直接对话输出
 
 ## 自定义模板（适配各类岗位）
-- 内置模板为三段式（本周任务进度/下周计划/风险阻塞点），适合开发岗位；其他岗位可自定义模板
+- 内置模板为四段式（本周结论 + 本周任务进度/下周计划/风险阻塞点），适合开发岗位；其他岗位可自定义模板
 - 临时换模板：说「这次按 xxx 来」→ 口头描述结构（如"按四段：工作内容/存在问题/下周计划/需要支持"），当次按该结构生成，不改配置
 - 永久换模板：把顶部配置 TEMPLATE 改为 custom，并按 SKILL.md 的「📝 自定义模板」节说明修改段结构，之后默认按新模板生成
 - 说「以后都用这个模板」→ 自动把当前口述的结构写入「📝 自定义模板」节并把 TEMPLATE 改为 custom
@@ -62,7 +62,7 @@
 | 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（按「📝 自定义模板」节的结构生成） |
+| TEMPLATE | 报告模板 | default（内置四段式，默认）/ custom（按「📝 自定义模板」节的结构生成） |
 | CONFIRM | 落盘前先出效果确认 | never（直接生成不确认，默认）/ text（纯文字整理模式确认）/ always（所有生成都确认） |
 - 优先级：临时口头要求（不落盘/写到桌面/只要 md/只要内容区截图/这次不截图/别开浏览器/临时换模板/临时改周结束日等）永远优先于默认配置，仅对当次生效、不改配置
 - DIR（按系统解析）指向的目录/盘符不存在时，自动回退到用户主目录下 reports（macOS=~/reports、Windows=%USERPROFILE%\reports）

package/weekly-report/user-config.md

@@ -10,19 +10,20 @@
 
 ```yaml
 DISK: true                     # 是否落盘写文件；false = 默认只在对话输出，不写文件不开浏览器
-CONFIG_VERSION: 1              # 配置结构版本：skill 升级时若配置结构变化会递增；AI 每次执行前对比 SKILL.md「配置版本机制」节声明的当前版本，不一致时按 SKILL.md 的迁移规则处理（先备份本文件为带时间戳 .bak，再迁移，最后对话告知用户）
+CONFIG_VERSION: 2              # 配置结构版本：skill 升级时若配置结构变化会递增；AI 每次执行前对比 SKILL.md「配置版本机制」节声明的当前版本，不一致时按 SKILL.md 的迁移规则处理（先备份本文件为带时间戳 .bak，再迁移，最后对话告知用户）
 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 = 使用下方「📝 自定义模板」节；口头临时指定模板仅当次生效
+THEME: tech                    # html 页面主题：tech 深蓝科技（默认）/ biz 浅色商务 / mono 极简黑白 / warm 温暖渐变；生成时写 <html data-theme="THEME值"> 定默认，页面右下角换肤坞四色点随点随换（浏览器本地记忆，?shot 截图模式自动隐藏，打印隐藏）
+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（永久生效）；说「先看看效果/先出效果再落盘」→ 当次先出效果确认后再落盘；说「不用确认/直接落盘」→ 当次跳过确认直接落盘。
+> 临时口头要求（仅对当次生效，不修改上方配置）：说「不落盘/别写文件」→ 当次 DISK=false；说「写到桌面/存到 ~/report（macOS）或 D:\report（Windows）」→ 当次改用该 DIR；说「只要 md / 只出 html / 只要内容区截图」→ 当次只落指定格式；说「这次不截图」→ 当次不生成内容区截图；说「只要截图/重新截个图」→ 当次只对现有 html 执行内容区截图（不重新收集数据、不重写 md/txt/html 内容文件）；说「别开浏览器」→ 当次 OPEN_HTML=false；说「这周按周日收尾/这周算到周日」→ 当次 WEEK_END=sunday（当次周范围与目录名跟随）；说「这次按 xxx 模板来」→ 当次临时换模板（不改配置）；说「以后都用这个模板」→ 自动写入下方「📝 自定义模板」节并把 TEMPLATE 改为 custom（永久生效）；说「先看看效果/先出效果再落盘」→ 当次先出效果确认后再落盘；说「不用确认/直接落盘」→ 当次跳过确认直接落盘。说「页面用浅色商务主题/浅色主题」→ 当次 THEME=biz；说「以后默认用暖色主题」→ 永久改 THEME=warm。
 
 ## 📝 自定义模板（TEMPLATE: custom 时启用，用户可手改，适配各类岗位）