skill-forge-hub 1.0.6 → 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 (134) hide show
  1. package/CHANGELOG.en.md +203 -0
  2. package/CHANGELOG.md +18 -0
  3. package/README.en.md +110 -0
  4. package/README.md +64 -59
  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 +96 -0
  48. package/docs/architecture.md +71 -64
  49. package/docs/install.en.md +125 -0
  50. package/docs/install.md +88 -34
  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 +14 -4
  64. package/meta-forge/resources/forge-rules.md +7 -1
  65. package/meta-forge/resources/skillforge-guide.html +408 -0
  66. package/meta-forge/resources/skillforge-guide.txt +131 -0
  67. package/meta-forge/resources/usage-guide.md +2 -2
  68. package/monthly-report/SKILL.md +10 -0
  69. package/monthly-report/resources/disk-and-html.md +1 -0
  70. package/monthly-report/resources/reference.html +1 -1
  71. package/monthly-report/resources/skillforge-guide.html +408 -0
  72. package/monthly-report/resources/skillforge-guide.txt +131 -0
  73. package/one-pager/SKILL.md +71 -0
  74. package/one-pager/resources/content.md +18 -0
  75. package/one-pager/resources/generate.md +16 -0
  76. package/one-pager/resources/html-rules.md +21 -0
  77. package/one-pager/resources/reference.html +209 -0
  78. package/one-pager/resources/skillforge-guide.html +408 -0
  79. package/one-pager/resources/skillforge-guide.txt +131 -0
  80. package/one-pager/resources/usage-guide.md +23 -0
  81. package/one-pager/user-config.md +11 -0
  82. package/package.json +13 -2
  83. package/prompt-pouch/SKILL.md +12 -1
  84. package/prompt-pouch/resources/reference.html +1 -1
  85. package/prompt-pouch/resources/skillforge-guide.html +408 -0
  86. package/prompt-pouch/resources/skillforge-guide.txt +131 -0
  87. package/quarterly-report/SKILL.md +10 -0
  88. package/quarterly-report/resources/disk-and-html.md +1 -0
  89. package/quarterly-report/resources/reference.html +1 -1
  90. package/quarterly-report/resources/skillforge-guide.html +408 -0
  91. package/quarterly-report/resources/skillforge-guide.txt +131 -0
  92. package/release-notes/SKILL.md +54 -0
  93. package/release-notes/resources/collect.md +17 -0
  94. package/release-notes/resources/publish-checklist.md +11 -0
  95. package/release-notes/resources/skillforge-guide.html +408 -0
  96. package/release-notes/resources/skillforge-guide.txt +131 -0
  97. package/release-notes/resources/usage-guide.md +25 -0
  98. package/release-notes/resources/write.md +27 -0
  99. package/release-notes/user-config.md +15 -0
  100. package/skill-doctor/SKILL.md +53 -0
  101. package/skill-doctor/resources/checks.md +27 -0
  102. package/skill-doctor/resources/report.md +26 -0
  103. package/skill-doctor/resources/skillforge-guide.html +408 -0
  104. package/skill-doctor/resources/skillforge-guide.txt +131 -0
  105. package/skill-doctor/resources/usage-guide.md +22 -0
  106. package/skill-doctor/user-config.md +9 -0
  107. package/spec-doc2spec/SKILL.md +10 -0
  108. package/spec-doc2spec/resources/skillforge-guide.html +408 -0
  109. package/spec-doc2spec/resources/skillforge-guide.txt +131 -0
  110. package/spec-spec2doc/SKILL.md +10 -0
  111. package/spec-spec2doc/resources/skillforge-guide.html +408 -0
  112. package/spec-spec2doc/resources/skillforge-guide.txt +131 -0
  113. package/team-report-collector/SKILL.md +70 -0
  114. package/team-report-collector/resources/collect.md +23 -0
  115. package/team-report-collector/resources/generate.md +14 -0
  116. package/team-report-collector/resources/html-rules.md +22 -0
  117. package/team-report-collector/resources/reference.html +384 -0
  118. package/team-report-collector/resources/skillforge-guide.html +408 -0
  119. package/team-report-collector/resources/skillforge-guide.txt +131 -0
  120. package/team-report-collector/resources/usage-guide.md +25 -0
  121. package/team-report-collector/user-config.md +12 -0
  122. package/twin-docs/SKILL.md +53 -0
  123. package/twin-docs/resources/glossary.md +12 -0
  124. package/twin-docs/resources/skillforge-guide.html +408 -0
  125. package/twin-docs/resources/skillforge-guide.txt +131 -0
  126. package/twin-docs/resources/sync-check.md +15 -0
  127. package/twin-docs/resources/translate.md +20 -0
  128. package/twin-docs/resources/usage-guide.md +24 -0
  129. package/twin-docs/user-config.md +11 -0
  130. package/weekly-report/SKILL.md +10 -0
  131. package/weekly-report/resources/disk-and-html.md +1 -1
  132. package/weekly-report/resources/reference.html +1 -1
  133. package/weekly-report/resources/skillforge-guide.html +408 -0
  134. package/weekly-report/resources/skillforge-guide.txt +131 -0
