skill-forge-hub 1.0.5 → 1.0.7

package/CHANGELOG.en.md

@@ -0,0 +1,194 @@
+# CHANGELOG
+
+[中文](CHANGELOG.md)
+
+Version history of the SkillForge npm package `skill-forge-hub` (command name `skill-forge`).
+
+## 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,27 @@
 # CHANGELOG
 
+[English](CHANGELOG.en.md)
+
 SkillForge（技能锻造坊）npm 包 `skill-forge-hub`（命令名 `skill-forge`）版本变更记录。
 
+## 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 模板现代化**
+
+- template/ 模板对齐 forge-rules 新规范：SKILL.md 重写（第 0 步读 user-config、配置版本机制节、产物升级回炉节（条件）、文档同步自检纪律节、交付自检硬门禁）；新增 template/user-config.md（CONFIG_VERSION: 1 + 保护声明）与 template/resources/usage-guide.md（咨询应答模板）；README 拆掉「配置必须留在 SKILL.md」旧句改为配置出站
+- forge-rules 机制三补入场动画兜底：reference.html 含滚动入场动画（IntersectionObserver + JS 门控）必须带 2s 兜底 setTimeout 强制全显——IO 不触发的环境（headless 截图/打印预览/PDF 导出/嵌入式 webview）卡片不得永久隐藏（meeting-minutes 1.0.5 空白截图教训入规）
+- forge-rules 机制六补页面执行层自愈：id meta 非法/缺失时按路径键（sf-heal: + pathname）自愈为标准 UUID v4 并回写 meta、console.warn 报警——执行层第三防线入规
+- forge-rules 机制八补用户数据类细则：深升级重建必须沿用原页稳定 ID meta 值（换 ID = 数据失联），数据文件一概不动
+- 验证环扩充：静态门禁加第 13 项（入场动画兜底检查）；运行时实测加第 4 项（headless 截图验证内容完整，截图空白即失败）
+- meta-forge 自身对齐：SKILL.md description/流程第 3 步/规则速览补 preserve 保护清单与机制条件（含 HTML 加机制三七八、localStorage 记忆加六、半定制资产加五）；usage-guide 机制清单对齐 forge-rules 八项编号；user-config.md 修复 CONFIG_VERSION 行尾注释吞掉 DIR 行的换行 bug
+
 ## 1.0.5（2026-11-12）
 
 **月报技能上线：monthly-report + 报表家族四选一分流 + 登台月报映射**

package/README.en.md

@@ -0,0 +1,99 @@
+# 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) | 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 |
+| 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 |
+
+## 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): full-year git commit aggregation + verbal input; 12-industry dictionary, custom templates, natural-language year targeting |
+| 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 |
+| 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) |
+| 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) |
+| 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) |
+| 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) |
+
+## 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
+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) |
+| [CHANGELOG.en.md](CHANGELOG.en.md) | Version changelog. Chinese version [CHANGELOG.md](CHANGELOG.md) |
+
+## License
+
+[MIT](LICENSE)

package/README.md

@@ -1,105 +1,99 @@
 # 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 |
+| 文档装裱 | 文档转换与美化：Word / Markdown / 纯文本 → 精美 HTML + 逐章截图 | article-to-html |
+| 工程提效 | 基于 Pandoc 的文档 ↔ 规格互转（需求文档切片 / 规格导出 Word·PDF），Pandoc 机械转换 + AI 校对防错 | spec-doc2spec、spec-spec2doc |
+| 演示汇演 | 从内容到演示：HTML 形态的魔法幻灯（放映 + 模板 + 主题）与 .pptx 登台文稿（原生可编辑页 + 封面截图） | magic-deck、deck-stage |
+| 数据整备 | Excel / CSV / 图表、数据清洗与模板整理（规划中） | （规划中） |
+| 沟通协作 | 会议纪要（行动项带负责人与截止时间，汇报链源头）与提示词管理（锦囊本地管理台） | meeting-minutes、prompt-pouch |
+| 技能自造 | 锻造技能本身的元技能（创建技能 / 插件） | meta-forge |
 
-## 技能清单 · 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 行业职业词典，支持自定义模板与自然语言年度定位 |
+| article-to-html | 文档装裱 | [article-to-html/](article-to-html/) | Word / Markdown / 纯文本 → 精美独立 HTML（思源黑体 + Roboto 商用免费字体，图表 HTML/CSS 重绘），逐章截图（Retina 2x）；现成 HTML 可直接截图或先美化 |
+| spec-doc2spec | 工程提效 | [spec-doc2spec/](spec-doc2spec/) | Word / Markdown 需求文档转结构化需求切片（薄入口 + resources 分册）；自动检测 Pandoc，未装引导跨系统安装 |
+| spec-spec2doc | 工程提效 | [spec-spec2doc/](spec-spec2doc/) | Markdown 规格导出为 Word / PDF 交付文档；自动检测 Pandoc，未装引导跨系统安装；PDF 双路径（xelatex / Chrome 打印兜底） |
+| magic-deck | 演示汇演 | [magic-deck/](magic-deck/) | 内容 → 单文件 HTML 幻灯（16:9 舞台 + 播放引擎 + 十六套版式模板 + 十七套主题 + 领域成套模板 21 套 + 图表动画五式 + 动画库 + 全屏放映纯净模式）：自动播放/循环/间隔、键盘热键、页内连接、逐页 PNG 截图与主体复制 |
+| deck-stage | 演示汇演 | [deck-stage/](deck-stage/) | 报告/素材 → 专业 .pptx 登台文稿：三问交互（素材 → 页骨架表 → 成片方式），常规页原生可编辑（数据卡/时间线/柱图/饼图/折线），封面与结尾页 HTML 截图保真，每页可带演讲备注；视觉与报表同源（tech/biz/mono/light/warm 五主题） |
+| meta-forge | 技能自造 | [meta-forge/](meta-forge/) | 元技能：从需求出发锻造完整技能包（薄入口 + resources 拆分 + user-config），自动植入八大机制（CONFIG_VERSION 钥匙 / user-config 抽离 / reference 双轨 / 自检纪律 / preserve 保护清单 / 多文件隔离 / 零侵权脱敏离线 / 产物升级回炉），入仓库时自动登记 README 分类表、cli.js CATEGORIES 与 package.json files（npm 包内容不遗漏） |
+| meeting-minutes | 沟通协作 | [meeting-minutes/](meeting-minutes/) | 多源材料生成会议纪要（五段式：会议信息/会议结论/议题讨论/决议与行动项/下次会议）：行动项带负责人与截止时间（汇报链源头，可被日报/周报/月报/季报引用）；内置 12 类会议类型词典，支持自定义模板 |
+| prompt-pouch | 沟通协作 | [prompt-pouch/](prompt-pouch/) | 锦囊提示词管理台：生成并维护本地 HTML 管理页面（分组侧栏/搜索/拖拽与按钮排序/收藏/{变量}插值/一键复制/标签全交互/导入导出 JSON 备份/分组 emoji 快捷面板），数据存 data/prompts.json、滚动备份在 backup/ 子目录，页面与数据分离，双笔协作（页面直写 + AI 代笔） |
+
+## 快速开始
 
 ```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 助手技能目录
+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) |
+| [CHANGELOG.md](CHANGELOG.md) | 版本变更记录。英文版 [CHANGELOG.en.md](CHANGELOG.en.md) |
 
-## 许可证 · License
+## 许可证
 
 [MIT](LICENSE)