skill-forge-hub 1.0.7 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (133) hide show
  1. package/CHANGELOG.en.md +9 -0
  2. package/CHANGELOG.md +9 -0
  3. package/README.en.md +18 -7
  4. package/README.md +18 -7
  5. package/annual-report/SKILL.md +10 -0
  6. package/annual-report/resources/disk-and-html.md +1 -0
  7. package/annual-report/resources/reference.html +1 -1
  8. package/annual-report/resources/skillforge-guide.html +408 -0
  9. package/annual-report/resources/skillforge-guide.txt +131 -0
  10. package/article-to-html/SKILL.md +12 -0
  11. package/article-to-html/resources/skillforge-guide.html +408 -0
  12. package/article-to-html/resources/skillforge-guide.txt +131 -0
  13. package/cli.js +6 -5
  14. package/commit-heatmap/SKILL.md +70 -0
  15. package/commit-heatmap/resources/collect.md +22 -0
  16. package/commit-heatmap/resources/generate.md +15 -0
  17. package/commit-heatmap/resources/html-rules.md +21 -0
  18. package/commit-heatmap/resources/reference.html +228 -0
  19. package/commit-heatmap/resources/skillforge-guide.html +408 -0
  20. package/commit-heatmap/resources/skillforge-guide.txt +131 -0
  21. package/commit-heatmap/resources/usage-guide.md +23 -0
  22. package/commit-heatmap/user-config.md +12 -0
  23. package/daily-report/SKILL.md +10 -0
  24. package/daily-report/resources/disk-and-html.md +1 -1
  25. package/daily-report/resources/reference.html +1 -1
  26. package/daily-report/resources/skillforge-guide.html +408 -0
  27. package/daily-report/resources/skillforge-guide.txt +131 -0
  28. package/data-prepper/SKILL.md +54 -0
  29. package/data-prepper/resources/clean-rules.md +18 -0
  30. package/data-prepper/resources/overview.md +17 -0
  31. package/data-prepper/resources/read-data.md +13 -0
  32. package/data-prepper/resources/skillforge-guide.html +408 -0
  33. package/data-prepper/resources/skillforge-guide.txt +131 -0
  34. package/data-prepper/resources/usage-guide.md +24 -0
  35. package/data-prepper/user-config.md +11 -0
  36. package/decision-log/SKILL.md +53 -0
  37. package/decision-log/resources/index.md +21 -0
  38. package/decision-log/resources/record.md +19 -0
  39. package/decision-log/resources/skillforge-guide.html +408 -0
  40. package/decision-log/resources/skillforge-guide.txt +131 -0
  41. package/decision-log/resources/usage-guide.md +23 -0
  42. package/decision-log/user-config.md +9 -0
  43. package/deck-stage/SKILL.md +11 -1
  44. package/deck-stage/resources/cover-template.html +1 -1
  45. package/deck-stage/resources/skillforge-guide.html +408 -0
  46. package/deck-stage/resources/skillforge-guide.txt +131 -0
  47. package/docs/architecture.en.md +2 -1
  48. package/docs/architecture.md +2 -1
  49. package/docs/install.en.md +56 -0
  50. package/docs/install.md +56 -0
  51. package/docs/usage-examples.en.md +50 -0
  52. package/docs/usage-examples.md +50 -0
  53. package/magic-deck/SKILL.md +11 -1
  54. package/magic-deck/resources/deck-spec.md +1 -1
  55. package/magic-deck/resources/reference.html +1 -1
  56. package/magic-deck/resources/skillforge-guide.html +408 -0
  57. package/magic-deck/resources/skillforge-guide.txt +131 -0
  58. package/meeting-minutes/SKILL.md +10 -0
  59. package/meeting-minutes/resources/disk-and-html.md +1 -0
  60. package/meeting-minutes/resources/reference.html +1 -1
  61. package/meeting-minutes/resources/skillforge-guide.html +408 -0
  62. package/meeting-minutes/resources/skillforge-guide.txt +131 -0
  63. package/meta-forge/SKILL.md +11 -1
  64. package/meta-forge/resources/forge-rules.md +4 -1
  65. package/meta-forge/resources/skillforge-guide.html +408 -0
  66. package/meta-forge/resources/skillforge-guide.txt +131 -0
  67. package/monthly-report/SKILL.md +10 -0
  68. package/monthly-report/resources/disk-and-html.md +1 -0
  69. package/monthly-report/resources/reference.html +1 -1
  70. package/monthly-report/resources/skillforge-guide.html +408 -0
  71. package/monthly-report/resources/skillforge-guide.txt +131 -0
  72. package/one-pager/SKILL.md +71 -0
  73. package/one-pager/resources/content.md +18 -0
  74. package/one-pager/resources/generate.md +16 -0
  75. package/one-pager/resources/html-rules.md +21 -0
  76. package/one-pager/resources/reference.html +209 -0
  77. package/one-pager/resources/skillforge-guide.html +408 -0
  78. package/one-pager/resources/skillforge-guide.txt +131 -0
  79. package/one-pager/resources/usage-guide.md +23 -0
  80. package/one-pager/user-config.md +11 -0
  81. package/package.json +10 -1
  82. package/prompt-pouch/SKILL.md +12 -1
  83. package/prompt-pouch/resources/reference.html +1 -1
  84. package/prompt-pouch/resources/skillforge-guide.html +408 -0
  85. package/prompt-pouch/resources/skillforge-guide.txt +131 -0
  86. package/quarterly-report/SKILL.md +10 -0
  87. package/quarterly-report/resources/disk-and-html.md +1 -0
  88. package/quarterly-report/resources/reference.html +1 -1
  89. package/quarterly-report/resources/skillforge-guide.html +408 -0
  90. package/quarterly-report/resources/skillforge-guide.txt +131 -0
  91. package/release-notes/SKILL.md +54 -0
  92. package/release-notes/resources/collect.md +17 -0
  93. package/release-notes/resources/publish-checklist.md +11 -0
  94. package/release-notes/resources/skillforge-guide.html +408 -0
  95. package/release-notes/resources/skillforge-guide.txt +131 -0
  96. package/release-notes/resources/usage-guide.md +25 -0
  97. package/release-notes/resources/write.md +27 -0
  98. package/release-notes/user-config.md +15 -0
  99. package/skill-doctor/SKILL.md +53 -0
  100. package/skill-doctor/resources/checks.md +27 -0
  101. package/skill-doctor/resources/report.md +26 -0
  102. package/skill-doctor/resources/skillforge-guide.html +408 -0
  103. package/skill-doctor/resources/skillforge-guide.txt +131 -0
  104. package/skill-doctor/resources/usage-guide.md +22 -0
  105. package/skill-doctor/user-config.md +9 -0
  106. package/spec-doc2spec/SKILL.md +10 -0
  107. package/spec-doc2spec/resources/skillforge-guide.html +408 -0
  108. package/spec-doc2spec/resources/skillforge-guide.txt +131 -0
  109. package/spec-spec2doc/SKILL.md +10 -0
  110. package/spec-spec2doc/resources/skillforge-guide.html +408 -0
  111. package/spec-spec2doc/resources/skillforge-guide.txt +131 -0
  112. package/team-report-collector/SKILL.md +70 -0
  113. package/team-report-collector/resources/collect.md +23 -0
  114. package/team-report-collector/resources/generate.md +14 -0
  115. package/team-report-collector/resources/html-rules.md +22 -0
  116. package/team-report-collector/resources/reference.html +384 -0
  117. package/team-report-collector/resources/skillforge-guide.html +408 -0
  118. package/team-report-collector/resources/skillforge-guide.txt +131 -0
  119. package/team-report-collector/resources/usage-guide.md +25 -0
  120. package/team-report-collector/user-config.md +12 -0
  121. package/twin-docs/SKILL.md +53 -0
  122. package/twin-docs/resources/glossary.md +12 -0
  123. package/twin-docs/resources/skillforge-guide.html +408 -0
  124. package/twin-docs/resources/skillforge-guide.txt +131 -0
  125. package/twin-docs/resources/sync-check.md +15 -0
  126. package/twin-docs/resources/translate.md +20 -0
  127. package/twin-docs/resources/usage-guide.md +24 -0
  128. package/twin-docs/user-config.md +11 -0
  129. package/weekly-report/SKILL.md +10 -0
  130. package/weekly-report/resources/disk-and-html.md +1 -1
  131. package/weekly-report/resources/reference.html +1 -1
  132. package/weekly-report/resources/skillforge-guide.html +408 -0
  133. package/weekly-report/resources/skillforge-guide.txt +131 -0
