skill-forge-hub 1.0.7 → 1.2.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 (153) hide show
  1. package/CHANGELOG.en.md +19 -0
  2. package/CHANGELOG.md +19 -0
  3. package/README.en.md +20 -7
  4. package/README.md +20 -7
  5. package/SKILLS_CATALOG.md +119 -0
  6. package/annual-report/SKILL.md +13 -3
  7. package/annual-report/resources/disk-and-html.md +1 -0
  8. package/annual-report/resources/reference.html +3 -3
  9. package/annual-report/resources/skillforge-guide.html +409 -0
  10. package/annual-report/resources/skillforge-guide.txt +132 -0
  11. package/annual-report/user-config.md +1 -1
  12. package/article-to-html/SKILL.md +13 -1
  13. package/article-to-html/resources/skillforge-guide.html +409 -0
  14. package/article-to-html/resources/skillforge-guide.txt +132 -0
  15. package/article-to-html/user-config.md +1 -1
  16. package/cli.js +60 -19
  17. package/commit-heatmap/SKILL.md +70 -0
  18. package/commit-heatmap/resources/collect.md +22 -0
  19. package/commit-heatmap/resources/generate.md +15 -0
  20. package/commit-heatmap/resources/html-rules.md +21 -0
  21. package/commit-heatmap/resources/reference.html +228 -0
  22. package/commit-heatmap/resources/skillforge-guide.html +409 -0
  23. package/commit-heatmap/resources/skillforge-guide.txt +132 -0
  24. package/commit-heatmap/resources/usage-guide.md +23 -0
  25. package/commit-heatmap/user-config.md +12 -0
  26. package/daily-report/SKILL.md +12 -2
  27. package/daily-report/resources/disk-and-html.md +1 -1
  28. package/daily-report/resources/reference.html +1 -1
  29. package/daily-report/resources/skillforge-guide.html +409 -0
  30. package/daily-report/resources/skillforge-guide.txt +132 -0
  31. package/daily-report/user-config.md +1 -1
  32. package/data-prepper/SKILL.md +54 -0
  33. package/data-prepper/resources/clean-rules.md +18 -0
  34. package/data-prepper/resources/overview.md +17 -0
  35. package/data-prepper/resources/read-data.md +13 -0
  36. package/data-prepper/resources/skillforge-guide.html +409 -0
  37. package/data-prepper/resources/skillforge-guide.txt +132 -0
  38. package/data-prepper/resources/usage-guide.md +24 -0
  39. package/data-prepper/user-config.md +11 -0
  40. package/decision-log/SKILL.md +53 -0
  41. package/decision-log/resources/index.md +21 -0
  42. package/decision-log/resources/record.md +19 -0
  43. package/decision-log/resources/skillforge-guide.html +409 -0
  44. package/decision-log/resources/skillforge-guide.txt +132 -0
  45. package/decision-log/resources/usage-guide.md +23 -0
  46. package/decision-log/user-config.md +9 -0
  47. package/deck-stage/SKILL.md +14 -11
  48. package/deck-stage/resources/cover-template.html +1 -1
  49. package/deck-stage/resources/skillforge-guide.html +409 -0
  50. package/deck-stage/resources/skillforge-guide.txt +132 -0
  51. package/docs/architecture.en.md +2 -1
  52. package/docs/architecture.md +2 -1
  53. package/docs/articles/ai-daily-report-correct-pose.md +39 -0
  54. package/docs/articles/ai-prompt-management-skill-pouch.md +37 -0
  55. package/docs/directory-submission.md +106 -0
  56. package/docs/install.en.md +57 -1
  57. package/docs/install.md +57 -1
  58. package/docs/usage-examples.en.md +50 -0
  59. package/docs/usage-examples.md +50 -0
  60. package/magic-deck/SKILL.md +15 -6
  61. package/magic-deck/resources/deck-spec.md +1 -1
  62. package/magic-deck/resources/reference.html +1 -1
  63. package/magic-deck/resources/skillforge-guide.html +409 -0
  64. package/magic-deck/resources/skillforge-guide.txt +132 -0
  65. package/magic-deck/user-config.md +1 -1
  66. package/meeting-minutes/SKILL.md +11 -1
  67. package/meeting-minutes/resources/disk-and-html.md +1 -0
  68. package/meeting-minutes/resources/reference.html +1 -1
  69. package/meeting-minutes/resources/skillforge-guide.html +409 -0
  70. package/meeting-minutes/resources/skillforge-guide.txt +132 -0
  71. package/meeting-minutes/user-config.md +1 -1
  72. package/meta-forge/SKILL.md +13 -3
  73. package/meta-forge/resources/forge-rules.md +4 -1
  74. package/meta-forge/resources/skillforge-guide.html +409 -0
  75. package/meta-forge/resources/skillforge-guide.txt +132 -0
  76. package/meta-forge/user-config.md +1 -1
  77. package/monthly-report/SKILL.md +11 -1
  78. package/monthly-report/resources/disk-and-html.md +1 -0
  79. package/monthly-report/resources/reference.html +1 -1
  80. package/monthly-report/resources/skillforge-guide.html +409 -0
  81. package/monthly-report/resources/skillforge-guide.txt +132 -0
  82. package/monthly-report/user-config.md +1 -1
  83. package/one-pager/SKILL.md +83 -0
  84. package/one-pager/resources/content.md +18 -0
  85. package/one-pager/resources/design-process.md +117 -0
  86. package/one-pager/resources/generate.md +28 -0
  87. package/one-pager/resources/html-rules.md +66 -0
  88. package/one-pager/resources/reference.html +1290 -0
  89. package/one-pager/resources/skillforge-guide.html +409 -0
  90. package/one-pager/resources/skillforge-guide.txt +132 -0
  91. package/one-pager/resources/usage-guide.md +37 -0
  92. package/one-pager/resources/user-template-example.html +63 -0
  93. package/one-pager/user-config.md +14 -0
  94. package/package.json +12 -2
  95. package/prompt-pouch/SKILL.md +16 -16
  96. package/prompt-pouch/resources/reference.html +181 -43
  97. package/prompt-pouch/resources/skillforge-guide.html +409 -0
  98. package/prompt-pouch/resources/skillforge-guide.txt +132 -0
  99. package/prompt-pouch/resources/usage-guide.md +3 -3
  100. package/quarterly-report/SKILL.md +11 -1
  101. package/quarterly-report/resources/disk-and-html.md +1 -0
  102. package/quarterly-report/resources/reference.html +1 -1
  103. package/quarterly-report/resources/skillforge-guide.html +409 -0
  104. package/quarterly-report/resources/skillforge-guide.txt +132 -0
  105. package/quarterly-report/user-config.md +1 -1
  106. package/release-notes/SKILL.md +54 -0
  107. package/release-notes/resources/collect.md +17 -0
  108. package/release-notes/resources/publish-checklist.md +11 -0
  109. package/release-notes/resources/skillforge-guide.html +409 -0
  110. package/release-notes/resources/skillforge-guide.txt +132 -0
  111. package/release-notes/resources/usage-guide.md +25 -0
  112. package/release-notes/resources/write.md +27 -0
  113. package/release-notes/user-config.md +15 -0
  114. package/skill-doctor/SKILL.md +53 -0
  115. package/skill-doctor/resources/checks.md +27 -0
  116. package/skill-doctor/resources/report.md +26 -0
  117. package/skill-doctor/resources/skillforge-guide.html +409 -0
  118. package/skill-doctor/resources/skillforge-guide.txt +132 -0
  119. package/skill-doctor/resources/usage-guide.md +22 -0
  120. package/skill-doctor/user-config.md +9 -0
  121. package/spec-doc2spec/SKILL.md +13 -9
  122. package/spec-doc2spec/resources/skillforge-guide.html +409 -0
  123. package/spec-doc2spec/resources/skillforge-guide.txt +132 -0
  124. package/spec-doc2spec/user-config.md +1 -1
  125. package/spec-spec2doc/SKILL.md +13 -12
  126. package/spec-spec2doc/resources/skillforge-guide.html +409 -0
  127. package/spec-spec2doc/resources/skillforge-guide.txt +132 -0
  128. package/spec-spec2doc/user-config.md +1 -1
  129. package/team-report-collector/SKILL.md +70 -0
  130. package/team-report-collector/resources/collect.md +23 -0
  131. package/team-report-collector/resources/generate.md +14 -0
  132. package/team-report-collector/resources/html-rules.md +22 -0
  133. package/team-report-collector/resources/reference.html +384 -0
  134. package/team-report-collector/resources/skillforge-guide.html +409 -0
  135. package/team-report-collector/resources/skillforge-guide.txt +132 -0
  136. package/team-report-collector/resources/usage-guide.md +25 -0
  137. package/team-report-collector/user-config.md +12 -0
  138. package/template/SKILL.md +2 -2
  139. package/template/user-config.md +1 -1
  140. package/twin-docs/SKILL.md +53 -0
  141. package/twin-docs/resources/glossary.md +12 -0
  142. package/twin-docs/resources/skillforge-guide.html +409 -0
  143. package/twin-docs/resources/skillforge-guide.txt +132 -0
  144. package/twin-docs/resources/sync-check.md +15 -0
  145. package/twin-docs/resources/translate.md +20 -0
  146. package/twin-docs/resources/usage-guide.md +24 -0
  147. package/twin-docs/user-config.md +11 -0
  148. package/weekly-report/SKILL.md +12 -2
  149. package/weekly-report/resources/disk-and-html.md +1 -1
  150. package/weekly-report/resources/reference.html +1 -1
  151. package/weekly-report/resources/skillforge-guide.html +409 -0
  152. package/weekly-report/resources/skillforge-guide.txt +132 -0
  153. package/weekly-report/user-config.md +1 -1
