skill-forge-hub 1.0.7 → 1.2.0

package/CHANGELOG.en.md

@@ -4,6 +4,25 @@
 
 Version history of the SkillForge npm package `skill-forge-hub` (command name `skill-forge`).
 
+## 1.2.0 (2026-11-12)
+
+**Chinese-style poster octet + collapsible dual docks + directory-visibility trio**
+
+- one-pager gains the Chinese-style school (inkwash / red-gold palace / blue-green landscape, style-native fixed palettes by charter) plus the scenario-specific watermark memo template (follows theme tokens): 28 → 32 layout templates, seven schools × 25 color themes = 800 combos (one-pager@2 → @10); theme dock trio upgrade — dots 14 → 18px, hover shows a theme-name tooltip, the handle always displays "Theme · current name"
+- one-pager template dock / theme dock collapsible: folded into capsule handles by default so they never block the poster (handles show the current template / theme name in real time); click to expand, auto-collapse after selection
+- prompt-pouch sort dropdown rebuilt as a self-drawn component (the dialog adopts the five-theme variables, dropdown options rendered with the unified theme) + sort-arrow edge fix (custom arrow with proper margin)
+- Directory-visibility trio: new SKILLS_CATALOG.md (per-skill bilingual standalone profiles for all 21 skills, ready to excerpt for skills.sh / awesome-claude-skills submissions and article citations); both READMEs fix the one-pager drift (8 templates × 10 themes / 80 combos → 32 templates in seven schools × 25 themes / 800 combos) + documentation navigation links the catalog / articles / submission kit; new docs/articles/ with two hands-on articles (managing prompts with AI skill packs, the right way to write daily reports with AI); new docs/directory-submission.md submission kit (awesome-claude-skills PR material & steps / skills.sh publishing guide / gh login guide)
+- skillforge-guide (root page + the 21 skills' bundled txt/html copies) gains a document-entry row in the cheat sheet: SKILLS_CATALOG.md / docs/articles/ / docs/directory-submission.md
+
+## 1.1.0 (2026-11-12)
+
+**Harvest season: 8 new skills (13 → 21, seven categories) + built-in usage guide + theme system alignment**
+
+- 8 new skills (seven categories take shape): team-report-collector joins Report showcase (team daily-report collector: three intake paths — verbal / file batch / page export → reports.json as the single source of truth + a single-file offline collection HTML + a date-grouped summary md); twin-docs (Chinese ↔ English twin documents) and one-pager (one-page poster: big gradient title + quote + key-point blocks + optional PNG capture) join Document mounting; release-notes joins Engineering efficiency (commits between two version tags → bilingual release notes + CHANGELOG entry + pre-publish npm self-check list); the new Data preparation category (data-prepper cleaning & structuring + commit-heatmap commit heatmaps); the new Communication & collaboration category (decision-log decision logs, with meeting-minutes and prompt-pouch moved in); skill-doctor joins Skill crafting (skill health check: static checks + three-section report with line-level locations); cli.js CATEGORIES seven-category mapping and both READMEs updated
+- Built-in usage guide: every skill ships skillforge-guide txt+html dual copies in resources/; SKILL.md gains the "how do I use skillforge" overall consultation trigger; guide typical-workflow cards reorganized into scenario bullets (html four cards 20 items + txt sync); root index.html redirects to skillforge-guide.html, making the online guide reachable directly at the GitHub Pages root; both READMEs switch links to absolute addresses + package.json gains the homepage field
+- Theme system alignment: team-report-collector upgrades from two themes to the five-theme system (tech/biz/mono/light/warm 12 core contracts) + tech background layer quartet + container widened to clamp(640px,60%,1200px); one-pager upgrades from three themes to five themes + background layer + key-point three-column grid filling the page width (template upgraded one-pager@2); the skin docks of the collector and the poster are pinned to the bottom-right corner (right/bottom 18px), aligned with the report family
+- Upgrade-command docs completed: 43 documents across README/install/usage-examples/guide gain npm update -g skill-forge-hub (upgrade the CLI itself) alongside skill-forge update (upgrade the skills) — two-tier wording, copy-paste friendly for non-technical users
+- Doc checkup fixes: README.en skill list gains the 8 missing rows; both READMEs align the annual-report wording (multi-source data, developer users can aggregate the year's git commits); stale "two themes" (collector) and "three themes" (poster) wording cleared; output-producing skills now always report output paths in conversation after saving; meta-forge-generated skills embed the SkillForge guide
 ## 1.0.7 (2026-11-12)
 
 **Docs split into pure Chinese & English mirrors + meta-forge lessons fully codified**

package/CHANGELOG.md

@@ -4,6 +4,25 @@
 
 SkillForge（技能锻造坊）npm 包 `skill-forge-hub`（命令名 `skill-forge`）版本变更记录。
 
+## 1.2.0（2026-11-12）
+
+**海报国风八式 + 双坞折叠 + 目录能见度三件套**
+
+- one-pager 国风雅韵组三套（水墨 / 红金宫廷 / 青绿山水，风格本体固定色相特许）+ 场景专用水印公文一套（跟随主题令牌）：28 → 32 套布局模板，七组流派 × 25 套配色主题 = 800 种版式（one-pager@2 → @10）；主题坞升级三件套——色点 14 → 18px、hover 弹出主题名浮签、把手常显「主题 · 当前主题名」
+- one-pager 模板坞 / 主题坞折叠展开：默认折叠成胶囊把手不遮主体（把手实时显示当前模板名 / 主题名），点把手展开、选中自动收起
+- prompt-pouch 排序下拉改自绘组件（弹框吃五主题变量，下拉选项与弹框统一主题渲染）+ 排序箭头贴边修复（自定义箭头留出边距）
+- 目录能见度三件套：新增 SKILLS_CATALOG.md（21 技能逐条中英双语独立简介，供 skills.sh / awesome-claude-skills 等目录收录与文章引用时整段摘录）；README 双版 one-pager 漂移修复（8 套×10 主题 80 种 → 32 套七组×25 主题 800 种）+ 文档导航挂 CATALOG / 文章 / 素材包；新增 docs/articles/ 两篇实操文章（用 AI 技能包管提示词、AI 写日报的正确姿势）；新增 docs/directory-submission.md 目录收录素材包（awesome-claude-skills PR 素材与步骤 / skills.sh 发布指引 / gh 登录指引）
+- skillforge-guide（根引导页 + 21 技能内置 txt/html 双版）通用小抄补文档入口行：SKILLS_CATALOG.md / docs/articles/ / docs/directory-submission.md
+
+## 1.1.0（2026-11-12）
+
+**技能丰收季 8 连发：13 技能扩至 21 技能七分类 + 内置使用指引 + 主题体系对齐**
+
+- 新增 8 个技能（七分类成型）：报表汇演补 team-report-collector（团队日报收集台：口述 / 文件批量 / 页面导出三路收日报 → reports.json 数据真相源 + 单文件离线收集台 HTML + 按日期分组汇总 md）；文档装裱补 twin-docs（中英孪生文档：术语表对齐、逐项对应、双向同步检查）与 one-pager（一页纸海报：大标题渐变 + 金句 + 要点块 + 可选 PNG 截图）；工程提效补 release-notes（版本标签间提交 → 中英双语发版说明 + CHANGELOG 条目 + npm 发布自检清单）；新设数据整备类（data-prepper 清洗结构化 + commit-heatmap 提交热力图）；新设沟通协作类（decision-log 决策日志，meeting-minutes 与 prompt-pouch 迁入）；技能自造补 skill-doctor（技能体检：静态检查 + 三段式报告行级定位）；cli.js CATEGORIES 七分类映射与 README 双版同步登记
+- 内置使用指引：每个技能 resources/ 内置 skillforge-guide txt+html 双版；SKILL.md 加「skillforge 怎么用」整体咨询触发规则；guide 典型链路卡场景分条（html 四卡 20 条 + txt 同步）；根 index.html 跳转 skillforge-guide.html，GitHub Pages 根地址直达在线引导页；README 双版链接改绝对地址 + package.json 补 homepage 字段
+- 主题体系对齐：team-report-collector 收集台从双主题升级五主题（tech/biz/mono/light/warm 12 核心契约）+ 科技感背景层四件套 + 容器加宽 clamp(640px,60%,1200px)；one-pager 海报从三主题升级五主题 + 背景层 + 要点块三列网格铺满版心（模板升级 one-pager@2）；收集台与海报换肤坞固定右下角（right/bottom 18px）对齐报表体系
+- 升级命令文档补全：README/install/usage-examples/guide 共 43 份文档补充 npm update -g skill-forge-hub（升级 CLI 本体）与 skill-forge update（升级技能）两层口径，非技术用户照抄即可
+- 文档体检修复：README.en 技能清单补齐丰收季 8 行；README 双版年报口径对齐（多源数据，开发类用户可聚合 git 全年提交）；收集台「双主题」、海报「三主题」旧表述清零；产物型技能落盘后强制对话报告产物路径；meta-forge 生成技能内置 SkillForge 指引
 ## 1.0.7（2026-11-12）
 
 **文档中英分离 + meta-forge 坑教训全量入规**

package/README.en.md

@@ -49,13 +49,13 @@ Skills are grouped by "what they ultimately produce" — one skill belongs to ex
 
 | Category | Description | Skills |
 |:---|:---|:---|
-| Report showcase | Multi-source data assembly (a paragraph, descriptions in files, images & materials, verbal additions — anything becomes copy) into periodic reports (daily / weekly / monthly / quarterly / annual) | daily-report, weekly-report, monthly-report, quarterly-report, annual-report |
-| Document mounting | Document conversion & beautification: Word / Markdown / plain text → polished HTML + per-chapter screenshots | article-to-html |
-| Engineering efficiency | Pandoc-based document ↔ spec conversion (requirement slicing / spec export to Word·PDF): mechanical Pandoc conversion + AI proofreading against errors | spec-doc2spec, spec-spec2doc |
+| Report showcase | Multi-source data assembly (a paragraph, descriptions in files, images & materials, verbal additions — anything becomes copy) into periodic reports (daily / weekly / monthly / quarterly / annual) and a team daily-report collector | daily-report, weekly-report, monthly-report, quarterly-report, annual-report, team-report-collector |
+| Document mounting | Document conversion & beautification: Word / Markdown / plain text → polished HTML + per-chapter screenshots; Chinese ↔ English twin documents; one-page posters | article-to-html, twin-docs, one-pager |
+| Engineering efficiency | Pandoc-based document ↔ spec conversion (requirement slicing / spec export to Word·PDF): mechanical Pandoc conversion + AI proofreading against errors; release notes & CHANGELOG generation | spec-doc2spec, spec-spec2doc, release-notes |
 | Presentation showcase | From content to presentation: HTML-form magic slides (playback + templates + themes) and .pptx stage decks (natively editable pages + cover captures) | magic-deck, deck-stage |
-| Data preparation | Excel / CSV / charts, data cleaning & template organizing (planned) | (planned) |
-| Communication & collaboration | Meeting minutes (action items with owners and deadlines, the source of the reporting chain) and prompt management (prompt-pouch local console) | meeting-minutes, prompt-pouch |
-| Skill crafting | The meta skill that forges skills themselves (create skills / plugins) | meta-forge |
+| Data preparation | Excel / CSV / JSON cleaning into structured data (transparent cleaning steps, full audit trail, overview report) and git commit heatmaps | data-prepper, commit-heatmap |
+| Communication & collaboration | Meeting minutes (action items with owners and deadlines, the source of the reporting chain), prompt management (prompt-pouch local console) and decision logs | meeting-minutes, prompt-pouch, decision-log |
+| Skill crafting | The meta skill that forges skills themselves (create skills / plugins) and skill health checks | meta-forge, skill-doctor |
 
 ## Skill List
 
@@ -65,15 +65,23 @@ Skills are grouped by "what they ultimately produce" — one skill belongs to ex
 | weekly-report | Report showcase | [weekly-report/](weekly-report/) | Multi-source weekly reports (this week's conclusion + task progress / next week's plan / risks & blockers + weekly overview card); configurable week end (default Friday); natural-language week targeting (this week / last week / 2nd week of October / holiday-anchored) |
 | monthly-report | Report showcase | [monthly-report/](monthly-report/) | Multi-source monthly reports (four sections: monthly overview / key achievements / problems & improvements / next month's plan); developer users can aggregate the month's git commits; 12-industry dictionary, custom templates, natural-language month targeting |
 | quarterly-report | Report showcase | [quarterly-report/](quarterly-report/) | Multi-source quarterly summaries (four sections: quarter overview / key achievements / problems & improvements / next quarter's plan): core data cards with QoQ (vs last quarter) and YoY (vs last year) dual baselines, overview includes a Q1–Q4 trend chart; achievements in an M1/M2/M3 monthly timeline; 12-industry dictionary, custom templates |
-| annual-report | Report showcase | [annual-report/](annual-report/) | Multi-source annual summaries (five sections: year overview / core achievements / experience & growth / shortcomings & reflection / new-year plan): full-year git commit aggregation + verbal input; 12-industry dictionary, custom templates, natural-language year targeting |
+| annual-report | Report showcase | [annual-report/](annual-report/) | Multi-source annual summaries (five sections: year overview / core achievements / experience & growth / shortcomings & reflection / new-year plan); developer users can aggregate the year's git commits; 12-industry dictionary, custom templates, natural-language year targeting |
+| team-report-collector | Report showcase | [team-report-collector/](team-report-collector/) | Team daily-report collector: three intake paths (verbal / file batch / page export) into reports.json as the single source of truth + a single-file offline collection HTML (form filling + localStorage draft + JSON export/import + five-theme skinning) + a date-grouped summary md |
 | article-to-html | Document mounting | [article-to-html/](article-to-html/) | Word / Markdown / plain text → polished standalone HTML (Source Han Sans SC + Roboto, both free for commercial use; charts redrawn with HTML/CSS), per-chapter screenshots (Retina 2x); a ready-made HTML file can be captured directly or beautified first |
+| twin-docs | Document mounting | [twin-docs/](twin-docs/) | Chinese documents translated & synced into English versions (or reverse): glossary consistency, title hierarchy / tables / code blocks / links matched item by item, two-way sync checks for drift |
+| one-pager | Document mounting | [one-pager/](one-pager/) | A theme or one-line idea → one-page HTML poster (big title + quote + key-point blocks, one-screen vertical, print-friendly) + optional PNG capture; 32 layout templates (seven stylistic schools: modernism / editorial / data-business / art schools / Chinese-style / avant-garde / scenario-specific) × 25 color themes switchable on the fly (800 combos) |
 | spec-doc2spec | Engineering efficiency | [spec-doc2spec/](spec-doc2spec/) | Word / Markdown requirement docs → structured requirement slices (thin entry + resources volumes); auto-detects Pandoc and guides cross-platform installation when missing |
 | spec-spec2doc | Engineering efficiency | [spec-spec2doc/](spec-spec2doc/) | Markdown specs → Word / PDF deliverables; auto-detects Pandoc and guides cross-platform installation when missing; dual PDF paths (xelatex / Chrome print fallback) |
+| release-notes | Engineering efficiency | [release-notes/](release-notes/) | git commits between two version tags → bilingual release notes + CHANGELOG entry (categorized summary + user-perspective rewrite + commit stats) + pre-publish npm self-check list |
 | magic-deck | Presentation showcase | [magic-deck/](magic-deck/) | Content → single-file HTML slide deck (16:9 stage + playback engine + sixteen layout templates + seventeen themes + 21 domain template packs + five chart animations + animation library + fullscreen pure-playback mode): autoplay/loop/interval, keyboard hotkeys, in-page links, per-page PNG captures and body copying |
 | deck-stage | Presentation showcase | [deck-stage/](deck-stage/) | Reports / materials → professional .pptx stage decks: three-question interaction (materials → page skeleton table → build method), regular pages natively editable (data cards / timelines / bar charts / pie charts / line charts), cover & closing pages captured losslessly from HTML, speaker notes per page; visuals share the same source as the report family (tech/biz/mono/light/warm five themes) |
+| data-prepper | Data preparation | [data-prepper/](data-prepper/) | Excel / CSV / JSON raw data cleaned into structured data: format detection → cleaning (transparent cleaning steps, full audit trail, no guessing) → JSON/CSV output → data overview report (field profiles / distributions / outliers / cleaning log) |
+| commit-heatmap | Data preparation | [commit-heatmap/](commit-heatmap/) | git commits from the past year → GitHub-style commit heatmap HTML (53 weeks × 7 days cells, five intensity levels + stat cards for total commits / longest streak / active-day ratio / most active day), offline with zero dependencies, three themes |
 | meta-forge | Skill crafting | [meta-forge/](meta-forge/) | The meta skill: forges complete skill packages from requirements (thin entry + resources split + user-config), auto-embeds the eight mechanisms (CONFIG_VERSION key / user-config extraction / reference dual-track / doc-sync self-check discipline / preserve list / multi-file isolation / infringement-free, desensitized & offline / output reforge upgrades), auto-registers in the README category table, cli.js CATEGORIES and package.json files on repo entry (no skill missing from the npm package) |
+| skill-doctor | Skill crafting | [skill-doctor/](skill-doctor/) | Skill health check: static checks on a skill directory (frontmatter matches directory name / resource references reachable / config version / placeholder residue / HTML-skill font desensitization, multi-file isolation & version stamps), three-section report with file-and-line-level locations |
 | meeting-minutes | Communication & collaboration | [meeting-minutes/](meeting-minutes/) | Multi-source meeting minutes (five sections: meeting info / conclusions / agenda discussion / resolutions & action items / next meeting): action items with owners and deadlines (source of the reporting chain, citable by daily/weekly/monthly/quarterly reports); built-in 12 meeting-type dictionaries, custom templates |
 | prompt-pouch | Communication & collaboration | [prompt-pouch/](prompt-pouch/) | Prompt management console: generates and maintains a local HTML management page (group sidebar / search / drag & button sorting / favorites / {variable} interpolation / one-click copy / full tag interactions / JSON import & export / group emoji quick panel), data stored in data/prompts.json with rolling backups in backup/, page and data separated, dual-hand collaboration (direct page edits + AI writing) |
+| decision-log | Communication & collaboration | [decision-log/](decision-log/) | Important decisions logged as quadruples (conclusion / trade-offs / rejected alternatives / applicable & expiry conditions): aggregated by topic, INDEX index, searchable & reviewable anytime |
 
 ## Quick Start
 
@@ -81,6 +89,7 @@ Skills are grouped by "what they ultimately produce" — one skill belongs to ex
 npm i -g skill-forge-hub        # global install
 skill-forge ls                  # list all skills (read-only)
 skill-forge init                # interactive skill picker, auto-detects & installs to your AI assistant's skill directory
+npm update -g skill-forge-hub   # upgrade the CLI itself after a release (this package only)
 skill-forge update              # upgrade installed skills (config-version aware, local config protected)
 ```
 
@@ -92,6 +101,10 @@ After installation, just say "write a daily report", "write a weekly report", "w
 |:---|:---|
 | [docs/install.en.md](docs/install.en.md) | Installation & upgrade in depth: both install methods, command reference, upgrade & config-protection mechanics, maintainer conventions (CONFIG_VERSION bump rules). Chinese version [docs/install.md](docs/install.md) |
 | [docs/architecture.en.md](docs/architecture.en.md) | Architecture & conventions: directory layout, skill anatomy (thin entry + resources), the eight mechanisms, splitting conventions, general principles. Chinese version [docs/architecture.md](docs/architecture.md) |
+| [docs/usage-examples.en.md](docs/usage-examples.en.md) | Skill usage scenario examples: daily-report / prompt-pouch / both PPT forms / meeting-minutes, full chain from install to reforge. Chinese version [docs/usage-examples.md](docs/usage-examples.md) |
+| [skillforge-guide](https://windfallsheng.github.io/SkillForge/) | Built-in usage guide (txt + html in every skill's resources/): ask the AI 'how to use skillforge' and it reads the guide and opens the styled page; live hosted guide at the GitHub Pages public URL (permanent) |
+| [SKILLS_CATALOG.md](SKILLS_CATALOG.md) | Per-skill bilingual catalog: a standalone citable profile for each of the 21 skills, ready to excerpt for skills.sh / awesome-claude-skills directory submissions and article citations |
+| [docs/articles/](docs/articles/) | Hands-on articles: prompt management with AI skill packs, the right way to write daily reports with AI; [docs/directory-submission.md](docs/directory-submission.md) directory submission kit (awesome-claude-skills PR material & steps / skills.sh publishing guide / gh login guide) |
 | [CHANGELOG.en.md](CHANGELOG.en.md) | Version changelog. Chinese version [CHANGELOG.md](CHANGELOG.md) |
 
 ## License

package/README.md

@@ -49,13 +49,13 @@
 
 | 分类 | 说明 | 收录技能 |
 |:---|:---|:---|
-| 报表汇演 | 多源数据整理（一段文字 / 文件里的描述 / 图片与素材 / 口头补充，什么材料都能成稿），按周期产出报告（日报 / 周报 / 月报 / 季报 / 年报） | daily-report、weekly-report、monthly-report、quarterly-report、annual-report |
-| 文档装裱 | 文档转换与美化：Word / Markdown / 纯文本 → 精美 HTML + 逐章截图 | article-to-html |
-| 工程提效 | 基于 Pandoc 的文档 ↔ 规格互转（需求文档切片 / 规格导出 Word·PDF），Pandoc 机械转换 + AI 校对防错 | spec-doc2spec、spec-spec2doc |
+| 报表汇演 | 多源数据整理（一段文字 / 文件里的描述 / 图片与素材 / 口头补充，什么材料都能成稿），按周期产出报告（日报 / 周报 / 月报 / 季报 / 年报）与团队日报收集台 | daily-report、weekly-report、monthly-report、quarterly-report、annual-report、team-report-collector |
+| 文档装裱 | 文档转换与美化：Word / Markdown / 纯文本 → 精美 HTML + 逐章截图；中文 ↔ 英文孪生文档；一页纸海报 | article-to-html、twin-docs、one-pager |
+| 工程提效 | 基于 Pandoc 的文档 ↔ 规格互转（需求文档切片 / 规格导出 Word·PDF），Pandoc 机械转换 + AI 校对防错；发版说明与 CHANGELOG 生成 | spec-doc2spec、spec-spec2doc、release-notes |
 | 演示汇演 | 从内容到演示：HTML 形态的魔法幻灯（放映 + 模板 + 主题）与 .pptx 登台文稿（原生可编辑页 + 封面截图） | magic-deck、deck-stage |
-| 数据整备 | Excel / CSV / 图表、数据清洗与模板整理（规划中） | （规划中） |
-| 沟通协作 | 会议纪要（行动项带负责人与截止时间，汇报链源头）与提示词管理（锦囊本地管理台） | meeting-minutes、prompt-pouch |
-| 技能自造 | 锻造技能本身的元技能（创建技能 / 插件） | meta-forge |
+| 数据整备 | Excel / CSV / JSON 清洗结构化（清洗项明示、每步留痕、概览报告）与 git 提交热力图 | data-prepper、commit-heatmap |
+| 沟通协作 | 会议纪要（行动项带负责人与截止时间，汇报链源头）、提示词管理（锦囊本地管理台）与决策日志 | meeting-minutes、prompt-pouch、decision-log |
+| 技能自造 | 锻造技能本身的元技能（创建技能 / 插件）与技能体检 | meta-forge、skill-doctor |
 
 ## 技能清单
 
@@ -65,15 +65,23 @@
 | weekly-report | 报表汇演 | [weekly-report/](weekly-report/) | 多源数据生成周报（本周结论 + 本周任务进度/下周计划/风险阻塞点 + 本周概览卡）；周结束日可配置（默认周五），支持自然语言周定位（本周/上周/10月第2周/节假日锚定） |
 | monthly-report | 报表汇演 | [monthly-report/](monthly-report/) | 多源数据生成月报（四段式：月度概览/本月关键成果/问题与改进/下月计划），开发类用户可聚合当月 git 提交；12 行业职业词典，支持自定义模板与自然语言月份定位 |
 | quarterly-report | 报表汇演 | [quarterly-report/](quarterly-report/) | 多源数据生成季度总结（四段式：季度概览/季度关键成果/问题与改进/下季度计划）：核心数据卡带环比（较上季度）+ 同比（较去年同期）双基准，概览附 Q1-Q4 季度走势图；成果段按 M1/M2/M3 月时间线；12 行业职业词典，支持自定义模板 |
-| annual-report | 报表汇演 | [annual-report/](annual-report/) | 多源数据生成年度总结（五段式：年度概览/核心成果/经验成长/不足反思/新年规划）：git 全年提交聚合 + 会话口述；12 行业职业词典，支持自定义模板与自然语言年度定位 |
+| annual-report | 报表汇演 | [annual-report/](annual-report/) | 多源数据生成年度总结（五段式：年度概览/核心成果/经验成长/不足反思/新年规划），开发类用户可聚合 git 全年提交；12 行业职业词典，支持自定义模板与自然语言年度定位 |
+| team-report-collector | 报表汇演 | [team-report-collector/](team-report-collector/) | 团队成员日报收集台：口述 / 文件批量 / 页面导出三种方式收日报 → reports.json 数据真相源 + 单文件离线收集台 HTML（表单填写 + localStorage 草稿 + 导出导入 JSON + 五主题换肤）+ 按日期分组汇总 md |
 | article-to-html | 文档装裱 | [article-to-html/](article-to-html/) | Word / Markdown / 纯文本 → 精美独立 HTML（思源黑体 + Roboto 商用免费字体，图表 HTML/CSS 重绘），逐章截图（Retina 2x）；现成 HTML 可直接截图或先美化 |
+| twin-docs | 文档装裱 | [twin-docs/](twin-docs/) | 中文文档翻译并同步为英文版（或反向）：术语表一致性对齐、标题层级 / 表格 / 代码块 / 链接逐项对应、双向同步检查出差 |
+| one-pager | 文档装裱 | [one-pager/](one-pager/) | 主题 / 一句话想法 → 一页纸 HTML 海报（大标题 + 金句 + 要点块，纵向一屏、打印友好）+ 可选 PNG 截图；32 套布局模板（现代主义/编辑出版/数据商务/艺术流派/国风雅韵/先锋实验/场景专用七组流派）× 25 套配色主题随点随切（800 种版式） |
 | spec-doc2spec | 工程提效 | [spec-doc2spec/](spec-doc2spec/) | Word / Markdown 需求文档转结构化需求切片（薄入口 + resources 分册）；自动检测 Pandoc，未装引导跨系统安装 |
 | spec-spec2doc | 工程提效 | [spec-spec2doc/](spec-spec2doc/) | Markdown 规格导出为 Word / PDF 交付文档；自动检测 Pandoc，未装引导跨系统安装；PDF 双路径（xelatex / Chrome 打印兜底） |
+| release-notes | 工程提效 | [release-notes/](release-notes/) | git 两个版本标签之间提交 → 中英双语发版说明 + CHANGELOG 条目（分类归纳 + 用户视角改写 + 提交统计）+ npm 发布前自检清单 |
 | magic-deck | 演示汇演 | [magic-deck/](magic-deck/) | 内容 → 单文件 HTML 幻灯（16:9 舞台 + 播放引擎 + 十六套版式模板 + 十七套主题 + 领域成套模板 21 套 + 图表动画五式 + 动画库 + 全屏放映纯净模式）：自动播放/循环/间隔、键盘热键、页内连接、逐页 PNG 截图与主体复制 |
 | deck-stage | 演示汇演 | [deck-stage/](deck-stage/) | 报告/素材 → 专业 .pptx 登台文稿：三问交互（素材 → 页骨架表 → 成片方式），常规页原生可编辑（数据卡/时间线/柱图/饼图/折线），封面与结尾页 HTML 截图保真，每页可带演讲备注；视觉与报表同源（tech/biz/mono/light/warm 五主题） |
+| data-prepper | 数据整备 | [data-prepper/](data-prepper/) | Excel / CSV / JSON 散装数据清洗为结构化数据：格式探测 → 清洗（清洗项明示、逐条留痕、不猜不编）→ JSON/CSV 落盘 → 数据概览报告（字段画像 / 分布 / 异常值 / 清洗清单） |
+| commit-heatmap | 数据整备 | [commit-heatmap/](commit-heatmap/) | git 近一年提交 → GitHub 风格提交热力图 HTML（53 周×7 天格子五档深浅 + 总提交数/最长连续天数/活跃占比/最活跃日统计卡），离线零依赖、三主题切换 |
 | meta-forge | 技能自造 | [meta-forge/](meta-forge/) | 元技能：从需求出发锻造完整技能包（薄入口 + resources 拆分 + user-config），自动植入八大机制（CONFIG_VERSION 钥匙 / user-config 抽离 / reference 双轨 / 自检纪律 / preserve 保护清单 / 多文件隔离 / 零侵权脱敏离线 / 产物升级回炉），入仓库时自动登记 README 分类表、cli.js CATEGORIES 与 package.json files（npm 包内容不遗漏） |
+| skill-doctor | 技能自造 | [skill-doctor/](skill-doctor/) | 技能体检：对技能目录跑静态检查（frontmatter 与目录名一致 / 资源引用可达 / 配置版本 / 占位符残留 / HTML 技能字体脱敏与多文件隔离与版本戳），三段式体检报告带文件行级定位 |
 | meeting-minutes | 沟通协作 | [meeting-minutes/](meeting-minutes/) | 多源材料生成会议纪要（五段式：会议信息/会议结论/议题讨论/决议与行动项/下次会议）：行动项带负责人与截止时间（汇报链源头，可被日报/周报/月报/季报引用）；内置 12 类会议类型词典，支持自定义模板 |
 | prompt-pouch | 沟通协作 | [prompt-pouch/](prompt-pouch/) | 锦囊提示词管理台：生成并维护本地 HTML 管理页面（分组侧栏/搜索/拖拽与按钮排序/收藏/{变量}插值/一键复制/标签全交互/导入导出 JSON 备份/分组 emoji 快捷面板），数据存 data/prompts.json、滚动备份在 backup/ 子目录，页面与数据分离，双笔协作（页面直写 + AI 代笔） |
+| decision-log | 沟通协作 | [decision-log/](decision-log/) | 重要决策四元组日志（结论 / 取舍权衡 / 被否方案 / 适用与失效条件）：按主题聚合落盘、INDEX 索引、随时检索复盘 |
 
 ## 快速开始
 
@@ -81,6 +89,7 @@
 npm i -g skill-forge-hub        # 全局安装
 skill-forge ls                  # 列出全部技能（只读）
 skill-forge init                # 交互式挑选技能，自动探测并安装到 AI 助手技能目录
+npm update -g skill-forge-hub   # 官方发新版后升级 CLI 本体（只升级本包）
 skill-forge update              # 升级已安装技能（配置版本感知，本地配置受保护）
 ```
 
@@ -92,6 +101,10 @@ skill-forge update              # 升级已安装技能（配置版本感知，
 |:---|:---|
 | [docs/install.md](docs/install.md) | 安装与升级详解：两种安装方式、命令参考、升级与配置保护机制、维护者约定（CONFIG_VERSION 递增规则）。英文版 [docs/install.en.md](docs/install.en.md) |
 | [docs/architecture.md](docs/architecture.md) | 架构与规范：目录结构、技能形态（薄入口 + resources）、八大机制、拆分规范、通用原则。英文版 [docs/architecture.en.md](docs/architecture.en.md) |
+| [docs/usage-examples.md](docs/usage-examples.md) | 技能使用场景示例：日报 / 锦囊 / PPT 两形态 / 会议纪要的安装到回炉全链路。英文版 [docs/usage-examples.en.md](docs/usage-examples.en.md) |
+| [skillforge-guide](https://windfallsheng.github.io/SkillForge/) | 内置使用指引（每个技能 resources/ 均含 txt + html 双版）：对 AI 说「skillforge 怎么用」即朗读指引并打开排版页；在线引导页见 GitHub Pages 公网地址（长期有效） |
+| [SKILLS_CATALOG.md](SKILLS_CATALOG.md) | 技能目录简介册：21 技能逐条中英双语独立简介（每技能一段可直接摘录），供 skills.sh / awesome-claude-skills 等目录收录与文章引用时锚点链接 |
+| [docs/articles/](docs/articles/) | 实操文章：《用 AI 技能包管提示词》《AI 写日报的正确姿势》；[docs/directory-submission.md](docs/directory-submission.md) 目录收录素材包（awesome-claude-skills PR 素材与步骤 / skills.sh 发布指引 / gh 登录指引） |
 | [CHANGELOG.md](CHANGELOG.md) | 版本变更记录。英文版 [CHANGELOG.en.md](CHANGELOG.en.md) |
 
 ## 许可证

package/SKILLS_CATALOG.md

@@ -0,0 +1,119 @@
+# SkillForge 技能目录简介册 · Skills Catalog
+
+> 本文件供技能目录收录引用（skills.sh / awesome-claude-skills 等）：每个技能一段**独立可引用**的双语简介，目录维护者可直接整段摘录；提交 PR 或发布时请引用本文件对应锚点（如 `SKILLS_CATALOG.md#daily-report`）。
+> Each section is a self-contained, citable profile for directory submissions (skills.sh, awesome-claude-skills, etc.). Link to anchors like `SKILLS_CATALOG.md#daily-report` when submitting.
+
+**仓库一览**：21 个可复用 Agent 技能（SKILL.md 为入口，一次生成，跨宿主迁移），覆盖报表汇报、文档装裱、工程提效、演示汇演、数据整备、沟通协作、技能自造七类。全部离线可用、零外部依赖、配置抽离（user-config.md，升级不覆盖）。
+**Repository at a glance**: 21 reusable agent skills (SKILL.md as entry point, generated once, portable across hosts), covering reporting, document beautification, engineering efficiency, presentations, data preparation, collaboration, and meta-skill crafting. Fully offline, zero external dependencies, user config isolated in user-config.md.
+
+---
+
+## 报表汇演 · Reporting
+
+### daily-report 日报 / Daily Report
+一句话总结当天工作 → 结构化日报（任务进度 / 明日计划 / 风险阻塞点），适配 12 行业（内置职业词典），支持自然语言日期（今天/昨天/上周三）、多日批量、自定义模板；一段文字、文件、图片或口头补充皆可成稿。
+Turns a one-line summary into a structured daily report (progress / tomorrow's plan / risks & blockers) adapted to 12 industries via a built-in professional glossary. Natural-language dates, multi-day batch generation, custom templates; accepts text, files, images, or spoken notes.
+
+### weekly-report 周报 / Weekly Report
+本周结论先行 + 任务进度 / 下周计划 / 风险阻塞点三节，1D=8H 工时口径；周结束日可配置（默认周五），自然语言周定位（本周/上周/10月第2周），12 行业词典与自定义模板。
+Conclusion-first weekly report with progress / next-week plan / risks sections. Configurable week end (default Friday), natural-language week selection, industry glossary and custom templates.
+
+### monthly-report 月报 / Monthly Report
+四段式月报（月度概览 / 关键成果 / 问题与改进 / 下月计划），开发类用户可聚合当月 git 提交；12 行业词典、自定义模板、自然语言月份定位。
+Four-section monthly report (overview / key results / issues & improvements / next-month plan); aggregates the month's git commits for developers; industry glossary, custom templates.
+
+### quarterly-report 季报 / Quarterly Report
+四段式季度总结，核心数据卡带环比 + 同比双基准，概览附 Q1-Q4 走势图，成果段按 M1/M2/M3 时间线；12 行业词典、自定义模板。
+Four-section quarterly summary with MoM + YoY data cards, Q1-Q4 trend chart, month-by-month timeline; industry glossary, custom templates.
+
+### annual-report 年报 / Annual Report
+五段式年度总结（年度概览 / 核心成果与里程碑 / 经验与成长 / 不足与反思 / 新年展望与规划），开发类用户可聚合 git 全年提交；12 行业词典、自定义模板。
+Five-section annual review (overview / milestones / growth / reflection / outlook); aggregates a full year of git commits; industry glossary, custom templates.
+
+### team-report-collector 团队日报收集台 / Team Report Collector
+团队成员日报收集台：口述 / 文件批量 / 页面导出三种方式收日报 → reports.json 数据真相源 + 单文件离线收集台 HTML（表单填写 + localStorage 草稿 + 导入导出 + 五主题换肤）+ 按日期分组汇总 md。
+Collects team members' daily reports via dictation, batch files, or page export into a single-file offline HTML console (forms, drafts, JSON import/export, 5 themes) with date-grouped markdown digests.
+
+## 文档装裱 · Document Beautification
+
+### article-to-html 文档装裱 / Article to HTML
+Word / Markdown / 纯文本 → 精美独立 HTML（思源黑体 + Roboto 商用免费字体，图表 HTML/CSS 重绘不嵌图），逐章截图（Retina 2x）；现成 HTML 可直接截图或先美化。
+Converts Word / Markdown / plain text into a polished standalone HTML page (free commercial fonts, charts redrawn in HTML/CSS), with per-chapter Retina screenshots; existing HTML can be screenshot or restyled directly.
+
+### twin-docs 孪生文档 / Twin Docs
+中文文档翻译并同步为英文版（或反向）：术语表一致性对齐、标题层级 / 表格 / 代码块 / 链接逐项对应、双向同步检查出差。
+Translates Chinese docs into English twins (or reverse) with a glossary for term consistency, structural parity for headings/tables/code/links, and bidirectional drift checks.
+
+### one-pager 一页纸海报 / One-Pager Poster
+主题 / 一句话想法 → 一页纸 HTML 海报（大标题 + 金句 + 要点块，纵向一屏、打印友好）+ 可选 PNG 截图；32 套布局模板 × 25 套配色主题随点随切（800 种版式），七组流派分类（含国风雅韵：水墨 / 红金宫廷 / 青绿山水），「专业设计」走七步引导。
+Turns a topic into a one-screen HTML poster (title + quote + points) with optional PNG export; 32 layout templates × 25 color themes (800 combinations) across seven style schools including Chinese-ink, palace-red, and blue-green landscape styles; a 7-step guided design mode for design requests.
+
+## 工程提效 · Engineering Efficiency
+
+### spec-doc2spec 文档转规格 / Doc to Spec
+Word / Markdown 需求文档 → 结构化需求切片（薄入口 + resources 分册）；自动检测 Pandoc，未装引导跨系统安装；Pandoc 机械转换 + AI 校对防错。
+Slices Word / Markdown requirement documents into structured requirement units; auto-detects Pandoc with cross-platform install guidance; Pandoc does mechanical conversion, AI does proofreading.
+
+### spec-spec2doc 规格转文档 / Spec to Doc
+Markdown 规格 → Word / PDF 交付文档；自动检测 Pandoc，未装引导跨系统安装；PDF 双路径（xelatex / Chrome 打印兜底）。
+Exports Markdown specs to Word / PDF deliverables; Pandoc auto-detection; dual-path PDF (xelatex / Chrome print fallback).
+
+### release-notes 发版说明 / Release Notes
+git 两标签之间提交 → 中英双语发版说明 + CHANGELOG 条目（分类归纳 + 用户视角改写 + 提交统计）+ npm 发布前自检清单。
+Generates bilingual release notes and CHANGELOG entries from git commits between two tags (categorized, user-perspective rewrite, commit stats) plus a pre-publish npm checklist.
+
+## 演示汇演 · Presentations
+
+### magic-deck 魔法幻灯 / Magic Deck
+内容 → 单文件 HTML 幻灯（16:9 舞台 + 播放引擎 + 十六套版式模板 + 十七套主题 + 领域成套模板 21 套 + 图表动画五式 + 动画库 + 全屏放映纯净模式）：自动播放 / 循环 / 间隔、键盘热键、页内连接、逐页 PNG 截图与主体复制。
+Turns content into a single-file HTML slideshow (16:9 stage, playback engine, 16 layouts, 17 themes, 21 domain template packs, chart animations, clean fullscreen mode) with autoplay, hotkeys, in-page links, per-slide PNG export.
+
+### deck-stage 登台文稿 / Deck Stage
+报告 / 素材 → 专业 .pptx 登台文稿：三问交互（素材 → 页骨架表 → 成片方式），常规页原生可编辑（数据卡 / 时间线 / 柱图 / 饼图 / 折线），封面与结尾页 HTML 截图保真，每页可带演讲备注；视觉与报表同源五主题。
+Builds a professional .pptx deck from reports or raw material through a three-question flow; regular pages natively editable (data cards, timeline, bar/pie/line charts), cover and closing pages rendered as HTML screenshots, per-page speaker notes.
+
+## 数据整备 · Data Preparation
+
+### data-prepper 数据整备 / Data Prepper
+Excel / CSV / JSON 散装数据 → 结构化数据：格式探测 → 清洗（清洗项明示、逐条留痕、不猜不编）→ JSON/CSV 落盘 → 数据概览报告（字段画像 / 分布 / 异常值 / 清洗清单）。
+Cleans scattered Excel / CSV / JSON into structured data: format detection, transparent step-by-step cleaning (no guessing), JSON/CSV output, and an overview report (field profiles, distributions, outliers, cleaning log).
+
+### commit-heatmap 提交热力图 / Commit Heatmap
+git 近一年提交 → GitHub 风格提交热力图 HTML（53 周 × 7 天格子五档深浅 + 总提交数 / 最长连续天数 / 活跃占比 / 最活跃日统计卡），离线零依赖、三主题切换。
+Renders a GitHub-style commit heatmap (53×7 grid, five intensity levels, stats cards for total commits, longest streak, activity ratio, busiest day) from a year of git history; offline, zero dependencies, three themes.
+
+## 沟通协作 · Communication & Collaboration
+
+### meeting-minutes 会议纪要 / Meeting Minutes
+多源材料 → 会议纪要（五段式：会议信息 / 会议结论 / 议题讨论 / 决议与行动项 / 下次会议）：行动项带负责人与截止时间（汇报链源头，可被日报 / 周报 / 月报 / 季报引用）；内置 12 类会议类型词典，支持自定义模板。
+Generates five-section meeting minutes (info / conclusions / discussions / resolutions & action items / next meeting) with owners and deadlines on action items that feed into daily/weekly/monthly reports; 12 meeting-type glossaries, custom templates.
+
+### prompt-pouch 锦囊 / Prompt Pouch
+提示词本地管理台：生成并维护本地 HTML 管理页面（分组侧栏 / 搜索 / 拖拽与按钮排序 / 收藏 / {变量}插值 / 一键复制 / 标签全交互 / 导入导出 JSON 备份），数据存 data/prompts.json、页面与数据分离，双笔协作（页面直写 + AI 代笔）。
+A local prompt management console: groups, search, drag-and-drop sorting, favorites, {variable} interpolation, one-click copy, full tag interactions, JSON import/export backups; data stored separately from the page for dual-hand collaboration.
+
+### decision-log 决策日志 / Decision Log
+重要决策四元组日志（结论 / 取舍权衡 / 被否方案 / 适用与失效条件）：按主题聚合落盘、INDEX 索引、随时检索复盘。
+Logs important decisions as four-tuples (conclusion / trade-offs / rejected alternatives / applicability & expiry conditions), aggregated by topic with an index for retrieval and review.
+
+## 技能自造 · Meta Skills
+
+### meta-forge 元锻炉 / Meta Forge
+元技能：从需求出发锻造完整技能包（薄入口 SKILL.md + resources 拆分 + user-config），自动植入八大机制（CONFIG_VERSION 钥匙 / user-config 抽离 / reference 双轨 / 自检纪律 / preserve 保护清单 / 多文件隔离 / 零侵权脱敏离线 / 产物升级回炉），入仓库时自动登记分类表与发布清单。
+The meta-skill that forges new skills: generates a complete skill package (thin SKILL.md entry + resources split + user-config) with eight mechanisms auto-implanted (config versioning, config extraction, reference dual-track, self-check discipline, preserve lists, multi-file isolation, zero-infringement offline discipline, artifact upgrade path).
+
+### skill-doctor 技能体检 / Skill Doctor
+技能体检：对技能目录跑静态检查（frontmatter 与目录名一致 / 资源引用可达 / 配置版本 / 占位符残留 / HTML 技能字体脱敏与多文件隔离与版本戳），三段式体检报告带文件行级定位。
+A static health check for skill directories: frontmatter-name consistency, reachable resource references, config versions, leftover placeholders, HTML skill font sanitization and multi-file isolation; reports issues with file-and-line locations.
+
+---
+
+## 安装 · Installation
+
+```bash
+npm i -g skill-forge-hub        # global CLI
+skill-forge ls                  # list all skills
+skill-forge init                # interactive pick & install to your agent's skill dir
+```
+
+Or copy any skill folder directly into your agent's skills directory — each skill is self-contained.

package/annual-report/SKILL.md

@@ -27,7 +27,7 @@ disable-model-invocation: false
 
 ## ⚙️ 配置与自定义模板
 
-**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（DISK/FORMATS/DIR/OPEN_HTML/THEME/TEMPLATE/ROLE/CONFIRM/CONFIG_VERSION/DATA_SOURCES）与自定义模板都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（DISK/FORMATS/DIR/OPEN_HTML/THEME/TEMPLATE/ROLE/CONFIRM/CONFIG_VERSION/DATA_SOURCES）与自定义模板都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.upstream.md` 对照文件，可按需手动合并新配置点。
 
 - **THEME**：html 页面主题，tech 深蓝科技（默认）/ biz 浅色商务 / mono IDEA 黑亮 / light IDEA 白亮 / warm 温暖渐变；生成时写 `<html data-theme="THEME值">` 定默认，页面右下角换肤坞随点随换（localStorage 记忆（键按页内嵌唯一 ID 隔离、多份产物互不串台、改名/移动目录记忆不丢（生成时头部写 `<meta name="annual-id" content="<UUID>">`，每次 crypto.randomUUID() 生成标准 UUID v4（8-4-4-4-12 十六进制，禁止手写变体、禁止沿用占位与旧值）；落盘写文件前顺扫落盘目录下本技能命名的 html，读各文件 id meta 查重，撞号重掷至不重复））、?shot 截图模式与打印隐藏）
 - **DATA_SOURCES 意图路由**：用户说「把这些 git 地址 / 目录配置到这个 skill」「数据源加一下」「以后数据从 XX 仓库取」→ 默认指配置到 `user-config.md` 的 `DATA_SOURCES` 数据源清单（不是 SKILL.md、不是 disk-and-html.md）；「git 地址」给的是 URL 或本地仓库路径、目录给的是本地路径都写进 DATA_SOURCES。用户话术只指向某个特定数据源（如「只算这个仓库」）→ 当次生效，不写配置。意图仍有歧义（如分不清「数据收集配置」与「落盘目录配置」）→ 一句话与用户确认后写入，不猜
@@ -36,7 +36,7 @@ disable-model-invocation: false
 
 本 skill 当前配置版本为 `3`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明的当前版本不一致：
 
-1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
+1. 先将旧 user-config.md 备份为 `user-config.bak-<时间戳>.md`（同目录，绝不删除旧值）
 2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
 3. 更新 CONFIG_VERSION 为当前版本
 4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」
@@ -53,7 +53,7 @@ disable-model-invocation: false
 
 ## 产物升级（回炉）
 
-生成 HTML 时头部写版本戳 `<meta name="sf-template" content="annual-report@2">`（模板升级时递增 @N 并同步 reference.html 与本文档）。用户说「升级旧产物/回炉旧页面/旧年报换新样式」时：扫落盘目录下本技能命名的 html，读版本戳筛出旧版（无版本戳或缺少 `<meta name="annual-id">` 稳定 ID 的产物视为 v0 最旧版，一并进清单） → 列清单（文件/旧版本/手改状态——旧 html 正文与同目录 md 正文对比，不一致视为可能手改过）→ AskUserQuestion 选全部或部分 → 逐份升级：浅升级（仅 CSS/JS 变化）对旧页替换 `<style>` 块与交互脚本、正文内容原样保留；深升级（DOM 结构变化）从同目录 md 底稿按当前 reference.html 重建，先备份旧版 `.bak-时间戳` → 报告三段式：✅ 已升级清单 / ⚠️ 手改保留说明 / 🟡 失败项原因。模板改动分级：业务改动（板块/段落/标题体系）、数据格式改动（字段/存储结构）、页面改动（样式/布局/交互）任一发生即模板升级，版本戳 +1 并同步 reference.html 与本文档；纯措辞润色不 bump。每次生成 HTML 时顺扫落盘目录读版本戳：发现旧版产物主动告知「技能模板已升级至 vN，检测到 X 份旧版年报（vN-1 或无版本戳的历史产物），说『把我旧年报都升级成新样式』即可一键升级」，不让用户背触发语。
+生成 HTML 时头部写版本戳 `<meta name="sf-template" content="annual-report@3">`（模板升级时递增 @N 并同步 reference.html 与本文档）。用户说「升级旧产物/回炉旧页面/旧年报换新样式」时：扫落盘目录下本技能命名的 html，读版本戳筛出旧版（无版本戳或缺少 `<meta name="annual-id">` 稳定 ID 的产物视为 v0 最旧版，一并进清单） → 列清单（文件/旧版本/手改状态——旧 html 正文与同目录 md 正文对比，不一致视为可能手改过）→ AskUserQuestion 选全部或部分 → 逐份升级：浅升级（仅 CSS/JS 变化）对旧页替换 `<style>` 块与交互脚本、正文内容原样保留；深升级（DOM 结构变化）从同目录 md 底稿按当前 reference.html 重建，先备份旧版 `.bak-时间戳` → 报告三段式：✅ 已升级清单 / ⚠️ 手改保留说明 / 🟡 失败项原因。模板改动分级：业务改动（板块/段落/标题体系）、数据格式改动（字段/存储结构）、页面改动（样式/布局/交互）任一发生即模板升级，版本戳 +1 并同步 reference.html 与本文档；纯措辞润色不 bump。每次生成 HTML 时顺扫落盘目录读版本戳：发现旧版产物主动告知「技能模板已升级至 vN，检测到 X 份旧版年报（vN-1 或无版本戳的历史产物），说『把我旧年报都升级成新样式』即可一键升级」，不让用户背触发语。
 
 ## 🔧 报修处理流程（用户报页面问题时）
 
@@ -72,3 +72,13 @@ disable-model-invocation: false
 - 行业术语/指标/里程碑主题/风险话术/标题按 `resources/industry-dictionary.md` 职业词典取词（未提职业按 ROLE 画像；标题 = 年份前缀 + 词典「标题」变量，如「2026 研发年度总结」）
 - 页面主题五选一（tech 深蓝科技默认 / biz 浅色商务 / mono IDEA 黑亮 / light IDEA 白亮 / warm 温暖渐变）：THEME 配置定默认，右下角换肤坞随点随换
 - 完整规则（聚合来源 / 纯文字模式 / 写作风格约束 / 使用提示）见 `resources/content-rules.md`
+
+
+---
+
+## 🔍 SkillForge 使用指引（整体咨询时触发）
+
+当用户询问 **SkillForge 本身**（不是单个技能用法）——「skillforge 怎么用 / 使用说明 / 使用指引 / 是什么」「技能怎么安装 / 怎么升级 / 装了哪些技能 / 技能清单」「skill-forge ls / init / update 等命令怎么用」「技能安装器 / 技能锻造坊」等（中英文、近似说法均可，关键词可自由扩展）：
+1. Read 同目录 `resources/skillforge-guide.txt` 全文，按其内容整理回答（命令与参数以 txt 为准，勿自行编造）
+2. 用系统命令打开同目录 `resources/skillforge-guide.html`（macOS `open`，Windows `start`），让用户在浏览器看排版版
+3. 用户只问单个技能怎么用时（如「日报怎么用」）不触发本指引，走本技能的使用说明

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

@@ -7,6 +7,7 @@
 - FORMATS 默认 [md, txt, html, content-png]：md/txt/html 文件名 `annual-report-YYYY.<格式>`、截图 `annual-report-YYYY-content.png`；txt 为纯文本版；DISK: false 时全部不落盘
 - 目录：`{DIR}/annual-YYYY/`（DIR 按系统取 DIR_MAC/DIR_WIN，不存在回退用户主目录下 reports）；目录已存在直接复用，只覆盖本清单内同名文件；目录内存在非本 skill 命名的其它文件时对话中提示用户「该目录内已有其它文件，本次年度总结已与它们并列存放，未做任何改动」
 - 对话中照常输出 md 正文（不受 FORMATS 影响）；OPEN_HTML: true 且落盘了 html 时自动打开浏览器（macOS：open <html文件>；Windows PowerShell：Start-Process <html文件>）
+- 落盘完成后，对话回复必须向用户报告落盘位置：列出实际写入的目录完整路径与文件清单（如「已落盘到 ~/reports/annual-2026/：annual-report-2026.md、.txt、.html、annual-report-2026-content.png」），并注明 html 是否已在浏览器打开、截图是否跳过（Chrome/Edge 都不存在时）；DISK=false 或未落盘时注明「本次仅对话输出，未落盘」
 - FORMATS 含 content-png 时生成内容区截图：只截五张分节卡片整体（年度概览/核心成果与里程碑/经验与成长/不足与反思/新年展望与规划，不含头部标题区/复制按钮/页脚，四周保留对称合适的外边距约 40px 留白）；html 内置 `?shot=content` 参数（页面 JS 检测后隐藏 header-card/footer（复制按钮在头部卡内随卡一并隐藏）、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 + 概览节(标题45+数据卡~90+45) + 里程碑节(标题45+条目数×~65+40) + 成长节/反思节/展望节(各45+条目数×~70+40) + 各卡片 margin-bottom 18 + 余量~15，底部留白仅 body 下 padding 40px、与顶部对称），截图后用 Read 校验：五张卡片整体完整在图内、无头部/按钮/页脚残留、四周留白对称合适、不截断；底部留白过大减高度、截断加高度重截
 
 ## HTML 年度版式（深蓝面板体系，与日报/周报同源）

package/annual-report/resources/reference.html

@@ -3,7 +3,7 @@
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
-<meta name="sf-template" content="annual-report@2">
+<meta name="sf-template" content="annual-report@3">
 <meta name="annual-id" content="REF-ANNUAL-0000">
 <title>2026 研发年度总结</title>
 <style>
@@ -72,7 +72,7 @@
 *{margin:0;padding:0;box-sizing:border-box}
 html,body{background:var(--bg)}
 body{
-  font-family:ui-monospace,'SF Mono',SFMono-Regular,Menlo,Consolas,'PingFang SC','Microsoft YaHei',monospace;
+  font-family:ui-monospace,'SF Mono',SFMono-Regular,Menlo,Consolas,monospace;
   color:var(--text);-webkit-font-smoothing:antialiased;overflow-x:hidden;
 }
 /* 三层科技底纹 */
@@ -93,7 +93,7 @@ body{
   padding:34px 28px 26px;text-align:center;margin-bottom:18px;
   box-shadow:var(--card-shadow);
   background-image:repeating-linear-gradient(180deg, rgba(255,255,255,.012) 0 1px, transparent 1px 8px)}
-.header-card h1{font-size:26px;letter-spacing:2px;margin-bottom:8px;
+.header-card h1{font-size:26px;font-weight:900;letter-spacing:2px;margin-bottom:8px;
   background:var(--title-grad);-webkit-background-clip:text;background-clip:text;color:transparent;
   animation:titleGlow 3s ease-in-out infinite}
 @keyframes titleGlow{0%,100%{text-shadow:0 0 8px var(--glow),0 0 22px var(--glow-soft)}50%{text-shadow:0 0 14px var(--glow),0 0 34px var(--glow-soft)}}