skill-forge-hub 1.0.7 → 1.1.0

package/CHANGELOG.en.md

@@ -4,6 +4,15 @@
 
 Version history of the SkillForge npm package `skill-forge-hub` (command name `skill-forge`).
 
+## 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,15 @@
 
 SkillForge（技能锻造坊）npm 包 `skill-forge-hub`（命令名 `skill-forge`）版本变更记录。
 
+## 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 gradient title + quote + key-point blocks, one-screen vertical, print-friendly) + optional PNG capture, five themes switchable |
 | 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,8 @@ 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) |
 | [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 截图，五主题可切换 |
 | 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,8 @@ 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 公网地址（长期有效） |
 | [CHANGELOG.md](CHANGELOG.md) | 版本变更记录。英文版 [CHANGELOG.en.md](CHANGELOG.en.md) |
 
 ## 许可证

package/annual-report/SKILL.md

@@ -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

@@ -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;
 }
 /* 三层科技底纹 */