package/spec-spec2doc/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>
package/spec-spec2doc/resources/skillforge-guide.txt ADDED
@@ -0,0 +1,131 @@
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
+
126
+ ## 六、常见问题
127
+
128
+ 1、装完对话没触发技能：确认装进了当前 AI 助手实际读取的技能目录（init 完成时输出的路径）
129
+ 2、deck-stage 报缺依赖：cd <技能目录>/deck-stage && npm install 补装 PptxGenJS 一次即可
130
+ 3、升级后配置会丢吗：不会。user-config.md（与 .preserve 清单内文件）升级永不覆盖，本地修改永久保留
131
+ 4、这份指引在哪：每个技能的 resources/ 目录里都有（skillforge-guide.txt 文字版 + skillforge-guide.html 排版版），官方升级时随技能资源一起更新
package/team-report-collector/SKILL.md ADDED
@@ -0,0 +1,70 @@
1
+ ---
2
+ name: team-report-collector
3
+ description: 把团队成员日报（今日进展/明日计划/风险阻塞）收集汇总为本地 HTML 收集台与数据文件：单文件离线可用的收集页（表单填写 + localStorage 记忆草稿 + 导出/导入 JSON）、reports.json 数据真相源、按日期分组的汇总 md。当用户请求收日报、团队日报收集、汇总成员日报、日报收集台、收集周报时使用。
4
+ allowed-tools: Bash, Read, Write
5
+ disable-model-invocation: false
6
+ ---
7
+
8
+ # 团队日报收集（team-report-collector）
9
+
10
+ 团队负责人的日报收集台：成员日报口述/文件进 → 汇总去重 → reports.json 数据真相源 + 单文件收集台 HTML + 汇总 md 三件套落盘。
11
+
12
+ ## 生成流程
13
+
14
+ 0. **读用户配置**（TEAM/TITLE/DIR/OPEN_HTML/THEME/REPORT_DATE）→ 先 Read 同目录 `user-config.md`
15
+ 1. **收集数据**（成员日报口述 + 文件批量 + 页面导出 json 导入，合并去重）→ 读 `resources/collect.md`
16
+ 2. **生成产物**（reports.json + 收集台 HTML + 汇总 md，先 Read reference.html 骨架替换数据）→ 读 `resources/generate.md` 与 `resources/html-rules.md` 两份
17
+ 2.5 **交付前自检**（硬门禁不可跳过）：HTML 文件写好后——
18
+ - 挂 pageerror 监听用 Chrome headless 访问页面（零容忍报错）→ 截全页 PNG Read 自查：标题卡、表单卡、汇总列表卡齐全，条目渲染无溢出、无豆腐块缺字
19
+ - 任何报错或视觉问题：修 HTML → 重检；全绿才进第 3 步
20
+ 3. **使用咨询**（用户只问「日报收集怎么用」等用法、未要求收集）→ 读 `resources/usage-guide.md`，将其内容原样输出（首行标题改为「团队日报收集使用指南」），不收集、不落盘、不开浏览器
21
+
22
+ ## ⚙️ 配置与自定义
23
+
24
+ **执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（TEAM/TITLE/DIR/OPEN_HTML/THEME/REPORT_DATE）都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
25
+
26
+ - **THEME**：收集台页面主题，tech 深蓝科技（默认）/ biz 浅色商务 / mono IDEA 黑亮 / light IDEA 白亮 / warm 温暖渐变；生成时写 `<html data-theme="THEME值">` 定默认，页面右下角换肤坞五色点随点随换（localStorage 记忆，键按页内嵌唯一 ID 隔离、多份产物互不串台、改名/移动目录记忆不丢；生成时头部写 `<meta name="trc-id" content="<UUID>">`，每次 crypto.randomUUID() 生成标准 UUID v4（8-4-4-4-12 十六进制，禁止手写变体、禁止沿用占位与旧值）；落盘写文件前顺扫落盘目录下本技能命名的 html，读各文件 id meta 查重，撞号重掷至不重复）
27
+
28
+ ## 配置版本机制（升级保护）
29
+
30
+ 本 skill 当前配置版本为 `1`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明不一致：
31
+
32
+ 1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
33
+ 2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
34
+ 3. 更新 CONFIG_VERSION 为当前版本
35
+ 4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」
36
+
37
+ 升级本 skill 时，配置结构如有变化必须同步更新本节的当前版本号与迁移说明；禁止在未声明版本变更的情况下静默修改配置语义。
38
+ ## 文档同步自检纪律（维护者必读）
39
+
40
+ 修改本 skill 任一文件（SKILL.md / user-config.md / resources/*）后，必须 grep 全文核对相关关键词在各文件间一致（字段名 / 流程节点 / 模板名改名时新旧词全仓核对，旧词零残留才算完成）。
41
+ ## 🔧 报修处理流程（用户报页面问题时）
42
+
43
+ 用户说「这个页面效果不对 / 布局乱了 / 有 UI 问题 / 样式错了 / 交互坏了」（常附截图或指出具体现象）→ 按以下流程处理，不以「重新生成一份」敷衍：
44
+
45
+ 1. **立标准**：先 Read 本 skill 目录 `resources/reference.html`——它就是设计标准答案（布局/配色/交互全在代码里）
46
+ 2. **找问题**：Read 用户那份问题 html 文件，与 reference 逐处比对（结构顺序 / CSS 变量 / 关键类名 / 交互 JS），定位跑偏处；用户给了截图则按截图现象反查
47
+ 3. **修复**：以 reference 为准修复那份 html（只修跑偏处，不动正确内容；reference 与 html 不一致时以 reference 为准）
48
+ 4. **自证**：Chrome headless 访问修复后页面截全页 PNG，Read 自查修复点恢复标准效果
49
+ 5. **汇报**：一句话说清问题根因 + 修复了什么 + 附截图；若根因在 reference.html 自身，顺修 reference.html 对应处并在汇报中说明「参考模板已同步修正」
50
+
51
+
52
+ ## 产物升级（回炉）
53
+
54
+ 生成 HTML 时头部写版本戳 `<meta name="sf-template" content="team-report-collector@1">`（模板升级时递增 @N 并同步 reference.html 与本文档）。用户说「升级旧收集台/回炉」时：扫落盘目录读版本戳筛旧版（无版本戳或缺少 `<meta name="trc-id">` 稳定 ID 的产物视为 v0 最旧版，一并进清单）→ 列清单（文件/旧版本）→ AskUserQuestion 选全部或部分 → 逐份升级：浅升级（仅 CSS/JS 变化）对旧页替换 `<style>` 块与交互脚本、正文原样保留；深升级（DOM 结构变化）从同目录 reports.json 数据按当前 reference.html 重建，先备份旧版 `.bak-时间戳`，重建必须沿用原页 trc-id meta 值（换 ID = 页面运行时收集的本地数据失联）→ 报告三段式：✅ 已升级清单 / ⚠️ 手改保留说明 / 🟡 失败项原因。模板改动分级：业务改动、数据格式改动、页面改动任一发生即模板升级，版本戳 +1 并同步 reference.html 与本文档；纯措辞润色不 bump。每次生成 HTML 时顺扫落盘目录读版本戳：发现旧版产物主动告知用户「说『把我旧收集台都升级成新样式』即可一键升级」。
55
+
56
+ ## 规则速览
57
+
58
+ - 数据真相源：reports.json 为唯一真相源（字段 name/date/progress/plan/risk），md 与 html 都从它重建；页面运行时的新增/修改存 localStorage（键 `trc:<ID>-reports`，内嵌 ID 命名空间，多份产物互不串台），导出 JSON 后才并入真相源
59
+ - 汇总去重：同一成员同一天多条日报合并为一条（进展/计划拼接，风险合并）；日期统一 YYYY-MM-DD
60
+ - 落盘完成后对话必须报告落盘位置：完整路径清单（reports.json + html + md），并注明 html 是否已在浏览器打开
61
+ - 脱敏纪律：页面演示数据与文档示例零真实身份（示例成员用张工/李工等通用占位），页脚署名固定 GENERATED BY AI TEAM
62
+
63
+ ---
64
+
65
+ ## 🔍 SkillForge 使用指引（整体咨询时触发）
66
+
67
+ 当用户询问 **SkillForge 本身**（不是单个技能用法）——「skillforge 怎么用 / 使用说明 / 使用指引 / 是什么」「技能怎么安装 / 怎么升级 / 装了哪些技能 / 技能清单」「skill-forge ls / init / update 等命令怎么用」「技能安装器 / 技能锻造坊」等（中英文、近似说法均可，关键词可自由扩展）：
68
+ 1. Read 同目录 `resources/skillforge-guide.txt` 全文，按其内容整理回答（命令与参数以 txt 为准，勿自行编造）
69
+ 2. 用系统命令打开同目录 `resources/skillforge-guide.html`（macOS `open`，Windows `start`），让用户在浏览器看排版版
70
+ 3. 用户只问单个技能怎么用时（如「日报怎么用」）不触发本指引，走本技能的使用说明