skill-forge-hub 0.2.0 → 0.3.0

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

@@ -8,7 +8,7 @@
   - 「10月20号所在周的周报」→ 该日期所在周（缺年份默认当年，晚于今天取去年同日）
   - 「20261020 所在周的周报」→ 直接按数字日期定位所在周
   - 「国庆那周」「春节那周」「春节前那周」→ 节假日锚定，AI 现场推算节日公历日期（农历节日按农历换算）定位所在周
-  - 「10月第2周到第3周的周报」「10月20号到11月6号的周报」「上上周到上周」→ 连续多周批量生成，每周一份（本周下周计划自动从下一周完成任务抽取）
+  - 「10月第2周到第3周的周报」「10月20号到11月6号的周报」「上上周到上周」→ 连续多周批量生成，每周一份（本周下周计划自动从下一周任务进度抽取）
 - 同一周重复生成会直接覆盖原文件；说「保留之前的」→ 文件名追加时间戳另存不覆盖
 - 说「日报和周报都要」→ 日报、周报按各自流程分别生成，同日数据自动去重
 - 说「打开/查看本周周报」→ 该报告文件已存在时直接打开不重新生成；不存在则按正常流程生成
@@ -17,16 +17,16 @@
 - 落盘子目录用当周最后一天（WEEK_END）的日期命名；改顶部 WEEK_END（friday/sunday 等）可改变周结束日；临时说「这周按周日收尾/这周算到周日」→ 当次按周日算（仅当次生效）
 
 ## 口头追加任务
-- 说「补充一下：这周处理了两天的支付问题」→ 自动按语义拆成多条任务，润色为规范格式并入「本周完成任务」
+- 说「补充一下：这周处理了两天的支付问题」→ 自动按语义拆成多条任务，润色为规范格式并入「本周任务进度」
 - 拆分信号：时间词（周几/上几天）、连接词（还有/另外/以及）、分号顿号列举、数字列举
-- 补充内容带分段词时按段并入：「下周计划：xxx」→ 下周计划段；「风险：xxx」→ 风险阻塞点段（说「风险暂无/无风险」→ 风险段写「暂无」）；不带分段词默认并入「本周完成任务」
+- 补充内容带分段词时按段并入：「下周计划：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」→ 按意见修改后重新出效果再确认
@@ -34,22 +34,22 @@
 - 说「不落盘/别写文件」时跳过确认，直接对话输出
 
 ## 自定义模板（适配各类岗位）
-- 内置模板为三段式（本周完成任务/下周计划/风险阻塞点），适合开发岗位；其他岗位可自定义模板
+- 内置模板为三段式（本周任务进度/下周计划/风险阻塞点），适合开发岗位；其他岗位可自定义模板
 - 临时换模板：说「这次按 xxx 来」→ 口头描述结构（如"按四段：工作内容/存在问题/下周计划/需要支持"），当次按该结构生成，不改配置
 - 永久换模板：把顶部配置 TEMPLATE 改为 custom，并按 SKILL.md 的「📝 自定义模板」节说明修改段结构，之后默认按新模板生成
 - 说「以后都用这个模板」→ 自动把当前口述的结构写入「📝 自定义模板」节并把 TEMPLATE 改为 custom
 - 模板优先于纯文字模式的信号词归类：指定了段名后，文字按段名归类填充
 
 ## 角色定制（我的职业画像）
-- 默认按顶部「默认配置」ROLE 生成（当前：程序员，企业内技术开发，负责前端、后端方向）；说「我的职业是 XX / 我的主要工作是 XX / 以后默认用 XX 角色」→ 永久修改 ROLE
+- 默认按顶部「默认配置」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）
+- 默认：对话输出 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），不含头部标题、复制按钮、页脚）
+- 说「只要 md」「只出 html」「只要内容区截图」→ 本次只落指定格式文件；说「这次不截图」→ 本次跳过截图（content-png = 本周概览与三张卡片整体一张图，四周约 40px 留白、「本周任务进度」标题右侧带周范围徽章（跟随 WEEK_END），不含头部标题、复制按钮、页脚）
 - 说「只要截图/重新截个图」（如「给上周周报截个图」）→ 本次不重新生成内容，只对现有 html 执行内容区截图（覆盖 content-png，需 html 已存在，找不到则提示先生成）
 - 说「别开浏览器」→ 本次落盘后不自动打开 html
 - 说「保留之前的」→ 同一周重复生成时不覆盖，文件名追加时间戳另存
@@ -58,8 +58,8 @@
 | 配置项 | 作用 | 可选值 / 示例 |
 |---|---|---|
 | 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） |
+| 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（按「📝 自定义模板」节的结构生成） |

package/weekly-report/user-config.md

@@ -2,18 +2,21 @@
 
 > 你的个人配置全放在这里。skill-forge 升级技能时官方只更新 SKILL.md 与 resources/，
 > 本文件始终保留你的版本——落盘目录、格式、角色画像、自定义模板放心改。
+> 官方升级若带来新配置点，会另存 `user-config.md.upstream` 对照文件到同目录，
+> 你按需查看并手动合并新配置点到本文件。
 
 
 ## ⚙️ 默认配置（用户可手动修改；临时口头要求永远优先）
 
 ```yaml
 DISK: true                     # 是否落盘写文件；false = 默认只在对话输出，不写文件不开浏览器
-FORMATS: [md, txt, html, content-png] # 落盘哪些格式（数组，可删减/增，如 [md, html] / [md, txt, html]（不截图）；content-png = 整页内容区截图（头部标题卡片 + 本周概览卡片与本周完成任务/下周计划/风险阻塞点分节卡片整体截出，头部卡片必须带上），删除该项即不截图；不影响对话中的 md 正文输出）
+CONFIG_VERSION: 1              # 配置结构版本：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 = 使用下方「📝 自定义模板」节；口头临时指定模板仅当次生效
+TEMPLATE: default              # 报告模板：default = 内置三段式（本周任务进度/下周计划/风险阻塞点）；custom = 使用下方「📝 自定义模板」节；口头临时指定模板仅当次生效
 ROLE: 全栈开发工程师（企业内技术开发）  # 用户默认职业角色与主要工作内容（两者并存：职业名 + 括号内工作内容，生成内容/术语/量化指标/热力图/柱图/风险话术全部按此画像走）；用户随口描述职业时（如「我搞装修的，天天跑工地」）→ AI 提炼为规范表述（装修项目经理（负责工地现场管理、施工进度与质量巡检））更新此处；说「以 XX 的身份写」→ 当次临时换角色不改配置；说「以后默认用 XX 角色 / 我的职业是 XX / 我的主要工作是 XX」→ 永久更新此处
 WEEK_END: friday               # 周结束日（当周最后一天）：friday = 每周五（默认）；可改 sunday = 每周日、saturday 等；周范围、落盘子目录名均按该天日期
 CONFIRM: never                 # 落盘前确认：never = 直接生成落盘不确认（默认）；text = 纯文字整理模式先出效果确认后再落盘；always = 任何方式生成都先确认；临时说「先看看效果」当次先确认、说「不用确认」当次跳过