skill-forge-hub 1.0.6 → 1.1.0

package/CHANGELOG.en.md

@@ -0,0 +1,203 @@
+# CHANGELOG
+
+[中文](CHANGELOG.md)
+
+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**
+
+- Docs Chinese/English split: README/docs/CHANGELOG switched from mixed bilingual to pure Chinese + pure English one-to-one mirrors (README.en.md, docs/install.en.md, docs/architecture.en.md, CHANGELOG.en.md — full translation 0.1.0→1.0.6), cross-linked at the top of every document; architecture mechanism table four → eight (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, aligned with the forge-rules numbering); both READMEs drop the outdated "config stays in SKILL.md" wording — config moves out to user-config.md; package.json files gains README.en.md and CHANGELOG.en.md
+- meta-forge lessons fully codified: ① repo registration checklist gains package.json files — the 1.0.5 exam③ lesson (monthly-report/meeting-minutes/quarterly-report missing from the npm package) is now a rule, verified with `npm pack --dry-run` after registration; ② validation ring gains the self-heal double check — static gate A-14 (embedded JS validates the id meta, heals via the path key and writes back, console.warn alert) + runtime test B-5 (break the id meta → reopen heals to a valid v4 + memories recovered via the path key), so mechanism 6's page-level self-healing is now backed by validation; SKILL.md description / flow steps 4-5 / usage-guide / README both languages synced
+
+## 1.0.6 (2026-11-12)
+
+**meta-forge spec & template alignment: three real-world lessons codified + template modernization**
+
+- template/ aligned with the new forge-rules spec: SKILL.md rewritten (step 0 reads user-config, config-version mechanism section, output-reforge section (conditional), doc-sync self-check section, pre-delivery self-check hard gate); new template/user-config.md (CONFIG_VERSION: 1 + protection declaration) and template/resources/usage-guide.md (usage-answer template); README drops the outdated "config must stay in SKILL.md" sentence — config now moves out
+- forge-rules mechanism 3 gains the entry-animation fallback: reference.html with scroll-entry animations (IntersectionObserver + JS gating) must carry a 2s fallback setTimeout that forces everything visible — in environments where IO never fires (headless capture / print preview / PDF export / embedded webviews), cards must never stay permanently hidden (the meeting-minutes 1.0.5 blank-screenshot lesson, codified)
+- forge-rules mechanism 6 gains page-level self-healing: when the id meta is invalid/missing, heal it to a standard UUID v4 via a path key (sf-heal: + pathname) and write it back to the meta, with a console.warn alert — the third line of defense at the execution layer, codified
+- forge-rules mechanism 8 gains user-data specifics: deep-upgrade rebuilds must keep the page's original stable ID meta value (a new ID = data loss), data files are never touched
+- validation ring expanded: static gates gain item 13 (entry-animation fallback check); runtime tests gain item 4 (headless capture proves content complete — a blank capture fails)
+- meta-forge self-alignment: SKILL.md description / flow step 3 / rules summary gain the preserve list and mechanism conditions (HTML gains mechanisms 3-7-8, localStorage memory gains 6, semi-custom assets gain 5); usage-guide mechanism list aligned to the eight forge-rules numbers; user-config.md fixes the newline bug where the CONFIG_VERSION end-of-line comment swallowed the DIR line
+
+## 1.0.5 (2026-11-12)
+
+**monthly-report joins the forge: four-way report-family disambiguation + deck-stage monthly mapping**
+
+- New monthly-report skill: four-section monthly report (monthly overview / key achievements / problems & improvements / next month's plan), differentiated assets — data cards with QoQ subtext (vs last month ±x%, green up red down), W1-W4 week timeline, monthly calendar heatmap (echarts calendar heatmap, CSS-variable-driven five-theme skinning); data collection supports monthly git aggregation + same-caliber last-month comparison + daily heatmap statistics; natural-language month targeting (this month / last month / last 30 days / 2026-10); isomorphic with the three report skills: 12-industry dictionary, custom templates, five-theme deep-blue panel, content-png captures
+- Disambiguation upgrade: daily/weekly/annual SKILL.md cycle-ambiguity routing three-way → four-way (daily / weekly / monthly / annual)
+- deck-stage linkage: report four-piece mapping gains the monthly segment (overview→overview, achievements→timeline W1-W4, problems/plan→bullets, calendar heatmap→chart-heatmap); usage-guide examples gain monthly
+- CLI & docs: cli.js CATEGORIES report showcase includes monthly-report; README category row / skill table / install command synced
+- Real-device: monthly reference.html headless rendering of the four section cards + calendar heatmap + skin dock all pass; content-capture height formula calibrated on real captures (~2020px at 760px width baseline + linear item scaling), fixing the old formula's underestimation truncation
+
+**Minutes-series grouping + article save governance + ID uniqueness hardening + four exam fixes + bilingual docs**
+
+- Minutes-series grouping: meeting-minutes gains SERIES_GROUP three-state (auto extracts series names into meetings/{series}/, series always uses series dirs, off flat months); series-name extraction rules + illegal-character dir-name cleaning + rename mechanism ("call this series XX" applies now / "always call this series XX" persists) + one-shot organizing command (scan all old minutes → move-plan confirmation → three-part report, empty month dirs kept); CONFIG_VERSION 1→2
+- article-to-html save governance: captures isolated per article as 文章截图/<title-slug>/C00-cover.png (the redundant "chapter captures" layer removed, same-name articles across different docs no longer overwrite each other); DIR configurable (DIR: auto + DIR_MAC default ~/articles + DIR_WIN, nonexistent dir falls back to the user home); same-name different-article slugs append -2/-3; CONFIG_VERSION 1→2
+- ID uniqueness, two hardenings: ① format locked — crypto.randomUUID() standard UUID v4 (8-4-4-4-12 lowercase hex), handwritten variants / reusing placeholders or old values forbidden; ② pre-write collision check — before writing a file, scan the save directory for this skill's html files and read their id metas, re-roll on collision. Three lines of defense: generation rules in 8 SKILL.mds + the "format self-heal block" in 9 reference.html files (invalid/missing meta heals to a valid v4 via a path key, stable reuse across opens on the same path, console.warn alert) + meta-forge forge-rules mechanism sentence & validation ring; Playwright 9/9 real-device pass
+- Four exam fixes: ① quarterly-report user-config CONFIG_VERSION 1→3 (content was already v3-shaped, the version number was never bumped); ② prompt-pouch gains the sf-template@2 version stamp + the SKILL.md "output upgrade (reforge)" section (deep-upgrade rebuilds must keep the original page pouch-id — IndexedDB user data is namespaced by pouch-id, a new ID = data loss; prompts.json data files never touched); ③ package.json files gains monthly-report/meeting-minutes/quarterly-report (the npm package was missing these three skills); ④ meeting-minutes gains the 2s entry-animation fallback setTimeout (environments where IntersectionObserver never fires — headless capture / print preview — suffered permanently hidden cards; aligned with the rest of the report family) + version stamp @2→@3
+- Bilingual docs rework: README rebuilt as a full bilingual mirror + new "output gallery" (6 real screenshots of skill outputs, richly illustrated); split out docs/install.md (both install methods / command reference / upgrade & config-protection mechanics in depth) + docs/architecture.md (directory layout / skill anatomy / four mechanisms / splitting conventions), all Chinese-English mirrored
+
+## 1.0.4 (2026-11-11)
+
+**Charts echarts-ized + data sources generalized + upgrade mechanism strengthened**
+
+- Charts echarts-ized: the weekly/annual four chart types (monthly commit bars / daily commit bars / ring chart / heatmap) switched to CDN echarts rendering (jsdelivr 5.5.1) — five-theme linked skinning, animations stopped in shot capture mode, offline auto-degradation notice (.ech-off hint); fixed the weekly overview DOM nesting (ov-bento nine-child structure restored) and ring center text overflow
+- Data sources generalized: the three reports gain a DATA_SOURCES source list (git repo aggregation / file directory / remote source, three type examples, mac/win dual fields); default templates no longer show real machine paths (~/reports, %USERPROFILE%\reports generic path templates); CONFIG_VERSION 2→3; deck-stage/prompt-pouch template values generalized too; zero real addresses left anywhere in the repo
+- Upgrade mechanism strengthened: ① new .installed-manifest install list — upgrades only clean files the manifest shows the official version deleted, plus now-empty directories; user-created files are never touched (older installs without a manifest skip cleanup and get it written after upgrade); ② article-to-html embeds the .preserve list (design-system.md never overwritten, official updates saved as .upstream companions); ③ meta-forge mechanism 5 — conditional .preserve list embedding spec + validation-list item 4b
+- Verified: upgrade-mechanism three-scenario real-device test, 12 assertions all pass (old-version-no-manifest upgrade / official-file-deletion precise cleanup / user-created & customized file protection)
+
+## 1.0.3 (2026-11-11)
+
+**Narrow-screen responsive adaptation + default chart animations**
+
+- Narrow-screen: the three reports converge at <680px breakpoints (wrap full-width flow, tightened margins, unified 26px h1, clamp 640px floor — no more horizontal overflow); annual monthly-commit chart 12 columns flex-shrink + tip layer first/last column anchoring; weekly daily-commit chart tip long-text wrap width limit; cover page <1280px viewport proportional zoom preview (calc division length÷length type-correct; captures use headless 1280×720, unaffected)
+- Default chart animations: annual monthly-commit bars gain cbGrow growth animation (aligned with weekly); weekly ring chart gains ringSweep sweep stroke (--ring-offset data-driven, animation stops exactly at the target); weekly heatmap gains hmOn staggered lighting (morning/afternoon/evening three batches)
+- Verified: nine viewports (1920→390) zero overflow; cover right edge pixel-precise per viewport; animation timing sampled + mid-state captures accepted; zero pageerrors
+
+## 1.0.2 (2026-11-11)
+
+**Three reports scroll-entry: off-screen cards float in as they scroll into view**
+
+- Scroll-entry: cards initially outside the viewport float up and fade in as they scroll into view (first-screen cards keep the staggered load animation; IntersectionObserver + html.js gating, always fully visible in no-JS / print / capture modes)
+- translate as an independent property, not touching transform — zero conflict with hover 3D tilt; transition-delay cleared after entry so hover stays snappy; stagger 70ms capped at 280ms; 2s fallback force-show
+
+## 1.0.1 (2026-11-11)
+
+**Post-release triple fix: three reports mono ambience reskin + prompt-pouch four-layer tech ambience + daily/weekly noise fade-out**
+
+- Daily/weekly/annual mono ambience reskin: stripes retained in the black theme, colors de-saturated — star dots become neutral gray-white, grid/scan-line/light-band follow --scan-dim using IDEA text-color low-opacity gray-white, body solid #1e1f22 no longer polluted by the blue ambience (previously bluish (38,45,60); after reskin the pure background recovers pixel-perfect (30,31,34), stripe rows gray-white neutral); tech/biz/light/warm ambience unchanged
+- Daily/weekly mono noise layer fade-out: body::before grayscale grain hidden in mono (annual/pouch never had noise), pure background pixel-identical with annual; colored themes keep the noise
+- Prompt-pouch gains four-layer tech ambience: grid/stars/scan-line/light-band from the same source as the three reports (opacity one half-step lighter so reading stays comfortable), cards gain 8px fine horizontal stripes, mono reskinned gray-white
+
+## 1.0.0 (2026-11-11)
+
+**1.0.0 official release**: through a dozen versions from 0.1.x to 0.5.x, nine skills + the upgrade-protection CLI + the five-theme system are all stable — officially promoted. This release closes three big changes: whole-forge exam with three fixes, CLI init/update mechanism review & repair, prompt-pouch continued forging (two-stage confirmation / full tag interactions / emoji panel / dialog enlargement / background renaming).
+
+**Whole-forge exam, three fixes: intent routing + usage guidance + three prompt-pouch features**
+
+- Intent routing ①: magic-deck (HTML web slides) and deck-stage (.pptx editable files) gain an "intent boundary" section — when "make a PPT" doesn't specify the form, AskUserQuestion two-way choice, no more two-skill collision; also fixed the magic-deck description's stale "sixteen themes" → "seventeen"
+- Intent routing ②: daily/weekly/annual gain "0.5 cycle-ambiguity routing" — "write a summary / work summary" without a stated cycle triggers an AskUserQuestion three-way choice, never silently defaults
+- Intent routing ③: spec-doc2spec / spec-spec2doc descriptions gain usage-query trigger words (asking "how to use / usage" routes to the usage-guide answer instead of missing the trigger)
+- Usage guidance: article-to-html's usage instructions extracted from SKILL.md into a standalone resources/usage-guide.md ("Article Mounting Master Usage Guide"), aligned with the other 8 forge skills
+- Three prompt-pouch features: ① import/export — top-bar "⤓ export" downloads a full JSON backup (timestamped), "⤒ import" picks a file for whole-library overwrite (auto-backup before import for rollback, import disabled in unauthorized directories); ② tag click filtering — clicking a card tag filters by that tag (top-bar pill shows the current tag, click ✕ or re-click the same tag to cancel, switching groups auto-clears, stacks with search); ③ group sidebar drag sorting — dragging group bars reorders the groups list (authorized directories write through immediately; unauthorized ones produce a "reorder groups to…" instruction for the AI to save)
+
+**CLI init/update mechanism review & repair**
+
+- Copy excludes impurities: copyDir skips .DS_Store/.git and other metadata files, no longer copied into user directories with skills
+- Upgrade structure sync: new pruneDir — cleans files the official version deleted (and empty directories) before upgrade (historically grow-only stale files no longer linger); user-config.md, .preserve list files, .upstream companions, .bak- backups, node_modules dependencies are all left untouched
+- Three-way [3] differentiation: [3] decide later no longer generates a .upstream companion (truly distinct from [2] keep mine); when the config content matches the official version, old .upstream companions are auto-cleaned
+- deck-stage gains the "config version mechanism (upgrade protection)" section (current required version 2), aligned with the rest of the forge; the whole-repo "four themes" wording unified to five themes (including light IDEA white)
+- prompt-pouch mechanism section gains an explicit "current required version is 4" declaration
+- README upgrade-protection notes synced (three-way [3] semantics + new "structure sync" item)
+
+**Prompt-pouch continued forging: batch-organize two-stage confirmation + full tag interactions + emoji quick panel**
+
+- Batch-organize upgraded to two-stage confirmation: stage one settles entries (default AI smart tagging — each entry auto-fitted with 1-3 semantic tags, user-editable & deletable + interpolation generalization suggestions) → stage two settles groups (grouping rationale + recommended new group names); few entries (≤3) merge both stages
+- Full tag interactions: card tag hover shows "✕" to delete a single tag, tags under 3 hover shows "+" to quickly add (authorized directories write through immediately, unauthorized produce instructions for the AI); closes the loop with the existing click-to-filter and edit-form tag editing
+- Group dialog emoji quick panel: 95 common emoji preset grid under the icon input (9 columns scrollable, click to fill, current selection highlighted), the input keeps manual typing / pasting any character
+- Group dialog enlargement: width 460→640px, emoji panel font 17→28px, larger grid spacing, taller view (96→200px multi-row), more comfortable
+- mono/light body background renaming: body's three-layer composite background (top glow + grid lines + 160° gradient) becomes theme solid colors — mono solid #1e1f22, light solid #ffffff, removing the "gray-top black-bottom" gradient seam, consistent with the IDE editor area (tech/mint keep their ambience backgrounds)
+
+## 0.5.5 (2026-11-11)
+
+**Whole-forge theme reskin: IDEA dark + new IDEA light**
+
+- mono "black" theme upgraded to IDEA dark (JetBrains New UI Dark official palette): editor/body #1e1f22 + panel/dialog #2b2d30 + border #3c3f41 + text #dfe1e5 + IDEA blue #3574f0, fixing the previous old Darcula palette (#2b2b2b family) mismatch with the IDE look
+- New light "white" theme (IntelliJ Light official palette): white editor #ffffff + light-gray panels #f2f2f2 + border #d1d1d1 + IDEA blue #2675bf
+- Coverage: prompt-pouch (4→5 themes), daily/weekly/annual (4→5), magic-deck (16→17), deck-stage (4→5); skin dock / theme arrays / doc lists all synced
+- article-to-html excluded: its A-set four themes are an "accent color" system, not light/dark semantics; D terminal-geek (black) and C minimal-white (white) are already covered by style variants
+
+## 0.5.4 (2026-11-11)
+
+**Prompt-pouch interaction polish (SKILL.md)**
+
+- Intent recognition & confirmation: explicit pouch-entry trigger phrases (put this passage / this conversation / this file into the pouch, etc.); vague intent ("save this") confirms first; ordinary chat never triggers file operations
+- Existing page three-branch: when creating and the directory already has a page → open existing (recommended) / overwrite rebuild (old page backed up .bak, data dir untouched) / cancel
+- Save confirmation: show the content to be written and wait for user confirmation before writing back ("save directly" skips); group smart matching (semantically matches existing groups and explains why)
+- Interpolation generalization suggestions: on add/organize, detect generalizable concrete words, suggest turning them into {variables} (with rewrite examples and reuse effects), only change with user confirmation
+
+## 0.5.3 (2026-11-11)
+
+**Prompt-pouch data directory rename: cache/ → data/**
+
+- DATA_DIR default `cache` → `data` (semantic rename: the directory holds full data, not cache; "cache" semantics reserved for future true process caches); CONFIG_VERSION v3 → v4
+- Page read-side three-tier fallback: `data/prompts.json` → old default `cache/prompts.json` → root-level old flat files; write side always writes `data/`; page copy all synced
+- Upgrade migration: when the AI finds a v3 old-default cache/ dir → back up, rename-migrate to data/ and inform the user (explicitly customized directory names are respected and left alone)
+
+## 0.5.2 (2026-11-11)
+
+**Prompt-pouch mono theme reskin to JetBrains Darcula**
+
+- From "Linear-style pure black" to the Darcula official palette: background `#2b2b2b` / panel `#3c3f41` / card gradient `#313335` / body blue-gray `#a9b7c6` / border `#4e5254` — dark-gray base + blue-gray text + gray-scale panels, consistent with the JetBrains IDE look, easy on the eyes for long sessions
+- Components fully blue-gray adapted: wand/icon filters, tags, stars, popovers, input area, card inner borders and hover borders, skin-dock color dots
+- Theme names synced: "minimal black-white" → "Darcula dark gray-blue" (SKILL.md / user-config.md / usage-guide.md / skin-dock titles)
+
+## 0.5.1 (2026-11-11)
+
+**Self-check loop completed** (hard gates before delivery, all four skills covered)
+
+- magic-deck: SKILL.md gains "2.5 pre-delivery self-check" (Playwright zero errors + flip through every page + first/middle/last three-page capture self-inspection); new resources/content-guide.md content adaptation manual (content temperament → layout / domain → template packs / page pacing / chart selection)
+- Prompt-pouch: SKILL.md gains "2.5 pre-delivery self-check" (json machine validation + zero page errors + card count equals data count)
+- deck-stage: step 5 validation strengthened into the "pre-delivery self-check" hard gate (slide XML count matches pages, no empty pages)
+- template: new-skill template gains a "3.5 pre-delivery self-check" placeholder (pick check methods by skill type)
+
+## 0.5.0 (2026-11-11)
+
+**New**
+
+- **deck-stage joins the forge**: 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 reports (tech/biz/mono/warm four themes)
+- magic-deck "💼 domain" tab gains 21 template packs (six categories, one-click full deck generation, two-stage confirmation with undo)
+- magic-deck gains resources/usage-guide.md (usage-answer source), hooked at SKILL.md step 4
+
+**Improvements**
+
+- Prompt-pouch time fields precise to the second (cards / detail timeline / AI copy)
+- Prompt-pouch default save structure: data & backups subdirectorized (`cache/prompts.json` + `backup/` rolling backups), `DATA_DIR` / `BACKUP_DIR` configurable, old flat structure still readable
+- Prompt-pouch sidebar partial scrolling (favorites + groups scroll when groups are many; "all" / new group / usage stay fixed) + wider dialog + backup-area buttons no wrap
+- magic-deck template panel dialog widened; "profession" wording unified to "domain" (more general, fits six categories)
+- CLI: init/update run dependency detection for skills with a package.json (prompts npm install when node_modules missing)
+- README rewritten: full command reference (complete flag tables), deck-stage registered, directory layout fully updated, stale copy fixed
+
+**Fixes**
+
+- **npm package content omission**: 0.4.0's `files` list missed prompt-pouch (the package had no pouch), fixed and deck-stage added
+
+## 0.4.0 (2026-11-10)
+
+- magic-deck template runtime switching: toolbar "🎨 templates" panel five layouts click-to-apply (all pages / this page only / checked pages), titles auto-mapped, switching back to classic business restores without losing content
+- Prompt-pouch time fields: createdAt / updatedAt saved and displayed
+- Report skills' outward wording de-git-ified: multi-source data reworded as a paragraph / file descriptions / images / verbal additions, fitting all industries
+- Prompt-pouch default save directory migrated to MyWork/prompt-pouch (html/json/backups collected in one directory)
+
+## 0.3.0 (2026-11-09)
+
+- magic-deck magic slide deck joins the forge (16:9 stage + playback engine + templates & themes + page-select captures + fullscreen presentation)
+- meta-forge meta-smithy joins the forge (the skill that forges skills, four mechanisms self-referential)
+- Three-piece mechanism backfill: CONFIG_VERSION key, reference dual-track, self-check discipline
+- spec-doc2spec / spec-spec2doc fully detached from Speccore, reborn as standalone Pandoc-centric skills (detection & install guidance + AI proofreading loop), config extracted to user-config
+- Three-piece professional reporting conventions (conclusion-first, risk four-ring, value translation) + HTML effect layer upgrade
+
+## 0.2.0 (2026-11-08)
+
+- New annual-report skill (five sections, industry-agnostic skeleton)
+- Upgrade protection: user-config.md config extraction + copyDir preserve list + .preserve list
+- Daily & weekly whole-page content-area captures + meteor progress-bar particle polish
+- spec-doc2spec / spec-spec2doc advanced upgrade with resources volumes
+
+## 0.1.0 (2026-11-06)
+
+- First npm release: `skill-forge-hub` (command name `skill-forge`), zero-dependency Node>=14
+- CLI: ls list / init interactive multi-select install (auto-detects common AI assistant skill directories, supports --target/--skills)
+- Skills included: daily-report, weekly-report, article-to-html, spec-doc2spec, spec-spec2doc

package/CHANGELOG.md

@@ -1,7 +1,25 @@
 # CHANGELOG
 
+[English](CHANGELOG.en.md)
+
 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 坑教训全量入规**
+
+- 文档中英分离：README/docs/CHANGELOG 由中英混排改为纯中文 + 纯英文一一对应（README.en.md、docs/install.en.md、docs/architecture.en.md、CHANGELOG.en.md，全量英译 0.1.0→1.0.6），每份文档顶部互相链接切换；architecture 机制表四大 → 八大（CONFIG_VERSION 钥匙 / user-config 抽离 / reference 双轨 / 自检纪律 / preserve 保护清单 / 多文件隔离 / 零侵权脱敏离线 / 产物升级回炉，与 forge-rules 编号对齐）；README 两版「配置留在 SKILL.md」旧表述改为配置出站 user-config.md；package.json files 补 README.en.md 与 CHANGELOG.en.md
+- meta-forge 坑教训入规补全：①仓库登记清单补 package.json files——1.0.5 体检③教训（漏 monthly-report/meeting-minutes/quarterly-report 三技能，装包却无技能）正式入规，登记后跑 `npm pack --dry-run` 验证；②验证环补自愈块双检查——静态门禁 A-14（HTML 内嵌 JS 含 id meta 校验 + 路径键自愈回写 + console.warn 报警）+ 运行时实测 B-5（改坏 id meta → 重开自愈为合法 v4 + 记忆经路径键恢复），机制六执行层自愈从此有验证兜底；SKILL.md description/流程第 4-5 步/usage-guide/README 中英文同步
+
 ## 1.0.6（2026-11-12）
 
 **meta-forge 规范与模板对齐：三大实战教训入规 + template 模板现代化**

package/README.en.md

@@ -0,0 +1,110 @@
+# SkillForge · Skill Smithy
+
+[中文](README.md)
+
+> A workshop that gathers "AI craft" in one place — forging day-in, day-out repetitive labor into handy tools summonable by a single sentence. Every skill in the forge is a set of crafting instructions written for AI: one natural-language phrase calls it up, and it produces standardized output following a fixed procedure. The craft is host-agnostic — swap a thin frontmatter envelope and the same skill travels from one AI assistant to another.
+
+Every skill enters through SKILL.md — the frontmatter, the generation flow, and the config pointer (user-editable config lives in user-config.md, read before every run) stay at the entry, while heavy content is split into resources/ by generation stage (or flat helper files such as design-system.md and scripts/). The AI reads each part only when it reaches that stage, keeping the resident context footprint small.
+
+## Output Gallery
+
+All of the following are real screenshots of actual output produced by these skills.
+
+<table>
+<tr>
+<td align="center" width="50%">
+  <img src="docs/images/daily-report.png" alt="Daily report output page" width="100%"/><br/>
+  <sub>Daily report output page (task progress / tomorrow's plan / risks & blockers, three-section cards)</sub>
+</td>
+<td align="center" width="50%">
+  <img src="docs/images/meeting-minutes.png" alt="Meeting minutes output page" width="100%"/><br/>
+  <sub>Meeting minutes output page (meeting info / conclusions / agenda / action items, five-section cards)</sub>
+</td>
+</tr>
+<tr>
+<td align="center" width="50%">
+  <img src="docs/images/article-to-html.png" alt="Article mounting output page" width="100%"/><br/>
+  <sub>Article mounting output page (dark cover + componentized body, charts redrawn as vectors)</sub>
+</td>
+<td align="center" width="50%">
+  <img src="docs/images/magic-deck.png" alt="Magic slide deck cover" width="100%"/><br/>
+  <sub>Magic slide deck cover (16:9 stage, presentation + templates + themes)</sub>
+</td>
+</tr>
+<tr>
+<td align="center" width="50%">
+  <img src="docs/images/deck-stage.png" alt="Deck-stage PPTX cover page" width="100%"/><br/>
+  <sub>Deck-stage PPTX cover page (lossless HTML capture, natively editable pages)</sub>
+</td>
+<td align="center" width="50%">
+  <img src="docs/images/prompt-pouch.png" alt="Prompt pouch management console" width="100%"/><br/>
+  <sub>Prompt pouch management console (groups / search / favorites / tags / import & export)</sub>
+</td>
+</tr>
+</table>
+
+## Skill Categories
+
+Skills are grouped by "what they ultimately produce" — one skill belongs to exactly one category. Categories exist only for repository organization and navigation; installation always copies skills flat into the target AI assistant's skill directory, regardless of category.
+
+| 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) 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 / 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
+
+| Skill | Category | Directory | Description |
+|:---|:---|:---|:---|
+| daily-report | Report showcase | [daily-report/](daily-report/) | Multi-source daily reports (today's task progress / tomorrow's plan / risks & blockers): a paragraph, descriptions in files, images, or verbal additions all work; natural-language dates (today / yesterday / last Wednesday / Oct 20); consecutive multi-day batch; custom templates; 12-industry dictionary |
+| 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); 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
+
+```bash
+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)
+```
+
+After installation, just say "write a daily report", "write a weekly report", "write a monthly report", "write a quarterly report", "write an annual report", "take meeting minutes", or hand it a document to trigger a skill; asking "how do I use daily-report / meeting-minutes / deck-stage" prints the usage guide.
+
+## Documentation
+
+| Document | Content |
+|:---|:---|
+| [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
+
+[MIT](LICENSE)

package/README.md

@@ -1,105 +1,110 @@
 # SkillForge · 技能锻造坊
 
-> 一处集中收纳「AI 手艺」的工坊——把日复一日的重复劳作，锻造成一句指令就能完成的顺手工具。坊中每一件技能都是一份写给 AI 的手艺说明，一句自然语言即可唤起，按既定工序产出标准化成果；手艺与宿主无关——换一份薄薄的 frontmatter 信封，就能从一位 AI 助手带去另一位。
-
-**SkillForge** is a curated collection of AI craft skills — repetitive daily work, forged into tools that answer with a single command. Each skill is a set of craft instructions written for the AI: one natural-language request sets it in motion, and a polished, standardized deliverable comes out the other end. The craft is host-agnostic — a thin frontmatter envelope is all it takes to carry it from one AI assistant to another.
+[English](README.en.md)
 
-所有技能均以 SKILL.md 为入口——frontmatter、生成流程、用户可改配置留在入口，重内容按生成阶段拆到 resources/ 或平铺辅助文件（如 design-system.md、scripts/），AI 执行到对应阶段才读取，降低常驻上下文占用。
+> 一处集中收纳「AI 手艺」的工坊——把日复一日的重复劳作，锻造成一句指令就能完成的顺手工具。坊中每一件技能都是一份写给 AI 的手艺说明，一句自然语言即可唤起，按既定工序产出标准化成果；手艺与宿主无关——换一份薄薄的 frontmatter 信封，就能从一位 AI 助手带去另一位。
 
-Every skill enters through its SKILL.md — frontmatter, generation flow, and user-editable config stay at the entry; heavy content is split into resources/ (or flat helper files such as design-system.md, scripts/) and read only when the AI reaches that stage, keeping resident context small.
+所有技能均以 SKILL.md 为入口——frontmatter、生成流程、配置指引（用户可改配置出站在 user-config.md，执行前先读）留在入口，重内容按生成阶段拆到 resources/ 或平铺辅助文件（如 design-system.md、scripts/），AI 执行到对应阶段才读取，降低常驻上下文占用。
 
-## 产物画廊 · Output Gallery
+## 产物画廊
 
-以下均为各技能产出的真实成品截图。These are real screenshots of what each skill produces.
+以下均为各技能产出的真实成品截图。
 
 <table>
 <tr>
 <td align="center" width="50%">
-  <img src="docs/images/daily-report.png" alt="日报成品页 Daily report page" width="100%"/><br/>
-  <sub>日报成品页（任务进度 / 明日计划 / 风险阻塞三段卡）<br/>Daily report page — progress, plans, blockers</sub>
+  <img src="docs/images/daily-report.png" alt="日报成品页" width="100%"/><br/>
+  <sub>日报成品页（任务进度 / 明日计划 / 风险阻塞三段卡）</sub>
 </td>
 <td align="center" width="50%">
-  <img src="docs/images/meeting-minutes.png" alt="会议纪要成品页 Meeting minutes page" width="100%"/><br/>
-  <sub>会议纪要成品页（会议信息 / 结论 / 议题 / 行动项五段卡）<br/>Meeting minutes page — five-section cards with action items</sub>
+  <img src="docs/images/meeting-minutes.png" alt="会议纪要成品页" width="100%"/><br/>
+  <sub>会议纪要成品页（会议信息 / 结论 / 议题 / 行动项五段卡）</sub>
 </td>
 </tr>
 <tr>
 <td align="center" width="50%">
-  <img src="docs/images/article-to-html.png" alt="文档装裱成品页 Article-to-HTML page" width="100%"/><br/>
-  <sub>文档装裱成品页（暗色封面 + 组件化正文，图表矢量重绘）<br/>Article-to-HTML page — hero cover + component layout</sub>
+  <img src="docs/images/article-to-html.png" alt="文档装裱成品页" width="100%"/><br/>
+  <sub>文档装裱成品页（暗色封面 + 组件化正文，图表矢量重绘）</sub>
 </td>
 <td align="center" width="50%">
-  <img src="docs/images/magic-deck.png" alt="魔法幻灯封面 Magic-deck slide cover" width="100%"/><br/>
-  <sub>魔法幻灯封面（16:9 舞台，放映 + 模板 + 主题）<br/>Magic-deck slide cover — 16:9 stage, playback + templates + themes</sub>
+  <img src="docs/images/magic-deck.png" alt="魔法幻灯封面" width="100%"/><br/>
+  <sub>魔法幻灯封面（16:9 舞台，放映 + 模板 + 主题）</sub>
 </td>
 </tr>
 <tr>
 <td align="center" width="50%">
-  <img src="docs/images/deck-stage.png" alt="登台 PPTX 封面页 Deck-stage PPTX cover" width="100%"/><br/>
-  <sub>登台 PPTX 封面页（HTML 保真截图，原生可编辑页）<br/>Deck-stage PPTX cover — HTML-rendered, pages stay editable</sub>
+  <img src="docs/images/deck-stage.png" alt="登台 PPTX 封面页" width="100%"/><br/>
+  <sub>登台 PPTX 封面页（HTML 保真截图，原生可编辑页）</sub>
 </td>
 <td align="center" width="50%">
-  <img src="docs/images/prompt-pouch.png" alt="锦囊提示词管理台 Prompt pouch manager" width="100%"/><br/>
-  <sub>锦囊提示词管理台（分组 / 搜索 / 收藏 / 标签 / 导入导出）<br/>Prompt pouch manager — groups, search, favorites, tags, JSON backup</sub>
+  <img src="docs/images/prompt-pouch.png" alt="锦囊提示词管理台" width="100%"/><br/>
+  <sub>锦囊提示词管理台（分组 / 搜索 / 收藏 / 标签 / 导入导出）</sub>
 </td>
 </tr>
 </table>
 
-## 技能分类 · Categories
+## 技能分类
 
 按「技能最终产出什么」归类，一个技能只归一类；分类只用于本仓库组织与导航，安装时始终平铺复制到目标 AI 助手的技能目录，与分类无关。
 
-Skills are grouped by what they ultimately produce — one skill, one category. Categories only organize this repository; installation always copies skills flat into the target AI assistant's skill directory.
-
-| 分类 Category | 说明（中） Description | 收录技能 Skills |
+| 分类 | 说明 | 收录技能 |
 |:---|:---|:---|
-| 报表汇演<br>Reports | 多源数据整理（一段文字 / 文件里的描述 / 图片与素材 / 口头补充，什么材料都能成稿），按周期产出报告（日报 / 周报 / 月报 / 季报 / 年报）<br>Multi-source reports on a schedule — daily, weekly, monthly, quarterly, annual; any material (text, files, images, voice notes) can become a draft | daily-report、weekly-report、monthly-report、quarterly-report、annual-report |
-| 文档装裱<br>Documents | 文档转换与美化：Word / Markdown / 纯文本 → 精美 HTML + 逐章截图<br>Document conversion & beautification: Word / Markdown / plain text → polished HTML + per-chapter screenshots | article-to-html |
-| 工程提效<br>Engineering | 基于 Pandoc 的文档 ↔ 规格互转（需求文档切片 / 规格导出 Word·PDF），Pandoc 机械转换 + AI 校对防错<br>Pandoc-based document ↔ spec conversion (requirement slicing / spec export to Word·PDF), mechanical conversion plus AI proofreading | spec-doc2spec、spec-spec2doc |
-| 演示汇演<br>Slides | 从内容到演示：HTML 形态的魔法幻灯（放映 + 模板 + 主题）与 .pptx 登台文稿（原生可编辑页 + 封面截图）<br>From content to presentation: HTML magic slides (playback + templates + themes) and .pptx stage decks (editable pages + HTML cover) | magic-deck、deck-stage |
-| 数据整备<br>Data | Excel / CSV / 图表、数据清洗与模板整理（规划中）<br>Excel / CSV / charts, data cleaning & template tidying (planned) | （规划中 planned） |
-| 沟通协作<br>Communication | 会议纪要（行动项带负责人与截止时间，汇报链源头）与提示词管理（锦囊本地管理台）<br>Meeting minutes (action items with owners & deadlines, the source of the reporting chain) and prompt management (local pouch dashboard) | meeting-minutes、prompt-pouch |
-| 技能自造<br>Meta | 锻造技能本身的元技能（创建技能 / 插件）<br>Meta skills that forge skills themselves (create skill / plugin) | meta-forge |
+| 报表汇演 | 多源数据整理（一段文字 / 文件里的描述 / 图片与素材 / 口头补充，什么材料都能成稿），按周期产出报告（日报 / 周报 / 月报 / 季报 / 年报）与团队日报收集台 | 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 / JSON 清洗结构化（清洗项明示、每步留痕、概览报告）与 git 提交热力图 | data-prepper、commit-heatmap |
+| 沟通协作 | 会议纪要（行动项带负责人与截止时间，汇报链源头）、提示词管理（锦囊本地管理台）与决策日志 | meeting-minutes、prompt-pouch、decision-log |
+| 技能自造 | 锻造技能本身的元技能（创建技能 / 插件）与技能体检 | meta-forge、skill-doctor |
 
-## 技能清单 · Skill List
+## 技能清单
 
-| 技能 Skill | 分类 Category | 目录 Dir | 说明（中） Description |
+| 技能 | 分类 | 目录 | 说明 |
 |:---|:---|:---|:---|
-| daily-report | 报表汇演 Reports | [daily-report/](daily-report/) | 多源数据生成日报（今日任务进度/明日计划/风险阻塞点）：一段文字、文件里的描述、图片或口头补充皆可成稿；支持自然语言日期（今天/昨天/上周三/10月20号）、连续多日批量、自定义模板、12 行业词条<br>Daily reports (progress / plans / blockers) from any source; natural-language dates, batch multi-day runs, custom templates, 12-industry vocabulary |
-| weekly-report | 报表汇演 Reports | [weekly-report/](weekly-report/) | 多源数据生成周报（本周结论 + 本周任务进度/下周计划/风险阻塞点 + 本周概览卡）；周结束日可配置（默认周五），支持自然语言周定位（本周/上周/10月第2周/节假日锚定）<br>Weekly reports with a conclusion, progress/plans/blockers and an overview card; configurable week-end day (default Friday), natural-language week locating |
-| monthly-report | 报表汇演 Reports | [monthly-report/](monthly-report/) | 多源数据生成月报（四段式：月度概览/本月关键成果/问题与改进/下月计划），开发类用户可聚合当月 git 提交；12 行业职业词典，支持自定义模板与自然语言月份定位<br>Monthly reports (overview / key results / issues & improvements / next-month plans); optional git commit aggregation, custom templates, natural-language month locating |
-| quarterly-report | 报表汇演 Reports | [quarterly-report/](quarterly-report/) | 多源数据生成季度总结（四段式：季度概览/季度关键成果/问题与改进/下季度计划）：核心数据卡带环比（较上季度）+ 同比（较去年同期）双基准，概览附 Q1-Q4 季度走势图；成果段按 M1/M2/M3 月时间线；12 行业职业词典，支持自定义模板<br>Quarterly reviews with QoQ + YoY metric cards and a Q1-Q4 trend chart; results laid out on an M1/M2/M3 monthly timeline; 12-industry vocabulary, custom templates |
-| annual-report | 报表汇演 Reports | [annual-report/](annual-report/) | 多源数据生成年度总结（五段式：年度概览/核心成果/经验成长/不足反思/新年规划）：git 全年提交聚合 + 会话口述；12 行业职业词典，支持自定义模板与自然语言年度定位<br>Annual summaries in five sections; year-round git commit aggregation plus oral input; 12-industry vocabulary, custom templates, natural-language year locating |
-| article-to-html | 文档装裱 Documents | [article-to-html/](article-to-html/) | Word / Markdown / 纯文本 → 精美独立 HTML（思源黑体 + Roboto 商用免费字体，图表 HTML/CSS 重绘），逐章截图（Retina 2x）；现成 HTML 可直接截图或先美化<br>Word / Markdown / plain text → polished standalone HTML (free commercial fonts, vector-redrawn charts), per-chapter Retina screenshots; ready-made HTML can be screenshotted or restyled first |
-| spec-doc2spec | 工程提效 Engineering | [spec-doc2spec/](spec-doc2spec/) | Word / Markdown 需求文档转结构化需求切片（薄入口 + resources 分册）；自动检测 Pandoc，未装引导跨系统安装<br>Word / Markdown requirements → structured requirement slices; auto-detects Pandoc, guides cross-platform install when missing |
-| spec-spec2doc | 工程提效 Engineering | [spec-spec2doc/](spec-spec2doc/) | Markdown 规格导出为 Word / PDF 交付文档；自动检测 Pandoc，未装引导跨系统安装；PDF 双路径（xelatex / Chrome 打印兜底）<br>Markdown specs → Word / PDF deliverables; Pandoc auto-detect, dual PDF paths (xelatex / Chrome print fallback) |
-| magic-deck | 演示汇演 Slides | [magic-deck/](magic-deck/) | 内容 → 单文件 HTML 幻灯（16:9 舞台 + 播放引擎 + 十六套版式模板 + 十七套主题 + 领域成套模板 21 套 + 图表动画五式 + 动画库 + 全屏放映纯净模式）：自动播放/循环/间隔、键盘热键、页内连接、逐页 PNG 截图与主体复制<br>Content → single-file HTML slides (16:9 stage, playback engine, 16 layouts, 17 themes, 21 domain template packs, chart animations); autoplay, hotkeys, per-slide PNG capture |
-| deck-stage | 演示汇演 Slides | [deck-stage/](deck-stage/) | 报告/素材 → 专业 .pptx 登台文稿：三问交互（素材 → 页骨架表 → 成片方式），常规页原生可编辑（数据卡/时间线/柱图/饼图/折线），封面与结尾页 HTML 截图保真，每页可带演讲备注；视觉与报表同源（tech/biz/mono/light/warm 五主题）<br>Reports/materials → editable .pptx decks: three-question flow, native editable pages (data cards / timelines / charts), HTML-rendered cover & closing, speaker notes per page |
-| meta-forge | 技能自造 Meta | [meta-forge/](meta-forge/) | 元技能：从需求出发锻造完整技能包（薄入口 + resources 拆分 + user-config），自动植入四大机制（CONFIG_VERSION 钥匙 / user-config 抽离 / reference 双轨 / 自检纪律），入仓库时自动登记 README 与 cli.js 分类表<br>Meta skill: forge complete skill packages from requirements (thin entry + resources split + user-config) with four built-in mechanisms and automatic repo registration |
-| meeting-minutes | 沟通协作 Communication | [meeting-minutes/](meeting-minutes/) | 多源材料生成会议纪要（五段式：会议信息/会议结论/议题讨论/决议与行动项/下次会议）：行动项带负责人与截止时间（汇报链源头，可被日报/周报/月报/季报引用）；内置 12 类会议类型词典，支持自定义模板<br>Meeting minutes in five sections; action items with owners & deadlines (source of the reporting chain, citable by daily/weekly/monthly/quarterly reports); 12 meeting-type dictionaries, custom templates |
-| prompt-pouch | 沟通协作 Communication | [prompt-pouch/](prompt-pouch/) | 锦囊提示词管理台：生成并维护本地 HTML 管理页面（分组侧栏/搜索/拖拽与按钮排序/收藏/{变量}插值/一键复制/标签全交互/导入导出 JSON 备份/分组 emoji 快捷面板），数据存 data/prompts.json、滚动备份在 backup/ 子目录，页面与数据分离，双笔协作（页面直写 + AI 代笔）<br>Local prompt manager page (groups, search, drag & button sorting, favorites, {variable} interpolation, one-click copy, full tag interaction, JSON import/export); data lives in prompts.json with rolling backups, page and data stay separate |
-
-## 快速开始 · Quick Start
+| daily-report | 报表汇演 | [daily-report/](daily-report/) | 多源数据生成日报（今日任务进度/明日计划/风险阻塞点）：一段文字、文件里的描述、图片或口头补充皆可成稿；支持自然语言日期（今天/昨天/上周三/10月20号）、连续多日批量、自定义模板、12 行业词条 |
+| 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 行业职业词典，支持自定义模板与自然语言年度定位 |
+| 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 索引、随时检索复盘 |
+
+## 快速开始
 
 ```bash
-npm i -g skill-forge-hub        # 全局安装 · global install
-skill-forge ls                  # 列出全部技能（只读）· list all skills
-skill-forge init                # 交互式挑选技能，自动探测并安装到 AI 助手技能目录 · pick & install interactively
-skill-forge update              # 升级已安装技能（配置版本感知，本地配置受保护）· upgrade with config protection
+npm i -g skill-forge-hub        # 全局安装
+skill-forge ls                  # 列出全部技能（只读）
+skill-forge init                # 交互式挑选技能，自动探测并安装到 AI 助手技能目录
+npm update -g skill-forge-hub   # 官方发新版后升级 CLI 本体（只升级本包）
+skill-forge update              # 升级已安装技能（配置版本感知，本地配置受保护）
 ```
 
 安装后直接说「写日报」「写周报」「写月报」「写季报」「写年报」「记会议」或丢给它一个文档即可触发；问「日报怎么用 / 会议纪要怎么用 / 登台怎么用」等输出使用说明。
 
-Once installed, just say "写日报" (write a daily report), "记会议" (take meeting minutes), or hand it a document to trigger a skill; ask "how to use X" for a plain-language guide.
-
-## 文档导航 · Documentation
+## 文档导航
 
-| 文档 Document | 内容 Contents |
+| 文档 | 内容 |
 |:---|:---|
-| [docs/install.md](docs/install.md) | 安装与升级详解：两种安装方式、命令参考、升级与配置保护机制、维护者约定（CONFIG_VERSION 递增规则）<br>Installation & upgrade in depth: two install methods, command reference, upgrade & config protection, maintainer conventions |
-| [docs/architecture.md](docs/architecture.md) | 架构与规范：目录结构、技能形态（薄入口 + resources）、四大机制、拆分规范、通用原则<br>Architecture & conventions: directory layout, skill anatomy, the four core mechanisms, splitting rules, general principles |
-| [CHANGELOG.md](CHANGELOG.md) | 版本变更记录 · Version changelog |
+| [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) |
 
-## 许可证 · License
+## 许可证
 
 [MIT](LICENSE)