package/release-notes/SKILL.md ADDED
@@ -0,0 +1,54 @@
1
+ ---
2
+ name: release-notes
3
+ description: 从 git 两个版本标签之间的提交生成中英双语发版说明与 CHANGELOG 条目（分类归纳 + 用户视角改写，附提交统计），并给出 npm 发布前自检清单。当用户请求写发版说明、release notes、生成 CHANGELOG 条目、准备发版、发布说明时使用。
4
+ allowed-tools: Bash, Read, Write
5
+ disable-model-invocation: false
6
+ ---
7
+
8
+ # 发版说明（release-notes）
9
+
10
+ 把 git 提交流变成人能读的发版说明：收集提交 → 分类归纳 → 用户视角改写 → 中英双语落盘 → 发布自检清单。
11
+
12
+ ## 生成流程
13
+
14
+ 0. **读用户配置**（REPO/LANG/CHANGELOG_FILE/REL_DIR/STATS/SCOPE_HINT）→ 先 Read 同目录 `user-config.md`
15
+ 1. **收集提交**（git log 区间聚合 + 口述补充合并去重）→ 读 `resources/collect.md`
16
+ 2. **分类与改写**（feat/fix/docs 归类，用户视角重写，禁止流水账）→ 读 `resources/write.md`
17
+ 3. **双语产出与落盘**（RELEASE-{tag}.md 双语 + CHANGELOG 条目插入）→ 读 `resources/write.md`
18
+ 4. **发布自检清单**（版本号一致性 / npm pack 验证 / tag 推送要点）→ 读 `resources/publish-checklist.md`
19
+ 5. **使用咨询**（用户只问「发版说明怎么用」等用法、未要求生成）→ 读 `resources/usage-guide.md`，将其内容原样输出（首行标题改为「发版说明生成器使用指南」），不收集提交、不生成任何文件
20
+
21
+ ## ⚙️ 配置与自定义
22
+
23
+ **执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（REPO/LANG/CHANGELOG_FILE/REL_DIR/STATS/SCOPE_HINT）都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
24
+
25
+ ## 配置版本机制（升级保护）
26
+
27
+ 本 skill 当前配置版本为 `1`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明不一致：
28
+
29
+ 1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
30
+ 2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
31
+ 3. 更新 CONFIG_VERSION 为当前版本
32
+ 4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」
33
+
34
+ 升级本 skill 时，配置结构如有变化必须同步更新本节的当前版本号与迁移说明；禁止在未声明版本变更的情况下静默修改配置语义。
35
+ ## 文档同步自检纪律（维护者必读）
36
+
37
+ 修改本 skill 任一文件（SKILL.md / user-config.md / resources/*）后，必须 grep 全文核对相关关键词在各文件间一致（字段名 / 流程节点 / 模板名改名时新旧词全仓核对，旧词零残留才算完成）。
38
+
39
+
40
+ ## 规则速览
41
+
42
+ - 区间口径：优先两个 tag 之间（git log vA..vB）；只有一个 tag 时取该 tag 到 HEAD；没有 tag 时按提交日期区间或最近 N 次提交，先与用户确认口径
43
+ - 用户视角改写：每条「做了什么 + 带来什么价值」，禁止照抄 commit message 流水账；同类合并、无价值提交（chore 琐碎项）一句话带过或忽略
44
+ - 中英对照：术语一致性（同一概念同一译法），命令 / 路径 / 文件名 / 版本号不翻译；两份内容语义对齐，排版结构一致
45
+ - 发布前必须跑自检清单，版本号三处一致（package.json / README / 源码内嵌）未过不动发布
46
+
47
+ ---
48
+
49
+ ## 🔍 SkillForge 使用指引（整体咨询时触发）
50
+
51
+ 当用户询问 **SkillForge 本身**（不是单个技能用法）——「skillforge 怎么用 / 使用说明 / 使用指引 / 是什么」「技能怎么安装 / 怎么升级 / 装了哪些技能 / 技能清单」「skill-forge ls / init / update 等命令怎么用」「技能安装器 / 技能锻造坊」等（中英文、近似说法均可，关键词可自由扩展）：
52
+ 1. Read 同目录 `resources/skillforge-guide.txt` 全文，按其内容整理回答（命令与参数以 txt 为准，勿自行编造）
53
+ 2. 用系统命令打开同目录 `resources/skillforge-guide.html`（macOS `open`，Windows `start`），让用户在浏览器看排版版
54
+ 3. 用户只问单个技能怎么用时（如「日报怎么用」）不触发本指引，走本技能的使用说明
package/release-notes/resources/collect.md ADDED
@@ -0,0 +1,17 @@
1
+ # 收集提交（阶段 1）
2
+
3
+ ## 区间口径（三档，先判断再收集）
4
+
5
+ 1. **双 tag**：`git log vA..vB --oneline`——vA 为上一版本标签，vB 为本次发布标签（vB 可缺省为 HEAD）
6
+ 2. **单 tag**：`git log <tag>..HEAD --oneline`——该 tag 之后的所有提交
7
+ 3. **无 tag**：与用户确认口径（按日期区间 `--since/--until` 或最近 N 次提交）后收集，禁止擅自假设
8
+
9
+ ## 收集规则
10
+
11
+ - 用 `git log --oneline --no-merges`（默认排除 merge 提交；如该版本含重要合并改动，`git log --merges` 单列参考）
12
+ - 附加统计（STATS: true 时）：`git log <区间> --format='%H' | wc -l`（提交数）；净增删行数用 `git log <区间> --shortstat` 累加或 `git diff --shortstat vA vB`；提交者 `git log <区间> --format='%an' | sort | uniq -c | sort -rn`
13
+ - **口述补充**：用户口头说的本期要点（改了什么大方向、解决什么问题）与 git 提交**合并去重**——口述是骨架，提交是血肉；口述提到的点提交里没有时如实保留并标注「口述补充」
14
+
15
+ ## 输出
16
+
17
+ 收集结果清单：按时间倒序的提交列表（hash 短码 + message 原文）+ 统计数字 + 口述要点，交给阶段 2。
package/release-notes/resources/publish-checklist.md ADDED
@@ -0,0 +1,11 @@
1
+ # 发布自检清单（阶段 4）
2
+
3
+ 生成发版说明后、发布动作前，逐项过：
4
+
5
+ 1. **版本号三处一致**：package.json 的 version / README 中的版本徽章或说明 / 源码内嵌版本（CLI 内 `--version` 输出来源），三处必须与本次 tag 一致
6
+ 2. **包内容验证**：`npm pack --dry-run` 确认新文件（新增技能目录 / 文档）都在包内容清单中，无遗漏
7
+ 3. **CHANGELOG 链接可达**：CHANGELOG 中的目录 / 文件引用路径真实存在
8
+ 4. **tag 命名**：与 package.json version 一致（v 前缀统一与否按项目惯例），tag 推送到远端（如 `git push origin <tag>`）
9
+ 5. **未过项禁止发布**：任何一项不通过，修复后重跑清单，禁止跳过直接发布
10
+
11
+ 输出：清单逐项 ✅/❌ 结果 + 未过项修复建议。
package/release-notes/resources/skillforge-guide.html ADDED
@@ -0,0 +1,408 @@
1
+ <!DOCTYPE html>
2
+ <html lang="zh-CN" data-theme="tech">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1">
6
+ <title>SkillForge 使用指引</title>
7
+ <style>
8
+
9
+ /* ═══ 五主题令牌：与报表/幻灯同源（12 核心契约 + 报告扩展）；html[data-theme] 运行时切换 ═══ */
10
+ :root, [data-theme="tech"]{
11
+ --bg:#0a1929; --bg2:#071525; --panel:rgba(11,30,55,.9); --panel-solid:#0b1e37;
12
+ --text:#bae6fd; --muted:#5b7fa5; --accent:#0ea5e9; --accent2:#14b8a6;
13
+ --border:rgba(14,165,233,.18); --glow:rgba(14,165,233,.35); --glow-soft:rgba(14,165,233,.15);
14
+ --title-grad:linear-gradient(90deg,#7dd3fc,#0ea5e9 45%,#818cf8);
15
+ --tag-bg:rgba(14,165,233,.12);
16
+ --card-shadow:0 1px 0 rgba(255,255,255,.05) inset,0 12px 32px rgba(1,6,16,.5),0 0 24px rgba(14,165,233,.15);
17
+ --scan:rgba(0,240,255,.2); --scan-dim:rgba(0,240,255,.05);
18
+ --green:#14b8a6; --orange:#f97316; --rose:#f43f5e;
19
+ }
20
+ [data-theme="biz"]{
21
+ --bg:#e8ecf5; --bg2:#dde3ef; --panel:rgba(255,255,255,.97); --panel-solid:#ffffff;
22
+ --text:#1e293b; --muted:#64748b; --accent:#2563eb; --accent2:#0891b2;
23
+ --border:rgba(37,99,235,.14); --glow:rgba(37,99,235,.18); --glow-soft:rgba(37,99,235,.12);
24
+ --title-grad:linear-gradient(90deg,#1e40af,#2563eb 55%,#0891b2);
25
+ --tag-bg:rgba(37,99,235,.08);
26
+ --card-shadow:0 1px 2px rgba(15,23,42,.05),0 10px 28px rgba(15,23,42,.12);
27
+ --scan:rgba(37,99,235,.14); --scan-dim:rgba(37,99,235,.04);
28
+ --green:#0d9488; --orange:#ea580c; --rose:#e11d48;
29
+ }
30
+ [data-theme="mono"]{
31
+ --bg:#1e1f22; --bg2:#2b2d30; --panel:rgba(43,45,48,.95); --panel-solid:#2b2d30;
32
+ --card-shadow:0 1px 0 rgba(255,255,255,.06) inset, 0 12px 32px rgba(0,0,0,.5), 0 0 24px rgba(53,116,240,.16);
33
+ --text:#dfe1e5; --muted:#9aa0a6; --accent:#3574f0; --accent2:#5e9aff;
34
+ --border:rgba(53,116,240,.26); --glow:rgba(53,116,240,.3); --glow-soft:rgba(53,116,240,.13);
35
+ --title-grad:linear-gradient(90deg,#dfe1e5,#5e9aff 50%,#3574f0);
36
+ --tag-bg:rgba(53,116,240,.13);
37
+ --scan:rgba(223,225,229,.18); --scan-dim:rgba(223,225,229,.07);
38
+ --green:#4da36b; --orange:#d09645; --rose:#d85f73;
39
+ }
40
+ [data-theme="light"]{
41
+ --bg:#ffffff; --bg2:#f2f2f2; --panel:rgba(255,255,255,.98); --panel-solid:#ffffff;
42
+ --card-shadow:0 1px 2px rgba(30,31,34,.06), 0 10px 28px rgba(30,31,34,.12);
43
+ --text:#1e1f22; --muted:#6e7781; --accent:#2675bf; --accent2:#4a9be0;
44
+ --border:rgba(38,117,191,.18); --glow:rgba(38,117,191,.2); --glow-soft:rgba(38,117,191,.1);
45
+ --title-grad:linear-gradient(90deg,#1e5f9f,#2675bf 55%,#4a9be0);
46
+ --tag-bg:rgba(38,117,191,.08);
47
+ --scan:rgba(38,117,191,.12); --scan-dim:rgba(38,117,191,.04);
48
+ --green:#2f8a5b; --orange:#d97706; --rose:#d6336c;
49
+ }
50
+ [data-theme="warm"]{
51
+ --bg:#f7ebd9; --bg2:#efe0c8; --panel:rgba(255,250,243,.97); --panel-solid:#fffaf3;
52
+ --text:#43301f; --muted:#8a7565; --accent:#d97706; --accent2:#ea580c;
53
+ --border:rgba(217,119,6,.18); --glow:rgba(217,119,6,.22); --glow-soft:rgba(217,119,6,.14);
54
+ --title-grad:linear-gradient(90deg,#b45309,#d97706 50%,#ea580c);
55
+ --tag-bg:rgba(217,119,6,.1);
56
+ --card-shadow:0 1px 2px rgba(120,72,24,.07),0 10px 28px rgba(120,72,24,.13);
57
+ --scan:rgba(217,119,6,.16); --scan-dim:rgba(217,119,6,.04);
58
+ --green:#0d9488; --orange:#c2410c; --rose:#be123c;
59
+ }
60
+ [data-theme="biz"] .stars, [data-theme="light"] .stars, [data-theme="warm"] .stars{ opacity:.28; }
61
+ [data-theme="mono"] .stars{ background:radial-gradient(1px 1px at 12% 22%,rgba(223,225,229,.32),transparent),radial-gradient(1px 1px at 28% 68%,rgba(223,225,229,.28),transparent),radial-gradient(1.5px 1.5px at 45% 15%,rgba(223,225,229,.24),transparent),radial-gradient(1px 1px at 62% 78%,rgba(223,225,229,.26),transparent),radial-gradient(1px 1px at 78% 32%,rgba(223,225,229,.3),transparent),radial-gradient(1.5px 1.5px at 88% 58%,rgba(223,225,229,.28),transparent),radial-gradient(1px 1px at 8% 85%,rgba(223,225,229,.26),transparent),radial-gradient(1px 1px at 55% 45%,rgba(223,225,229,.24),transparent)}
62
+
63
+ *{margin:0;padding:0;box-sizing:border-box}
64
+ html,body{background:var(--bg)}
65
+ body{
66
+ font-family:ui-monospace,'SF Mono',SFMono-Regular,Menlo,Consolas,monospace;
67
+ color:var(--text);-webkit-font-smoothing:antialiased;overflow-x:hidden;
68
+ }
69
+ .grid-pattern{position:fixed;inset:0;z-index:0;pointer-events:none;
70
+ background:linear-gradient(var(--scan-dim) 1px,transparent 1px),linear-gradient(90deg,var(--scan-dim) 1px,transparent 1px);
71
+ background-size:60px 60px}
72
+ .stars{position:fixed;inset:0;z-index:0;pointer-events:none;
73
+ background:radial-gradient(1px 1px at 12% 22%,rgba(255,255,255,.4),transparent),radial-gradient(1px 1px at 28% 68%,rgba(0,240,255,.5),transparent),radial-gradient(1.5px 1.5px at 45% 15%,rgba(168,85,247,.4),transparent),radial-gradient(1px 1px at 62% 78%,rgba(0,255,136,.4),transparent),radial-gradient(1px 1px at 78% 32%,rgba(255,255,255,.35),transparent),radial-gradient(1.5px 1.5px at 88% 58%,rgba(0,240,255,.45),transparent),radial-gradient(1px 1px at 8% 85%,rgba(255,255,255,.3),transparent),radial-gradient(1px 1px at 55% 45%,rgba(0,240,255,.35),transparent)}
74
+ .scanlines{position:fixed;inset:0;z-index:999;pointer-events:none;
75
+ background:repeating-linear-gradient(0deg,transparent,transparent 2px,var(--scan-dim) 2px,var(--scan-dim) 4px)}
76
+ .scanband{position:fixed;left:0;right:0;height:150px;z-index:998;pointer-events:none;
77
+ background:linear-gradient(180deg,transparent,var(--scan-dim) 50%,transparent);
78
+ animation:scanMove 11s linear infinite}
79
+ @keyframes scanMove{from{top:-22%}to{top:112%}}
80
+ .wrap{width:clamp(640px, 60%, 1200px); margin:0 auto; position:relative; z-index:1; padding:40px 0}
81
+ .header-card{position:relative;overflow:hidden;background:var(--panel-solid);border:1px solid var(--border);border-radius:6px;
82
+ padding:34px 28px 26px;text-align:center;margin-bottom:18px;
83
+ box-shadow:var(--card-shadow);
84
+ background-image:repeating-linear-gradient(180deg, rgba(255,255,255,.012) 0 1px, transparent 1px 8px)}
85
+ .header-card h1{font-size:26px;letter-spacing:2px;margin-bottom:8px;
86
+ background:var(--title-grad);-webkit-background-clip:text;background-clip:text;color:transparent;
87
+ animation:titleGlow 3s ease-in-out infinite}
88
+ @keyframes titleGlow{0%,100%{text-shadow:0 0 8px var(--glow),0 0 22px var(--glow-soft)}50%{text-shadow:0 0 14px var(--glow),0 0 34px var(--glow-soft)}}
89
+ .header-sub{font-size:12px;color:var(--muted);letter-spacing:1px;margin-bottom:12px}
90
+ .header-badge{display:inline-block;font-size:11px;color:var(--accent);border:1px solid var(--glow);border-radius:999px;padding:4px 14px}
91
+ .card-glow{position:absolute;inset:-40% -20% auto;height:70%;pointer-events:none;
92
+ background:radial-gradient(ellipse at 50% 10%,var(--glow),transparent 70%);
93
+ animation:cardGlow 3s ease-in-out infinite;transform-origin:top center;opacity:.5}
94
+ @keyframes cardGlow{0%,100%{opacity:.5;transform:scale(1)}50%{opacity:1;transform:scale(1.6)}}
95
+ .scanline-el{position:absolute;pointer-events:none}
96
+ .scan-x{top:0;left:0;height:1px;width:100%;background:linear-gradient(90deg,transparent,var(--accent),transparent);animation:scanX 3s linear infinite}
97
+ .scan-y{top:0;right:0;width:1px;height:100%;background:linear-gradient(180deg,transparent,var(--accent),transparent);animation:scanY 3s linear infinite}
98
+ .scan-x-rev{bottom:0;left:0;height:1px;width:100%;background:linear-gradient(90deg,transparent,var(--accent),transparent);animation:scanXRev 3s linear infinite}
99
+ .scan-y-rev{top:0;left:0;width:1px;height:100%;background:linear-gradient(180deg,transparent,var(--accent),transparent);animation:scanYRev 3s linear infinite}
100
+ @keyframes scanX{from{transform:translateX(-100%)}to{transform:translateX(100%)}}
101
+ @keyframes scanY{from{transform:translateY(-100%)}to{transform:translateY(100%)}}
102
+ @keyframes scanXRev{from{transform:translateX(100%)}to{transform:translateX(-100%)}}
103
+ @keyframes scanYRev{from{transform:translateY(100%)}to{transform:translateY(-100%)}}
104
+ .section{position:relative;overflow:hidden;background:var(--panel-solid);border:1px solid var(--border);border-radius:6px;
105
+ padding:22px 24px 22px 32px;margin-bottom:18px;
106
+ box-shadow:var(--card-shadow);
107
+ background-image:repeating-linear-gradient(180deg, rgba(255,255,255,.012) 0 1px, transparent 1px 8px);
108
+ transition:transform .18s ease,box-shadow .18s ease}
109
+ .section:hover{transform:translateY(-2px);box-shadow:var(--card-shadow),inset 0 0 22px var(--glow-soft)}
110
+ .sec-bar{position:absolute;left:0;top:0;bottom:0;width:8px}
111
+ .sec-ov .sec-bar{background:linear-gradient(180deg,var(--accent2),var(--accent));box-shadow:0 0 12px var(--glow)}
112
+ .sec-ms .sec-bar{background:linear-gradient(180deg,#5eead4,#14b8a6);box-shadow:0 0 12px rgba(20,184,166,.3)}
113
+ .sec-gw .sec-bar{background:linear-gradient(180deg,#a5b4fc,#6366f1);box-shadow:0 0 12px rgba(99,102,241,.3)}
114
+ .sec-rf .sec-bar{background:linear-gradient(180deg,#fda4af,#e11d48);box-shadow:0 0 12px rgba(244,63,94,.3)}
115
+ .sec-pl .sec-bar{background:linear-gradient(180deg,#fdba74,#f97316);box-shadow:0 0 12px rgba(249,115,22,.3)}
116
+ .sec-head{display:flex;align-items:center;gap:10px;margin-bottom:16px}
117
+ .sec-head svg{flex:0 0 auto}
118
+ .sec-head h2{font-size:18px;letter-spacing:1px;animation:secGlow 3s ease-in-out infinite}
119
+ .sec-ov .sec-head h2{color:var(--accent)}.sec-ms .sec-head h2{color:#5eead4}.sec-gw .sec-head h2{color:#c7d2fe}
120
+ .sec-rf .sec-head h2{color:#fda4af}.sec-pl .sec-head h2{color:#fdba74}
121
+ @keyframes secGlow{0%,100%{text-shadow:0 0 6px var(--glow)}50%{text-shadow:0 0 14px var(--glow)}}
122
+ /* 引言与条目 */
123
+ .lead{font-size:15px;line-height:1.75;margin-bottom:14px}
124
+ .lead b{color:var(--accent);font-weight:700}
125
+ .kw{display:flex;gap:10px;flex-wrap:wrap;margin-bottom:16px}
126
+ .kw-item{flex:1 1 200px;background:var(--tag-bg);border:1px solid var(--border);border-radius:6px;padding:12px 14px;
127
+ transition:transform .18s ease,box-shadow .18s ease}
128
+ .kw-item:hover{transform:translateY(-2px);box-shadow:0 8px 20px rgba(0,0,0,.3)}
129
+ .kw-num{font-size:20px;font-weight:900;background:var(--title-grad);-webkit-background-clip:text;background-clip:text;color:transparent}
130
+ .kw-label{font-size:12px;color:var(--muted);margin-top:4px}
131
+ /* 表格 */
132
+ .tbl{width:100%;border-collapse:collapse;font-size:13px;margin-bottom:14px}
133
+ .tbl th{text-align:left;font-size:12px;color:var(--muted);letter-spacing:1px;padding:8px 10px;border-bottom:1px solid var(--border);white-space:nowrap}
134
+ .tbl td{padding:8px 10px;border-bottom:1px dashed var(--border);line-height:1.6;vertical-align:top}
135
+ .tbl tr:last-child td{border-bottom:none}
136
+ .tbl tr:hover td{background:var(--tag-bg)}
137
+ .tbl td:first-child{color:var(--accent);font-weight:700;white-space:nowrap}
138
+ .cat-tag{display:inline-block;font-size:11px;color:var(--muted);border:1px solid var(--border);border-radius:999px;padding:1px 8px;margin-right:6px}
139
+ /* 命令代码块 */
140
+ .cmd{display:block;font-family:inherit;font-size:13px;color:var(--accent2);background:var(--tag-bg);
141
+ border:1px solid var(--border);border-radius:4px;padding:3px 8px;margin:2px 0;white-space:nowrap;overflow-x:auto}
142
+ .cmd-in{display:inline-block;font-family:inherit;font-size:13px;color:var(--accent2);background:var(--tag-bg);
143
+ border:1px solid var(--border);border-radius:4px;padding:1px 6px;white-space:nowrap}
144
+ /* 链路分条 */
145
+ ul.steps{margin:6px 0 0;padding:0;list-style:none}
146
+ ul.steps>li{padding:4px 0 4px 13px;position:relative;font-size:13.5px;line-height:1.7}
147
+ ul.steps>li::before{content:"";position:absolute;left:0;top:12px;width:5px;height:5px;border-radius:50%;background:var(--accent2);opacity:.75}
148
+ ul.steps>li b{color:var(--accent);font-weight:700}
149
+ /* 场景条目 */
150
+ .scn{margin-bottom:12px;padding-left:14px;border-left:2px solid var(--border)}
151
+ .scn-title{font-size:14px;font-weight:700;color:var(--accent);letter-spacing:1px;margin-bottom:6px}
152
+ .scn p{font-size:13.5px;line-height:1.7}
153
+ .scn p .dot{color:var(--muted)}
154
+ /* 链路条目 */
155
+ ol.chain{list-style:none}
156
+ ol.chain>li{display:flex;gap:12px;padding:10px;border-radius:4px;transition:background .18s;margin-bottom:4px}
157
+ ol.chain>li:hover{background:var(--tag-bg)}
158
+ .idx{flex:0 0 auto;width:26px;height:26px;border-radius:50%;position:relative;
159
+ display:flex;align-items:center;justify-content:center;color:#fff;
160
+ font-size:12px;font-weight:900;margin-top:2px;transition:transform .2s ease}
161
+ .idx.rf{background:radial-gradient(circle at 30% 28%,#fdaab4,#f43f5e 55%,#be123c);
162
+ box-shadow:0 2px 4px rgba(0,0,0,.25),0 0 8px rgba(244,63,94,.4),inset -3px -4px 6px rgba(0,0,0,.3),inset 1px 2px 3px rgba(255,255,255,.25)}
163
+ .idx::before{content:'';position:absolute;top:4px;left:6px;width:7px;height:5px;border-radius:50%;
164
+ background:radial-gradient(circle,rgba(255,255,255,.7),rgba(255,255,255,0));transform:rotate(-28deg);pointer-events:none}
165
+ ol.chain>li:hover .idx{transform:scale(1.15) rotate(-4deg)}
166
+ .entry{flex:1;min-width:0}
167
+ .entry-title{font-size:14px;font-weight:700;color:#fda4af;margin-bottom:4px}
168
+ .entry p{font-size:13.5px;line-height:1.7}
169
+ /* 小抄与 FAQ */
170
+ .faq{margin-top:14px;padding-top:12px;border-top:1px dashed var(--border)}
171
+ .faq-title{font-size:12px;color:var(--muted);letter-spacing:1px;margin-bottom:10px}
172
+ .faq-item{font-size:13.5px;line-height:1.7;margin-bottom:8px;padding-left:14px;border-left:2px solid var(--border)}
173
+ .faq-item b{color:var(--accent);font-weight:700}
174
+ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;padding:8px 0 4px}
175
+ .header-card{animation:fadeDown .6s ease-out backwards}
176
+ .sec-ov{animation:riseIn .5s ease-out .13s backwards}
177
+ .sec-ms{animation:riseIn .5s ease-out .26s backwards}
178
+ .sec-gw{animation:riseIn .5s ease-out .4s backwards}
179
+ .sec-rf{animation:riseIn .5s ease-out .54s backwards}
180
+ .sec-pl{animation:riseIn .5s ease-out .68s backwards}
181
+ @keyframes fadeDown{from{opacity:0;transform:translateY(-14px)}to{opacity:1;transform:none}}
182
+ @keyframes riseIn{from{opacity:0;transform:translateY(16px)}to{opacity:1;transform:none}}
183
+ .theme-dock{
184
+ position:fixed; right:18px; bottom:18px; z-index:1001;
185
+ display:flex; gap:8px; padding:8px 10px; border-radius:999px;
186
+ background:var(--panel-solid); border:1px solid var(--border);
187
+ box-shadow:0 4px 18px rgba(0,0,0,.3);
188
+ }
189
+ .theme-dock .th-dot{
190
+ width:22px; height:22px; border-radius:50%; cursor:pointer;
191
+ border:2px solid transparent; padding:0;
192
+ transition:transform .15s ease, border-color .15s ease;
193
+ }
194
+ .theme-dock .th-dot:hover{ transform:scale(1.18); }
195
+ .theme-dock .th-dot.on{ border-color:var(--text); }
196
+ .theme-dock .th-dot[data-theme="tech"]{ background:#0ea5e9; }
197
+ .theme-dock .th-dot[data-theme="biz"]{ background:#2563eb; }
198
+ .theme-dock .th-dot[data-theme="mono"]{ background:#1e1f22; }
199
+ .theme-dock .th-dot[data-theme="light"]{ background:#ffffff; }
200
+ .theme-dock .th-dot[data-theme="warm"]{ background:#d97706; }
201
+ @media print{ .theme-dock{ display:none; } }
202
+ @media (max-width:680px){
203
+ body{ padding:24px 12px 32px; }
204
+ .wrap{ width:100%; max-width:none; }
205
+ .header-card{ padding:26px 18px 20px; }
206
+ .header-card h1{ font-size:26px; }
207
+ }
208
+ </style>
209
+ </head>
210
+ <body>
211
+ <div class="grid-pattern"></div>
212
+ <div class="stars"></div>
213
+ <div class="scanband"></div>
214
+ <div class="scanlines"></div>
215
+ <div class="wrap">
216
+ <header class="header-card" id="headerCard">
217
+ <span class="scanline-el scan-x"></span>
218
+ <span class="scanline-el scan-y"></span>
219
+ <span class="scanline-el scan-x-rev"></span>
220
+ <span class="scanline-el scan-y-rev"></span>
221
+ <div class="card-glow"></div>
222
+ <h1>SkillForge 使用指引</h1>
223
+ <div class="header-sub">技能锻造坊 · 个人技能仓库与命令行分发器</div>
224
+ <span class="header-badge">npm 包 skill-forge-hub · 命令 skill-forge · 21 技能</span>
225
+ </header>
226
+
227
+ <section class="section sec-ov">
228
+ <div class="sec-bar"></div>
229
+ <div class="card-glow"></div>
230
+ <div class="sec-head">
231
+ <svg viewBox="0 0 24 24" width="22" height="22" fill="none" stroke="#38bdf8" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 15l4-5M8 15l4-5"/><circle cx="12" cy="14" r="8"/><path d="M12 14l4-5"/></svg>
232
+ <h2>一、SkillForge 是什么</h2>
233
+ </div>
234
+ <div class="lead"><b>SkillForge</b> 是一套个人技能仓库 + 命令行分发器：把 21 个技能打包分发，一条命令装进你的 AI 助手技能目录；升级时配置版本感知，你的本地个性化配置永不丢失。</div>
235
+ <div class="kw">
236
+ <div class="kw-item"><div class="kw-num">21</div><div class="kw-label">技能 · 七类：报表汇演 / 文档装裱 / 工程提效 / 演示汇演 / 数据整备 / 沟通协作 / 技能自造</div></div>
237
+ <div class="kw-item"><div class="kw-num">ls · init · update</div><div class="kw-label">命令 skill-forge：只读浏览 / 交互安装 / 配置版本感知升级</div></div>
238
+ <div class="kw-item"><div class="kw-num">永不覆盖</div><div class="kw-label">用户配置出站 user-config.md，升级不丢个性化；结构变化先备份再三选一</div></div>
239
+ </div>
240
+ <table class="tbl">
241
+ <tr><th>分类</th><th>技能</th><th>一句话触发语</th></tr>
242
+ <tr><td>报表汇演</td><td>daily-report · weekly-report · monthly-report · quarterly-report · annual-report · team-report-collector</td><td>「写日报 / 周报 / 月报 / 季报 / 年报」/「收日报」</td></tr>
243
+ <tr><td>文档装裱</td><td>article-to-html · twin-docs · one-pager</td><td>丢给它一个文档 /「翻译成英文文档」/「做张海报」</td></tr>
244
+ <tr><td>工程提效</td><td>spec-doc2spec · spec-spec2doc · release-notes</td><td>「把这个文档转成需求规格 / 导出 Word·PDF」/「写发版说明」</td></tr>
245
+ <tr><td>演示汇演</td><td>magic-deck · deck-stage</td><td>「做个 PPT」（HTML 幻灯 / .pptx 可编辑）</td></tr>
246
+ <tr><td>数据整备</td><td>data-prepper · commit-heatmap</td><td>「整理这份数据」/「生成提交热力图」</td></tr>
247
+ <tr><td>沟通协作</td><td>meeting-minutes · prompt-pouch · decision-log</td><td>「记会议」/「做一个锦囊管理页面」/「记决策」</td></tr>
248
+ <tr><td>技能自造</td><td>meta-forge · skill-doctor</td><td>「帮我创建一个新技能」/「给技能体检」</td></tr>
249
+ </table>
250
+ </section>
251
+
252
+ <section class="section sec-ms">
253
+ <div class="sec-bar"></div>
254
+ <div class="card-glow"></div>
255
+ <div class="sec-head">
256
+ <svg viewBox="0 0 24 24" width="22" height="22" fill="none" stroke="#5eead4" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="4" width="18" height="16" rx="2"/><path d="M7 9l3 3-3 3M13 15h4"/></svg>
257
+ <h2>二、命令速查</h2>
258
+ </div>
259
+ <table class="tbl">
260
+ <tr><th>命令</th><th>说明</th></tr>
261
+ <tr><td><span class="cmd-in">skill-forge ls</span></td><td>列出全部技能（分类 + 名称 + 说明），只读不写文件</td></tr>
262
+ <tr><td><span class="cmd-in">skill-forge init</span></td><td>交互挑选安装：a 全装 / 编号挑选（已装标 ★）/ 确认时 s 跳过已装</td></tr>
263
+ <tr><td><span class="cmd-in">npm update -g skill-forge-hub</span></td><td>官方发新版后升级 CLI 本体（只升级本包）</td></tr>
264
+ <tr><td><span class="cmd-in">skill-forge update</span></td><td>升级全部已安装技能（配置版本感知）</td></tr>
265
+ <tr><td><span class="cmd-in">skill-forge update --skills a,b</span></td><td>只升级指定技能（未安装的提示跳过）</td></tr>
266
+ <tr><td><span class="cmd-in">skill-forge --version</span> / <span class="cmd-in">--help</span></td><td>显示版本号 / 完整帮助</td></tr>
267
+ </table>
268
+ <div class="lead">命令别名：<b>list = ls、install = init、upgrade = update</b>。通用参数（init / update 通用）：</div>
269
+ <div class="scn"><div class="scn-title">--target &lt;目录&gt;（-t）</div><p>指定技能目录；缺省自动探测常见助手目录（~/.qoder-cn、~/.claude、~/.cursor 等），探测到多个时交互选择</p></div>
270
+ <div class="scn"><div class="scn-title">--skills a,b（-s）</div><p>init 时跳过选择直接装指定技能（脚本与单件补装友好）；update 时只升级指定技能</p></div>
271
+ <div class="scn"><div class="scn-title">--yes（-y）</div><p>跳过确认直接执行；配置版本变化时默认「保留我的 + 官方版另存 .upstream 对照」</p></div>
272
+ </section>
273
+
274
+ <section class="section sec-gw">
275
+ <div class="sec-bar"></div>
276
+ <div class="card-glow"></div>
277
+ <div class="sec-head">
278
+ <svg viewBox="0 0 24 24" width="22" height="22" fill="none" stroke="#a5b4fc" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2v20M17 6h4M17 14h4M3 6h4M3 14h4"/><path d="M12 22a10 10 0 0 0 0-20"/></svg>
279
+ <h2>三、场景化使用流程</h2>
280
+ </div>
281
+ <div class="scn"><div class="scn-title">场景一 · 首次接入（从零到可用）</div>
282
+ <p><span class="cmd">npm i -g skill-forge-hub</span><span class="cmd">skill-forge ls</span><span class="cmd">skill-forge init</span>先浏览清单（只读）→ 交互挑选（a 全装 / 编号挑选 → 确认时 s 跳过已装）→ 自动探测技能目录 → 完成。装完直接对话触发：「写日报」「写周报」「写月报」「写季报」「写年报」「记会议」，或直接丢给它一个文档。</p></div>
283
+ <div class="scn"><div class="scn-title">场景二 · 单件补装（脚本 / 只想要某一个）</div>
284
+ <p><span class="cmd">skill-forge init --skills prompt-pouch --target ~/.qoder-cn/skills</span>跳过挑选环节，只装指定技能到指定目录。</p></div>
285
+ <div class="scn"><div class="scn-title">场景三 · 官方发新版后升级</div>
286
+ <p><span class="cmd">npm update -g skill-forge-hub</span><span class="cmd">skill-forge update</span><span class="cmd">skill-forge update --skills daily-report</span>
287
+ 先升级 CLI 本体，再升级技能；配置结构没变：无感升级，user-config.md 原样保留；<br>
288
+ 配置结构变了（CONFIG_VERSION 升了）：先备份 <span class="cmd-in">user-config.md.bak-&lt;时间戳&gt;</span>，再三选一——<span class="dot">[1]</span> 官方覆盖 / <span class="dot">[2]</span> 保留我的（默认，最稳，官方版另存 .upstream 对照文件手动合并）/ <span class="dot">[3]</span> 稍后处理；<br>
289
+ 官方删了文件：按 .installed-manifest 安装清单精准清理，你自建的文件一律不动。</p></div>
290
+ <div class="scn"><div class="scn-title">场景四 · 非交互 / 自动化</div>
291
+ <p><span class="cmd">skill-forge init --skills daily-report,weekly-report --yes</span>--yes 跳过一切确认，配置冲突默认走 [2] 保留我的。</p></div>
292
+ <div class="scn"><div class="scn-title">场景五 · 换机器 / 换 AI 助手</div>
293
+ <p>新环境重新 <span class="cmd-in">npm i -g skill-forge-hub &amp;&amp; skill-forge init</span>；保留个人配置就把旧机器技能目录里的 user-config.md 一并拷过去（升级永不覆盖，覆盖安装时也保留）。</p></div>
294
+ </section>
295
+
296
+ <section class="section sec-rf">
297
+ <div class="sec-bar"></div>
298
+ <div class="card-glow"></div>
299
+ <div class="sec-head">
300
+ <svg viewBox="0 0 24 24" width="22" height="22" fill="none" stroke="#fda4af" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M13 2L3 14h7l-1 8 10-12h-7l1-8z"/></svg>
301
+ <h2>四、典型技能使用链路</h2>
302
+ </div>
303
+ <div class="lead">统一节奏：<b>安装 → 首次生成 → 修改配置 → 官方升级后 → 旧产物回炉</b>。四个代表，其余同构。</div>
304
+ <ol class="chain">
305
+ <li><span class="idx rf"><b>1</b></span><div class="entry">
306
+ <div class="entry-title">日报 daily-report（报表族代表）</div>
307
+ <ul class="steps">
308
+ <li><b>安装</b>：<span class="cmd-in">skill-forge init --skills daily-report</span></li>
309
+ <li><b>日常生成</b>：说「写日报」口述内容 → md/txt/html（自动打开）+ 截图</li>
310
+ <li><b>修改配置</b>：user-config.md 改 DIR（落盘目录）/ THEME（五主题）/ TEMPLATE（自定义模板）；临时口头要求当次生效不写配置</li>
311
+ <li><b>官方升级后</b>：配置冲突选 [2] 保留我的，对照 .upstream 合并新配置点</li>
312
+ <li><b>旧产物回炉</b>：模板版本戳升了说「把我旧日报都升级成新样式」——浅升级换样式块、深升级从同目录 md 底稿重建，旧版先备份</li>
313
+ </ul>
314
+ </div></li>
315
+ <li><span class="idx rf"><b>2</b></span><div class="entry">
316
+ <div class="entry-title">锦囊 prompt-pouch（本地管理台 + 用户数据）</div>
317
+ <ul class="steps">
318
+ <li><b>安装</b>：<span class="cmd-in">skill-forge init --skills prompt-pouch</span></li>
319
+ <li><b>首次生成</b>：「做一个锦囊管理页面」→ 生成管理台 html + data/prompts.json 数据文件</li>
320
+ <li><b>日常使用</b>：分组侧栏 / 搜索 / 收藏 / 标签点击过滤 / {变量} 插值一键复制 / 导入导出 JSON 备份；页面与数据分离，删页面不丢数据</li>
321
+ <li><b>修改配置</b>：user-config.md 改 DIR（页面目录）、DATA_DIR / BACKUP_DIR（数据与备份目录）</li>
322
+ <li><b>官方升级后</b>：数据目录与数据文件一概不动；深升级重建沿用原页 pouch-id → 收藏 / 分组照旧读回</li>
323
+ <li><b>页面版本升级（回炉）</b>：模板版本戳升了，下次生成时 AI 主动提示「检测到 X 份旧版锦囊」→ 说「把我旧锦囊都升级成新样式」→ 列清单选全部或部分 → 浅升级换样式块、深升级从模板重建沿用原页 pouch-id（收藏分组照旧读回）；prompts.json 数据不动、旧页先备份 .bak-时间戳</li>
324
+ <li><b>多文件隔离</b>：两份锦囊各自独立（内嵌 ID 命名空间）；复制文件副本 = 同一身份共享同一份数据（要独立身份请重新生成一份）</li>
325
+ </ul>
326
+ </div></li>
327
+ <li><span class="idx rf"><b>3</b></span><div class="entry">
328
+ <div class="entry-title">PPT 两形态 magic-deck / deck-stage</div>
329
+ <ul class="steps">
330
+ <li><b>选形态</b>：说「做个 PPT」AI 先问——HTML 幻灯（magic-deck）还是 .pptx 可编辑文稿（deck-stage）</li>
331
+ <li><b>HTML 幻灯</b>：magic-deck 生成单文件 HTML 幻灯，浏览器全屏放映（自动播放 / 循环 / 热键翻页）；需要图片时逐页 PNG 截图</li>
332
+ <li><b>.pptx 文稿</b>：deck-stage 三问交互（素材 → 页骨架表 → 成片方式）生成 .pptx——常规页原生可编辑（数据卡 / 时间线 / 图表），封面与结尾页 HTML 截图保真</li>
333
+ <li><b>补依赖</b>：deck-stage 依赖 PptxGenJS，npm 包不含 node_modules，装完按提示 <span class="cmd-in">cd &lt;技能目录&gt;/deck-stage &amp;&amp; npm install</span> 补装一次</li>
334
+ <li><b>修改配置</b>：五主题 / 页面尺寸 / 演讲备注在 user-config.md</li>
335
+ </ul>
336
+ </div></li>
337
+ <li><span class="idx rf"><b>4</b></span><div class="entry">
338
+ <div class="entry-title">会议纪要 meeting-minutes（汇报链源头）</div>
339
+ <ul class="steps">
340
+ <li><b>日常生成</b>：「记会议」口述材料 → 五段式纪要（会议信息 / 会议结论 / 议题讨论 / 决议与行动项 / 下次会议），行动项带负责人与截止时间——日报 / 周报 / 月报 / 季报的汇报链源头</li>
341
+ <li><b>修改配置</b>：SERIES_GROUP 三态——auto 自动提取系列名归入 meetings/{系列名}/、series 一律按系列建目录、off 纯月份平铺；改口机制「以后这个系列叫 XX」永久生效</li>
342
+ <li><b>官方升级后</b>：同报表族——配置三选一保护 + 说「把旧纪要升级成新样式」回炉</li>
343
+ </ul>
344
+ </div></li>
345
+ </ol>
346
+ </section>
347
+
348
+ <section class="section sec-pl">
349
+ <div class="sec-bar"></div>
350
+ <div class="card-glow"></div>
351
+ <div class="sec-head">
352
+ <svg viewBox="0 0 24 24" width="22" height="22" fill="none" stroke="#fdba74" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 11l3 3 8-8"/><path d="M20 12v6a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h9"/></svg>
353
+ <h2>五、通用小抄</h2>
354
+ </div>
355
+ <table class="tbl">
356
+ <tr><th>需求</th><th>做法</th></tr>
357
+ <tr><td>换落盘目录 / 主题 / 模板</td><td>改 user-config.md（升级永不覆盖）</td></tr>
358
+ <tr><td>官方发新版</td><td><span class="cmd-in">skill-forge update</span>，配置冲突选 [2] 保留我的</td></tr>
359
+ <tr><td>旧产物换新样式</td><td>说「把我旧 XX 都升级成新样式」</td></tr>
360
+ <tr><td>装漏技能</td><td><span class="cmd-in">skill-forge init --skills 技能名</span></td></tr>
361
+ <tr><td>查全部命令</td><td><span class="cmd-in">skill-forge --help</span></td></tr>
362
+ <tr><td>问单个技能用法</td><td>直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出</td></tr>
363
+ <tr><td>问 SkillForge 本身</td><td>问「skillforge 怎么用」，AI 朗读本指引并打开排版页</td></tr>
364
+ </table>
365
+ <div class="faq">
366
+ <div class="faq-title">常见问题</div>
367
+ <div class="faq-item"><b>装完对话没触发技能？</b>确认装进了当前 AI 助手实际读取的技能目录（init 完成时输出的路径）。</div>
368
+ <div class="faq-item"><b>deck-stage 报缺依赖？</b><span class="cmd-in">cd &lt;技能目录&gt;/deck-stage &amp;&amp; npm install</span> 补装 PptxGenJS 一次即可。</div>
369
+ <div class="faq-item"><b>升级后配置会丢吗？</b>不会。user-config.md（与 .preserve 清单内文件）升级永不覆盖，本地修改永久保留。</div>
370
+ <div class="faq-item"><b>这份指引在哪？</b>每个技能的 resources/ 目录里都有（skillforge-guide.txt 文字版 + skillforge-guide.html 排版版），官方升级时随技能资源一起更新。</div>
371
+ </div>
372
+ </section>
373
+
374
+ <footer>GENERATED BY SKILLFORGE TEAM</footer>
375
+ </div>
376
+
377
+ <div class="theme-dock" id="themeDock">
378
+ <button class="th-dot" type="button" data-theme="tech" title="深蓝科技"></button>
379
+ <button class="th-dot" type="button" data-theme="biz" title="浅色商务"></button>
380
+ <button class="th-dot" type="button" data-theme="mono" title="IDEA 黑亮"></button>
381
+ <button class="th-dot" type="button" data-theme="light" title="IDEA 白亮"></button>
382
+ <button class="th-dot" type="button" data-theme="warm" title="温暖渐变"></button>
383
+ </div>
384
+
385
+ <script>
386
+ // ?shot：截图/打印模式——停入场动画直接渲染终态（headless 虚拟时间下动画帧不推进会停在 0 相位）
387
+ if (location.search.indexOf('shot=') !== -1) {
388
+ document.querySelectorAll('.header-card,.section').forEach(function(el){
389
+ el.style.animation = 'none'; el.style.opacity = '1';
390
+ });
391
+ }
392
+ // 主题换肤：五套配色随点随换；记忆上次选择（localStorage，失败静默）
393
+ (function(){
394
+ var THEMES = ['tech','biz','mono','light','warm'];
395
+ var dock = document.getElementById('themeDock');
396
+ if (!dock) return;
397
+ function apply(t){ document.documentElement.setAttribute('data-theme', t);
398
+ dock.querySelectorAll('.th-dot').forEach(function(d){ d.classList.toggle('on', d.getAttribute('data-theme') === t); });
399
+ try{ localStorage.setItem('sf-guide-theme', t); }catch(e){} }
400
+ var cur = document.documentElement.getAttribute('data-theme');
401
+ var saved = null; try{ saved = localStorage.getItem('sf-guide-theme'); }catch(e){}
402
+ if (saved && THEMES.indexOf(saved) !== -1 && saved !== cur){ apply(saved); }
403
+ else{ dock.querySelectorAll('.th-dot').forEach(function(d){ d.classList.toggle('on', d.getAttribute('data-theme') === (cur || 'tech')); }); }
404
+ dock.querySelectorAll('.th-dot').forEach(function(d){ d.addEventListener('click', function(){ apply(d.getAttribute('data-theme')); }); });
405
+ })();
406
+ </script>
407
+ </body>
408
+ </html>