package/weekly-report/resources/skillforge-guide.html ADDED
@@ -0,0 +1,409 @@
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
+ <tr><td>查技能双语简介 / 实操文章</td><td><span class="cmd-in">SKILLS_CATALOG.md</span>（21 技能逐条中英简介）/ <span class="cmd-in">docs/articles/</span>（实操文章）/ <span class="cmd-in">docs/directory-submission.md</span>（目录收录素材）</td></tr>
365
+ </table>
366
+ <div class="faq">
367
+ <div class="faq-title">常见问题</div>
368
+ <div class="faq-item"><b>装完对话没触发技能？</b>确认装进了当前 AI 助手实际读取的技能目录（init 完成时输出的路径）。</div>
369
+ <div class="faq-item"><b>deck-stage 报缺依赖？</b><span class="cmd-in">cd &lt;技能目录&gt;/deck-stage &amp;&amp; npm install</span> 补装 PptxGenJS 一次即可。</div>
370
+ <div class="faq-item"><b>升级后配置会丢吗？</b>不会。user-config.md（与 .preserve 清单内文件）升级永不覆盖，本地修改永久保留。</div>
371
+ <div class="faq-item"><b>这份指引在哪？</b>每个技能的 resources/ 目录里都有（skillforge-guide.txt 文字版 + skillforge-guide.html 排版版），官方升级时随技能资源一起更新。</div>
372
+ </div>
373
+ </section>
374
+
375
+ <footer>GENERATED BY SKILLFORGE TEAM</footer>
376
+ </div>
377
+
378
+ <div class="theme-dock" id="themeDock">
379
+ <button class="th-dot" type="button" data-theme="tech" title="深蓝科技"></button>
380
+ <button class="th-dot" type="button" data-theme="biz" title="浅色商务"></button>
381
+ <button class="th-dot" type="button" data-theme="mono" title="IDEA 黑亮"></button>
382
+ <button class="th-dot" type="button" data-theme="light" title="IDEA 白亮"></button>
383
+ <button class="th-dot" type="button" data-theme="warm" title="温暖渐变"></button>
384
+ </div>
385
+
386
+ <script>
387
+ // ?shot：截图/打印模式——停入场动画直接渲染终态（headless 虚拟时间下动画帧不推进会停在 0 相位）
388
+ if (location.search.indexOf('shot=') !== -1) {
389
+ document.querySelectorAll('.header-card,.section').forEach(function(el){
390
+ el.style.animation = 'none'; el.style.opacity = '1';
391
+ });
392
+ }
393
+ // 主题换肤：五套配色随点随换；记忆上次选择（localStorage，失败静默）
394
+ (function(){
395
+ var THEMES = ['tech','biz','mono','light','warm'];
396
+ var dock = document.getElementById('themeDock');
397
+ if (!dock) return;
398
+ function apply(t){ document.documentElement.setAttribute('data-theme', t);
399
+ dock.querySelectorAll('.th-dot').forEach(function(d){ d.classList.toggle('on', d.getAttribute('data-theme') === t); });
400
+ try{ localStorage.setItem('sf-guide-theme', t); }catch(e){} }
401
+ var cur = document.documentElement.getAttribute('data-theme');
402
+ var saved = null; try{ saved = localStorage.getItem('sf-guide-theme'); }catch(e){}
403
+ if (saved && THEMES.indexOf(saved) !== -1 && saved !== cur){ apply(saved); }
404
+ else{ dock.querySelectorAll('.th-dot').forEach(function(d){ d.classList.toggle('on', d.getAttribute('data-theme') === (cur || 'tech')); }); }
405
+ dock.querySelectorAll('.th-dot').forEach(function(d){ d.addEventListener('click', function(){ apply(d.getAttribute('data-theme')); }); });
406
+ })();
407
+ </script>
408
+ </body>
409
+ </html>
package/weekly-report/resources/skillforge-guide.txt ADDED
@@ -0,0 +1,132 @@
1
+ # SkillForge 使用指引（技能锻造坊）
2
+
3
+ SkillForge 是一套个人技能仓库 + 命令行分发器（npm 包 skill-forge-hub，命令 skill-forge）：把 21 个技能打包分发，一条命令装进你的 AI 助手技能目录；升级时配置版本感知，你的本地个性化配置永不丢失。
4
+
5
+ ## 一、SkillForge 是什么
6
+
7
+ 三个关键词：
8
+ 1、技能仓库：21 个技能按「最终产出什么」分七类（报表汇演 / 文档装裱 / 工程提效 / 演示汇演 / 数据整备 / 沟通协作 / 技能自造），每个技能都是 SKILL.md 薄入口 + resources/ 分册 + user-config.md 用户配置的规范结构
9
+ 2、命令行分发器：npm 包 skill-forge-hub，命令 skill-forge（ls / init / update），自动探测 AI 助手技能目录，交互或非交互安装
10
+ 3、配置保护：每个技能的用户配置出站在 user-config.md，升级永不覆盖；配置结构变化时备份 + 三选一，官方新配置另存对照文件供手动合并
11
+
12
+ 技能全景（21 个）：
13
+
14
+ | 分类 | 技能 | 一句话触发语 |
15
+ |:---|:---|:---|
16
+ | 报表汇演 | daily-report | 「写日报」 |
17
+ | 报表汇演 | weekly-report | 「写周报」 |
18
+ | 报表汇演 | monthly-report | 「写月报」 |
19
+ | 报表汇演 | quarterly-report | 「写季报」 |
20
+ | 报表汇演 | annual-report | 「写年报」 |
21
+ | 报表汇演 | team-report-collector | 「收日报」 |
22
+ | 文档装裱 | article-to-html | 丢给它一个文档 |
23
+ | 文档装裱 | twin-docs | 「翻译成英文文档」 |
24
+ | 文档装裱 | one-pager | 「做张海报」 |
25
+ | 工程提效 | spec-doc2spec | 「把这个文档转成需求规格」 |
26
+ | 工程提效 | spec-spec2doc | 「把这个规格导出 Word/PDF」 |
27
+ | 工程提效 | release-notes | 「写发版说明」 |
28
+ | 演示汇演 | magic-deck | 「做个 PPT」（HTML 幻灯形态） |
29
+ | 演示汇演 | deck-stage | 「做个 PPT」（.pptx 可编辑形态） |
30
+ | 数据整备 | data-prepper | 「整理这份数据」 |
31
+ | 数据整备 | commit-heatmap | 「生成提交热力图」 |
32
+ | 沟通协作 | meeting-minutes | 「记会议」 |
33
+ | 沟通协作 | prompt-pouch | 「做一个锦囊管理页面」 |
34
+ | 沟通协作 | decision-log | 「记决策」 |
35
+ | 技能自造 | meta-forge | 「帮我创建一个新技能」 |
36
+ | 技能自造 | skill-doctor | 「给技能体检」 |
37
+
38
+ ## 二、命令速查
39
+
40
+ | 命令 | 说明 |
41
+ |:---|:---|
42
+ | skill-forge ls | 列出全部技能（分类 + 名称 + 说明），只读不写文件 |
43
+ | skill-forge init | 交互挑选安装：a 全装 / 编号挑选（已装标 ★）/ 确认时 s 跳过已装 |
44
+ | npm update -g skill-forge-hub | 官方发新版后升级 CLI 本体（只升级本包） |
45
+ | skill-forge update | 升级全部已安装技能（配置版本感知） |
46
+ | skill-forge update --skills a,b | 只升级指定技能（未安装的提示跳过） |
47
+ | skill-forge --version | 显示版本号 |
48
+ | skill-forge --help | 显示完整帮助 |
49
+
50
+ 命令别名：list = ls、install = init、upgrade = update。
51
+
52
+ 通用参数（init / update 通用）：
53
+ --target <目录>（-t）：指定技能目录；缺省自动探测常见助手目录（~/.qoder-cn、~/.claude、~/.cursor 等），探测到多个时交互选择
54
+ --skills a,b（-s）：init 时跳过选择直接装指定技能（脚本与单件补装友好）；update 时只升级指定技能
55
+ --yes（-y）：跳过确认直接执行；配置版本变化时默认「保留我的 + 官方版另存 .upstream 对照」
56
+
57
+ ## 三、场景化使用流程
58
+
59
+ 场景一 首次接入（从零到可用）：
60
+ 1、npm i -g skill-forge-hub
61
+ 2、skill-forge ls（先浏览清单，只读）
62
+ 3、skill-forge init（交互挑选）→ 输入 a 全装或编号挑选 → 确认时 s 跳过已装 → 自动探测技能目录 → 完成
63
+ 装完直接对话触发：「写日报」「写周报」「写月报」「写季报」「写年报」「记会议」，或直接丢给它一个文档。
64
+
65
+ 场景二 单件补装（脚本 / 只想要某一个）：
66
+ skill-forge init --skills prompt-pouch --target ~/.qoder-cn/skills
67
+ 跳过挑选环节，只装指定技能到指定目录。
68
+
69
+ 场景三 官方发新版后升级：
70
+ 先 npm update -g skill-forge-hub（升级 CLI 本体），再 skill-forge update（全部）/ skill-forge update --skills daily-report（单个）
71
+ · 配置结构没变：无感升级，user-config.md 原样保留
72
+ · 配置结构变了（CONFIG_VERSION 升了）：先备份 user-config.md.bak-<时间戳>，再三选一——[1] 官方覆盖 / [2] 保留我的（默认，最稳，官方版另存 .upstream 对照文件手动合并）/ [3] 稍后处理
73
+ · 官方删了文件：按 .installed-manifest 安装清单精准清理，你自建的文件一律不动
74
+
75
+ 场景四 非交互 / 自动化：
76
+ skill-forge init --skills daily-report,weekly-report --yes
77
+ --yes 跳过一切确认，配置冲突默认走 [2] 保留我的。
78
+
79
+ 场景五 换机器 / 换 AI 助手：
80
+ 新环境重新 npm i -g skill-forge-hub && skill-forge init；保留个人配置就把旧机器技能目录里的 user-config.md 一并拷过去（升级永不覆盖，覆盖安装时也保留）。
81
+
82
+ ## 四、典型技能使用链路
83
+
84
+ 统一节奏：安装 → 首次生成 → 修改配置 → 官方升级后 → 旧产物回炉。
85
+
86
+ 1、日报（报表族代表）：
87
+ - 安装：skill-forge init --skills daily-report
88
+ - 日常生成：说「写日报」口述内容 → md/txt/html（自动打开）+ 截图
89
+ - 修改配置：user-config.md 改 DIR（落盘目录）/ THEME（五主题）/ TEMPLATE（自定义模板）；临时口头要求当次生效不写配置
90
+ - 官方升级后：配置冲突选 [2] 保留我的，对照 .upstream 合并新配置点
91
+ - 旧产物回炉：模板版本戳升了说「把我旧日报都升级成新样式」——浅升级换样式块、深升级从同目录 md 底稿重建，旧版先备份
92
+
93
+ 2、锦囊 prompt-pouch：
94
+ - 安装：skill-forge init --skills prompt-pouch
95
+ - 首次生成：「做一个锦囊管理页面」→ 生成管理台 html + data/prompts.json 数据文件
96
+ - 日常使用：分组侧栏 / 搜索 / 收藏 / 标签点击过滤 / {变量} 插值一键复制 / 导入导出 JSON 备份；页面与数据分离，删页面不丢数据
97
+ - 修改配置：user-config.md 改 DIR（页面目录）、DATA_DIR / BACKUP_DIR（数据与备份目录）
98
+ - 官方升级后：数据目录与数据文件一概不动；深升级重建沿用原页 pouch-id → 收藏 / 分组照旧读回
99
+ - 页面版本升级（回炉）：模板版本戳升了，下次生成时 AI 主动提示「检测到 X 份旧版锦囊」→ 说「把我旧锦囊都升级成新样式」→ 列清单选全部或部分 → 浅升级换样式块、深升级从模板重建沿用原页 pouch-id（收藏分组照旧读回）；prompts.json 数据不动、旧页先备份 .bak-时间戳
100
+ - 多文件隔离：两份锦囊各自独立（内嵌 ID 命名空间）；复制文件副本 = 同一身份共享同一份数据（要独立身份请重新生成一份）
101
+
102
+ 3、PPT 两形态 magic-deck / deck-stage：
103
+ - 选形态：说「做个 PPT」AI 先问——HTML 幻灯（magic-deck）还是 .pptx 可编辑文稿（deck-stage）
104
+ - HTML 幻灯：magic-deck 生成单文件 HTML 幻灯，浏览器全屏放映（自动播放 / 循环 / 热键翻页）；需要图片时逐页 PNG 截图
105
+ - .pptx 文稿：deck-stage 三问交互（素材 → 页骨架表 → 成片方式）生成 .pptx——常规页原生可编辑（数据卡 / 时间线 / 图表），封面与结尾页 HTML 截图保真
106
+ - 补依赖：deck-stage 依赖 PptxGenJS，npm 包不含 node_modules，装完按提示 cd <技能目录>/deck-stage && npm install 补装一次
107
+ - 修改配置：五主题 / 页面尺寸 / 演讲备注在 user-config.md
108
+
109
+ 4、会议纪要 meeting-minutes：
110
+ - 日常生成：「记会议」口述材料 → 五段式纪要（会议信息 / 会议结论 / 议题讨论 / 决议与行动项 / 下次会议），行动项带负责人与截止时间——日报 / 周报 / 月报 / 季报的汇报链源头
111
+ - 修改配置：SERIES_GROUP 三态——auto 自动提取系列名归入 meetings/{系列名}/、series 一律按系列建目录、off 纯月份平铺；改口机制「以后这个系列叫 XX」永久生效
112
+ - 官方升级后：同报表族——配置三选一保护 + 说「把旧纪要升级成新样式」回炉
113
+
114
+ ## 五、通用小抄
115
+
116
+ | 需求 | 做法 |
117
+ |:---|:---|
118
+ | 换落盘目录 / 主题 / 模板 | 改 user-config.md（升级永不覆盖） |
119
+ | 官方发新版 | skill-forge update，配置冲突选 [2] 保留我的 |
120
+ | 旧产物换新样式 | 说「把我旧 XX 都升级成新样式」 |
121
+ | 装漏技能 | skill-forge init --skills 技能名 |
122
+ | 查全部命令 | skill-forge --help |
123
+ | 问单个技能用法 | 直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出 |
124
+ | 问 SkillForge 本身 | 问「skillforge 怎么用」，AI 朗读本指引并打开排版页 |
125
+ | 查技能双语简介 / 实操文章 | SKILLS_CATALOG.md（21 技能逐条中英简介）/ docs/articles/（实操文章）/ docs/directory-submission.md（目录收录素材） |
126
+
127
+ ## 六、常见问题
128
+
129
+ 1、装完对话没触发技能：确认装进了当前 AI 助手实际读取的技能目录（init 完成时输出的路径）
130
+ 2、deck-stage 报缺依赖：cd <技能目录>/deck-stage && npm install 补装 PptxGenJS 一次即可
131
+ 3、升级后配置会丢吗：不会。user-config.md（与 .preserve 清单内文件）升级永不覆盖，本地修改永久保留
132
+ 4、这份指引在哪：每个技能的 resources/ 目录里都有（skillforge-guide.txt 文字版 + skillforge-guide.html 排版版），官方升级时随技能资源一起更新
package/weekly-report/user-config.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  > 你的个人配置全放在这里。skill-forge 升级技能时官方只更新 SKILL.md 与 resources/，
4
4
  > 本文件始终保留你的版本——落盘目录、格式、角色画像、自定义模板放心改。
5
- > 官方升级若带来新配置点，会另存 `user-config.md.upstream` 对照文件到同目录，
5
+ > 官方升级若带来新配置点，会另存 `user-config.upstream.md` 对照文件到同目录，
6
6
  > 你按需查看并手动合并新配置点到本文件。
7
7
 
8
8