skill-forge-hub 1.0.6 → 1.0.7
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.
- package/CHANGELOG.en.md +194 -0
- package/CHANGELOG.md +9 -0
- package/README.en.md +99 -0
- package/README.md +53 -59
- package/docs/architecture.en.md +95 -0
- package/docs/architecture.md +70 -64
- package/docs/install.en.md +69 -0
- package/docs/install.md +32 -34
- package/meta-forge/SKILL.md +3 -3
- package/meta-forge/resources/forge-rules.md +3 -0
- package/meta-forge/resources/usage-guide.md +2 -2
- package/package.json +4 -2
package/CHANGELOG.en.md
ADDED
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
# CHANGELOG
|
|
2
|
+
|
|
3
|
+
[中文](CHANGELOG.md)
|
|
4
|
+
|
|
5
|
+
Version history of the SkillForge npm package `skill-forge-hub` (command name `skill-forge`).
|
|
6
|
+
|
|
7
|
+
## 1.0.7 (2026-11-12)
|
|
8
|
+
|
|
9
|
+
**Docs split into pure Chinese & English mirrors + meta-forge lessons fully codified**
|
|
10
|
+
|
|
11
|
+
- Docs Chinese/English split: README/docs/CHANGELOG switched from mixed bilingual to pure Chinese + pure English one-to-one mirrors (README.en.md, docs/install.en.md, docs/architecture.en.md, CHANGELOG.en.md — full translation 0.1.0→1.0.6), cross-linked at the top of every document; architecture mechanism table four → eight (CONFIG_VERSION key / user-config extraction / reference dual-track / doc-sync self-check discipline / preserve list / multi-file isolation / infringement-free, desensitized & offline / output reforge upgrades, aligned with the forge-rules numbering); both READMEs drop the outdated "config stays in SKILL.md" wording — config moves out to user-config.md; package.json files gains README.en.md and CHANGELOG.en.md
|
|
12
|
+
- meta-forge lessons fully codified: ① repo registration checklist gains package.json files — the 1.0.5 exam③ lesson (monthly-report/meeting-minutes/quarterly-report missing from the npm package) is now a rule, verified with `npm pack --dry-run` after registration; ② validation ring gains the self-heal double check — static gate A-14 (embedded JS validates the id meta, heals via the path key and writes back, console.warn alert) + runtime test B-5 (break the id meta → reopen heals to a valid v4 + memories recovered via the path key), so mechanism 6's page-level self-healing is now backed by validation; SKILL.md description / flow steps 4-5 / usage-guide / README both languages synced
|
|
13
|
+
|
|
14
|
+
## 1.0.6 (2026-11-12)
|
|
15
|
+
|
|
16
|
+
**meta-forge spec & template alignment: three real-world lessons codified + template modernization**
|
|
17
|
+
|
|
18
|
+
- template/ aligned with the new forge-rules spec: SKILL.md rewritten (step 0 reads user-config, config-version mechanism section, output-reforge section (conditional), doc-sync self-check section, pre-delivery self-check hard gate); new template/user-config.md (CONFIG_VERSION: 1 + protection declaration) and template/resources/usage-guide.md (usage-answer template); README drops the outdated "config must stay in SKILL.md" sentence — config now moves out
|
|
19
|
+
- forge-rules mechanism 3 gains the entry-animation fallback: reference.html with scroll-entry animations (IntersectionObserver + JS gating) must carry a 2s fallback setTimeout that forces everything visible — in environments where IO never fires (headless capture / print preview / PDF export / embedded webviews), cards must never stay permanently hidden (the meeting-minutes 1.0.5 blank-screenshot lesson, codified)
|
|
20
|
+
- forge-rules mechanism 6 gains page-level self-healing: when the id meta is invalid/missing, heal it to a standard UUID v4 via a path key (sf-heal: + pathname) and write it back to the meta, with a console.warn alert — the third line of defense at the execution layer, codified
|
|
21
|
+
- forge-rules mechanism 8 gains user-data specifics: deep-upgrade rebuilds must keep the page's original stable ID meta value (a new ID = data loss), data files are never touched
|
|
22
|
+
- validation ring expanded: static gates gain item 13 (entry-animation fallback check); runtime tests gain item 4 (headless capture proves content complete — a blank capture fails)
|
|
23
|
+
- meta-forge self-alignment: SKILL.md description / flow step 3 / rules summary gain the preserve list and mechanism conditions (HTML gains mechanisms 3-7-8, localStorage memory gains 6, semi-custom assets gain 5); usage-guide mechanism list aligned to the eight forge-rules numbers; user-config.md fixes the newline bug where the CONFIG_VERSION end-of-line comment swallowed the DIR line
|
|
24
|
+
|
|
25
|
+
## 1.0.5 (2026-11-12)
|
|
26
|
+
|
|
27
|
+
**monthly-report joins the forge: four-way report-family disambiguation + deck-stage monthly mapping**
|
|
28
|
+
|
|
29
|
+
- New monthly-report skill: four-section monthly report (monthly overview / key achievements / problems & improvements / next month's plan), differentiated assets — data cards with QoQ subtext (vs last month ±x%, green up red down), W1-W4 week timeline, monthly calendar heatmap (echarts calendar heatmap, CSS-variable-driven five-theme skinning); data collection supports monthly git aggregation + same-caliber last-month comparison + daily heatmap statistics; natural-language month targeting (this month / last month / last 30 days / 2026-10); isomorphic with the three report skills: 12-industry dictionary, custom templates, five-theme deep-blue panel, content-png captures
|
|
30
|
+
- Disambiguation upgrade: daily/weekly/annual SKILL.md cycle-ambiguity routing three-way → four-way (daily / weekly / monthly / annual)
|
|
31
|
+
- deck-stage linkage: report four-piece mapping gains the monthly segment (overview→overview, achievements→timeline W1-W4, problems/plan→bullets, calendar heatmap→chart-heatmap); usage-guide examples gain monthly
|
|
32
|
+
- CLI & docs: cli.js CATEGORIES report showcase includes monthly-report; README category row / skill table / install command synced
|
|
33
|
+
- Real-device: monthly reference.html headless rendering of the four section cards + calendar heatmap + skin dock all pass; content-capture height formula calibrated on real captures (~2020px at 760px width baseline + linear item scaling), fixing the old formula's underestimation truncation
|
|
34
|
+
|
|
35
|
+
**Minutes-series grouping + article save governance + ID uniqueness hardening + four exam fixes + bilingual docs**
|
|
36
|
+
|
|
37
|
+
- Minutes-series grouping: meeting-minutes gains SERIES_GROUP three-state (auto extracts series names into meetings/{series}/, series always uses series dirs, off flat months); series-name extraction rules + illegal-character dir-name cleaning + rename mechanism ("call this series XX" applies now / "always call this series XX" persists) + one-shot organizing command (scan all old minutes → move-plan confirmation → three-part report, empty month dirs kept); CONFIG_VERSION 1→2
|
|
38
|
+
- article-to-html save governance: captures isolated per article as 文章截图/<title-slug>/C00-cover.png (the redundant "chapter captures" layer removed, same-name articles across different docs no longer overwrite each other); DIR configurable (DIR: auto + DIR_MAC default ~/articles + DIR_WIN, nonexistent dir falls back to the user home); same-name different-article slugs append -2/-3; CONFIG_VERSION 1→2
|
|
39
|
+
- ID uniqueness, two hardenings: ① format locked — crypto.randomUUID() standard UUID v4 (8-4-4-4-12 lowercase hex), handwritten variants / reusing placeholders or old values forbidden; ② pre-write collision check — before writing a file, scan the save directory for this skill's html files and read their id metas, re-roll on collision. Three lines of defense: generation rules in 8 SKILL.mds + the "format self-heal block" in 9 reference.html files (invalid/missing meta heals to a valid v4 via a path key, stable reuse across opens on the same path, console.warn alert) + meta-forge forge-rules mechanism sentence & validation ring; Playwright 9/9 real-device pass
|
|
40
|
+
- Four exam fixes: ① quarterly-report user-config CONFIG_VERSION 1→3 (content was already v3-shaped, the version number was never bumped); ② prompt-pouch gains the sf-template@2 version stamp + the SKILL.md "output upgrade (reforge)" section (deep-upgrade rebuilds must keep the original page pouch-id — IndexedDB user data is namespaced by pouch-id, a new ID = data loss; prompts.json data files never touched); ③ package.json files gains monthly-report/meeting-minutes/quarterly-report (the npm package was missing these three skills); ④ meeting-minutes gains the 2s entry-animation fallback setTimeout (environments where IntersectionObserver never fires — headless capture / print preview — suffered permanently hidden cards; aligned with the rest of the report family) + version stamp @2→@3
|
|
41
|
+
- Bilingual docs rework: README rebuilt as a full bilingual mirror + new "output gallery" (6 real screenshots of skill outputs, richly illustrated); split out docs/install.md (both install methods / command reference / upgrade & config-protection mechanics in depth) + docs/architecture.md (directory layout / skill anatomy / four mechanisms / splitting conventions), all Chinese-English mirrored
|
|
42
|
+
|
|
43
|
+
## 1.0.4 (2026-11-11)
|
|
44
|
+
|
|
45
|
+
**Charts echarts-ized + data sources generalized + upgrade mechanism strengthened**
|
|
46
|
+
|
|
47
|
+
- Charts echarts-ized: the weekly/annual four chart types (monthly commit bars / daily commit bars / ring chart / heatmap) switched to CDN echarts rendering (jsdelivr 5.5.1) — five-theme linked skinning, animations stopped in shot capture mode, offline auto-degradation notice (.ech-off hint); fixed the weekly overview DOM nesting (ov-bento nine-child structure restored) and ring center text overflow
|
|
48
|
+
- Data sources generalized: the three reports gain a DATA_SOURCES source list (git repo aggregation / file directory / remote source, three type examples, mac/win dual fields); default templates no longer show real machine paths (~/reports, %USERPROFILE%\reports generic path templates); CONFIG_VERSION 2→3; deck-stage/prompt-pouch template values generalized too; zero real addresses left anywhere in the repo
|
|
49
|
+
- Upgrade mechanism strengthened: ① new .installed-manifest install list — upgrades only clean files the manifest shows the official version deleted, plus now-empty directories; user-created files are never touched (older installs without a manifest skip cleanup and get it written after upgrade); ② article-to-html embeds the .preserve list (design-system.md never overwritten, official updates saved as .upstream companions); ③ meta-forge mechanism 5 — conditional .preserve list embedding spec + validation-list item 4b
|
|
50
|
+
- Verified: upgrade-mechanism three-scenario real-device test, 12 assertions all pass (old-version-no-manifest upgrade / official-file-deletion precise cleanup / user-created & customized file protection)
|
|
51
|
+
|
|
52
|
+
## 1.0.3 (2026-11-11)
|
|
53
|
+
|
|
54
|
+
**Narrow-screen responsive adaptation + default chart animations**
|
|
55
|
+
|
|
56
|
+
- Narrow-screen: the three reports converge at <680px breakpoints (wrap full-width flow, tightened margins, unified 26px h1, clamp 640px floor — no more horizontal overflow); annual monthly-commit chart 12 columns flex-shrink + tip layer first/last column anchoring; weekly daily-commit chart tip long-text wrap width limit; cover page <1280px viewport proportional zoom preview (calc division length÷length type-correct; captures use headless 1280×720, unaffected)
|
|
57
|
+
- Default chart animations: annual monthly-commit bars gain cbGrow growth animation (aligned with weekly); weekly ring chart gains ringSweep sweep stroke (--ring-offset data-driven, animation stops exactly at the target); weekly heatmap gains hmOn staggered lighting (morning/afternoon/evening three batches)
|
|
58
|
+
- Verified: nine viewports (1920→390) zero overflow; cover right edge pixel-precise per viewport; animation timing sampled + mid-state captures accepted; zero pageerrors
|
|
59
|
+
|
|
60
|
+
## 1.0.2 (2026-11-11)
|
|
61
|
+
|
|
62
|
+
**Three reports scroll-entry: off-screen cards float in as they scroll into view**
|
|
63
|
+
|
|
64
|
+
- Scroll-entry: cards initially outside the viewport float up and fade in as they scroll into view (first-screen cards keep the staggered load animation; IntersectionObserver + html.js gating, always fully visible in no-JS / print / capture modes)
|
|
65
|
+
- translate as an independent property, not touching transform — zero conflict with hover 3D tilt; transition-delay cleared after entry so hover stays snappy; stagger 70ms capped at 280ms; 2s fallback force-show
|
|
66
|
+
|
|
67
|
+
## 1.0.1 (2026-11-11)
|
|
68
|
+
|
|
69
|
+
**Post-release triple fix: three reports mono ambience reskin + prompt-pouch four-layer tech ambience + daily/weekly noise fade-out**
|
|
70
|
+
|
|
71
|
+
- Daily/weekly/annual mono ambience reskin: stripes retained in the black theme, colors de-saturated — star dots become neutral gray-white, grid/scan-line/light-band follow --scan-dim using IDEA text-color low-opacity gray-white, body solid #1e1f22 no longer polluted by the blue ambience (previously bluish (38,45,60); after reskin the pure background recovers pixel-perfect (30,31,34), stripe rows gray-white neutral); tech/biz/light/warm ambience unchanged
|
|
72
|
+
- Daily/weekly mono noise layer fade-out: body::before grayscale grain hidden in mono (annual/pouch never had noise), pure background pixel-identical with annual; colored themes keep the noise
|
|
73
|
+
- Prompt-pouch gains four-layer tech ambience: grid/stars/scan-line/light-band from the same source as the three reports (opacity one half-step lighter so reading stays comfortable), cards gain 8px fine horizontal stripes, mono reskinned gray-white
|
|
74
|
+
|
|
75
|
+
## 1.0.0 (2026-11-11)
|
|
76
|
+
|
|
77
|
+
**1.0.0 official release**: through a dozen versions from 0.1.x to 0.5.x, nine skills + the upgrade-protection CLI + the five-theme system are all stable — officially promoted. This release closes three big changes: whole-forge exam with three fixes, CLI init/update mechanism review & repair, prompt-pouch continued forging (two-stage confirmation / full tag interactions / emoji panel / dialog enlargement / background renaming).
|
|
78
|
+
|
|
79
|
+
**Whole-forge exam, three fixes: intent routing + usage guidance + three prompt-pouch features**
|
|
80
|
+
|
|
81
|
+
- Intent routing ①: magic-deck (HTML web slides) and deck-stage (.pptx editable files) gain an "intent boundary" section — when "make a PPT" doesn't specify the form, AskUserQuestion two-way choice, no more two-skill collision; also fixed the magic-deck description's stale "sixteen themes" → "seventeen"
|
|
82
|
+
- Intent routing ②: daily/weekly/annual gain "0.5 cycle-ambiguity routing" — "write a summary / work summary" without a stated cycle triggers an AskUserQuestion three-way choice, never silently defaults
|
|
83
|
+
- Intent routing ③: spec-doc2spec / spec-spec2doc descriptions gain usage-query trigger words (asking "how to use / usage" routes to the usage-guide answer instead of missing the trigger)
|
|
84
|
+
- Usage guidance: article-to-html's usage instructions extracted from SKILL.md into a standalone resources/usage-guide.md ("Article Mounting Master Usage Guide"), aligned with the other 8 forge skills
|
|
85
|
+
- Three prompt-pouch features: ① import/export — top-bar "⤓ export" downloads a full JSON backup (timestamped), "⤒ import" picks a file for whole-library overwrite (auto-backup before import for rollback, import disabled in unauthorized directories); ② tag click filtering — clicking a card tag filters by that tag (top-bar pill shows the current tag, click ✕ or re-click the same tag to cancel, switching groups auto-clears, stacks with search); ③ group sidebar drag sorting — dragging group bars reorders the groups list (authorized directories write through immediately; unauthorized ones produce a "reorder groups to…" instruction for the AI to save)
|
|
86
|
+
|
|
87
|
+
**CLI init/update mechanism review & repair**
|
|
88
|
+
|
|
89
|
+
- Copy excludes impurities: copyDir skips .DS_Store/.git and other metadata files, no longer copied into user directories with skills
|
|
90
|
+
- Upgrade structure sync: new pruneDir — cleans files the official version deleted (and empty directories) before upgrade (historically grow-only stale files no longer linger); user-config.md, .preserve list files, .upstream companions, .bak- backups, node_modules dependencies are all left untouched
|
|
91
|
+
- Three-way [3] differentiation: [3] decide later no longer generates a .upstream companion (truly distinct from [2] keep mine); when the config content matches the official version, old .upstream companions are auto-cleaned
|
|
92
|
+
- deck-stage gains the "config version mechanism (upgrade protection)" section (current required version 2), aligned with the rest of the forge; the whole-repo "four themes" wording unified to five themes (including light IDEA white)
|
|
93
|
+
- prompt-pouch mechanism section gains an explicit "current required version is 4" declaration
|
|
94
|
+
- README upgrade-protection notes synced (three-way [3] semantics + new "structure sync" item)
|
|
95
|
+
|
|
96
|
+
**Prompt-pouch continued forging: batch-organize two-stage confirmation + full tag interactions + emoji quick panel**
|
|
97
|
+
|
|
98
|
+
- Batch-organize upgraded to two-stage confirmation: stage one settles entries (default AI smart tagging — each entry auto-fitted with 1-3 semantic tags, user-editable & deletable + interpolation generalization suggestions) → stage two settles groups (grouping rationale + recommended new group names); few entries (≤3) merge both stages
|
|
99
|
+
- Full tag interactions: card tag hover shows "✕" to delete a single tag, tags under 3 hover shows "+" to quickly add (authorized directories write through immediately, unauthorized produce instructions for the AI); closes the loop with the existing click-to-filter and edit-form tag editing
|
|
100
|
+
- Group dialog emoji quick panel: 95 common emoji preset grid under the icon input (9 columns scrollable, click to fill, current selection highlighted), the input keeps manual typing / pasting any character
|
|
101
|
+
- Group dialog enlargement: width 460→640px, emoji panel font 17→28px, larger grid spacing, taller view (96→200px multi-row), more comfortable
|
|
102
|
+
- mono/light body background renaming: body's three-layer composite background (top glow + grid lines + 160° gradient) becomes theme solid colors — mono solid #1e1f22, light solid #ffffff, removing the "gray-top black-bottom" gradient seam, consistent with the IDE editor area (tech/mint keep their ambience backgrounds)
|
|
103
|
+
|
|
104
|
+
## 0.5.5 (2026-11-11)
|
|
105
|
+
|
|
106
|
+
**Whole-forge theme reskin: IDEA dark + new IDEA light**
|
|
107
|
+
|
|
108
|
+
- mono "black" theme upgraded to IDEA dark (JetBrains New UI Dark official palette): editor/body #1e1f22 + panel/dialog #2b2d30 + border #3c3f41 + text #dfe1e5 + IDEA blue #3574f0, fixing the previous old Darcula palette (#2b2b2b family) mismatch with the IDE look
|
|
109
|
+
- New light "white" theme (IntelliJ Light official palette): white editor #ffffff + light-gray panels #f2f2f2 + border #d1d1d1 + IDEA blue #2675bf
|
|
110
|
+
- Coverage: prompt-pouch (4→5 themes), daily/weekly/annual (4→5), magic-deck (16→17), deck-stage (4→5); skin dock / theme arrays / doc lists all synced
|
|
111
|
+
- article-to-html excluded: its A-set four themes are an "accent color" system, not light/dark semantics; D terminal-geek (black) and C minimal-white (white) are already covered by style variants
|
|
112
|
+
|
|
113
|
+
## 0.5.4 (2026-11-11)
|
|
114
|
+
|
|
115
|
+
**Prompt-pouch interaction polish (SKILL.md)**
|
|
116
|
+
|
|
117
|
+
- Intent recognition & confirmation: explicit pouch-entry trigger phrases (put this passage / this conversation / this file into the pouch, etc.); vague intent ("save this") confirms first; ordinary chat never triggers file operations
|
|
118
|
+
- Existing page three-branch: when creating and the directory already has a page → open existing (recommended) / overwrite rebuild (old page backed up .bak, data dir untouched) / cancel
|
|
119
|
+
- Save confirmation: show the content to be written and wait for user confirmation before writing back ("save directly" skips); group smart matching (semantically matches existing groups and explains why)
|
|
120
|
+
- Interpolation generalization suggestions: on add/organize, detect generalizable concrete words, suggest turning them into {variables} (with rewrite examples and reuse effects), only change with user confirmation
|
|
121
|
+
|
|
122
|
+
## 0.5.3 (2026-11-11)
|
|
123
|
+
|
|
124
|
+
**Prompt-pouch data directory rename: cache/ → data/**
|
|
125
|
+
|
|
126
|
+
- DATA_DIR default `cache` → `data` (semantic rename: the directory holds full data, not cache; "cache" semantics reserved for future true process caches); CONFIG_VERSION v3 → v4
|
|
127
|
+
- Page read-side three-tier fallback: `data/prompts.json` → old default `cache/prompts.json` → root-level old flat files; write side always writes `data/`; page copy all synced
|
|
128
|
+
- Upgrade migration: when the AI finds a v3 old-default cache/ dir → back up, rename-migrate to data/ and inform the user (explicitly customized directory names are respected and left alone)
|
|
129
|
+
|
|
130
|
+
## 0.5.2 (2026-11-11)
|
|
131
|
+
|
|
132
|
+
**Prompt-pouch mono theme reskin to JetBrains Darcula**
|
|
133
|
+
|
|
134
|
+
- From "Linear-style pure black" to the Darcula official palette: background `#2b2b2b` / panel `#3c3f41` / card gradient `#313335` / body blue-gray `#a9b7c6` / border `#4e5254` — dark-gray base + blue-gray text + gray-scale panels, consistent with the JetBrains IDE look, easy on the eyes for long sessions
|
|
135
|
+
- Components fully blue-gray adapted: wand/icon filters, tags, stars, popovers, input area, card inner borders and hover borders, skin-dock color dots
|
|
136
|
+
- Theme names synced: "minimal black-white" → "Darcula dark gray-blue" (SKILL.md / user-config.md / usage-guide.md / skin-dock titles)
|
|
137
|
+
|
|
138
|
+
## 0.5.1 (2026-11-11)
|
|
139
|
+
|
|
140
|
+
**Self-check loop completed** (hard gates before delivery, all four skills covered)
|
|
141
|
+
|
|
142
|
+
- magic-deck: SKILL.md gains "2.5 pre-delivery self-check" (Playwright zero errors + flip through every page + first/middle/last three-page capture self-inspection); new resources/content-guide.md content adaptation manual (content temperament → layout / domain → template packs / page pacing / chart selection)
|
|
143
|
+
- Prompt-pouch: SKILL.md gains "2.5 pre-delivery self-check" (json machine validation + zero page errors + card count equals data count)
|
|
144
|
+
- deck-stage: step 5 validation strengthened into the "pre-delivery self-check" hard gate (slide XML count matches pages, no empty pages)
|
|
145
|
+
- template: new-skill template gains a "3.5 pre-delivery self-check" placeholder (pick check methods by skill type)
|
|
146
|
+
|
|
147
|
+
## 0.5.0 (2026-11-11)
|
|
148
|
+
|
|
149
|
+
**New**
|
|
150
|
+
|
|
151
|
+
- **deck-stage joins the forge**: reports / materials → professional .pptx stage decks — three-question interaction (materials → page skeleton table → build method), regular pages natively editable (data cards / timelines / bar charts / pie charts / line charts), cover & closing pages captured losslessly from HTML, speaker notes per page; visuals share the same source as the reports (tech/biz/mono/warm four themes)
|
|
152
|
+
- magic-deck "💼 domain" tab gains 21 template packs (six categories, one-click full deck generation, two-stage confirmation with undo)
|
|
153
|
+
- magic-deck gains resources/usage-guide.md (usage-answer source), hooked at SKILL.md step 4
|
|
154
|
+
|
|
155
|
+
**Improvements**
|
|
156
|
+
|
|
157
|
+
- Prompt-pouch time fields precise to the second (cards / detail timeline / AI copy)
|
|
158
|
+
- Prompt-pouch default save structure: data & backups subdirectorized (`cache/prompts.json` + `backup/` rolling backups), `DATA_DIR` / `BACKUP_DIR` configurable, old flat structure still readable
|
|
159
|
+
- Prompt-pouch sidebar partial scrolling (favorites + groups scroll when groups are many; "all" / new group / usage stay fixed) + wider dialog + backup-area buttons no wrap
|
|
160
|
+
- magic-deck template panel dialog widened; "profession" wording unified to "domain" (more general, fits six categories)
|
|
161
|
+
- CLI: init/update run dependency detection for skills with a package.json (prompts npm install when node_modules missing)
|
|
162
|
+
- README rewritten: full command reference (complete flag tables), deck-stage registered, directory layout fully updated, stale copy fixed
|
|
163
|
+
|
|
164
|
+
**Fixes**
|
|
165
|
+
|
|
166
|
+
- **npm package content omission**: 0.4.0's `files` list missed prompt-pouch (the package had no pouch), fixed and deck-stage added
|
|
167
|
+
|
|
168
|
+
## 0.4.0 (2026-11-10)
|
|
169
|
+
|
|
170
|
+
- magic-deck template runtime switching: toolbar "🎨 templates" panel five layouts click-to-apply (all pages / this page only / checked pages), titles auto-mapped, switching back to classic business restores without losing content
|
|
171
|
+
- Prompt-pouch time fields: createdAt / updatedAt saved and displayed
|
|
172
|
+
- Report skills' outward wording de-git-ified: multi-source data reworded as a paragraph / file descriptions / images / verbal additions, fitting all industries
|
|
173
|
+
- Prompt-pouch default save directory migrated to MyWork/prompt-pouch (html/json/backups collected in one directory)
|
|
174
|
+
|
|
175
|
+
## 0.3.0 (2026-11-09)
|
|
176
|
+
|
|
177
|
+
- magic-deck magic slide deck joins the forge (16:9 stage + playback engine + templates & themes + page-select captures + fullscreen presentation)
|
|
178
|
+
- meta-forge meta-smithy joins the forge (the skill that forges skills, four mechanisms self-referential)
|
|
179
|
+
- Three-piece mechanism backfill: CONFIG_VERSION key, reference dual-track, self-check discipline
|
|
180
|
+
- spec-doc2spec / spec-spec2doc fully detached from Speccore, reborn as standalone Pandoc-centric skills (detection & install guidance + AI proofreading loop), config extracted to user-config
|
|
181
|
+
- Three-piece professional reporting conventions (conclusion-first, risk four-ring, value translation) + HTML effect layer upgrade
|
|
182
|
+
|
|
183
|
+
## 0.2.0 (2026-11-08)
|
|
184
|
+
|
|
185
|
+
- New annual-report skill (five sections, industry-agnostic skeleton)
|
|
186
|
+
- Upgrade protection: user-config.md config extraction + copyDir preserve list + .preserve list
|
|
187
|
+
- Daily & weekly whole-page content-area captures + meteor progress-bar particle polish
|
|
188
|
+
- spec-doc2spec / spec-spec2doc advanced upgrade with resources volumes
|
|
189
|
+
|
|
190
|
+
## 0.1.0 (2026-11-06)
|
|
191
|
+
|
|
192
|
+
- First npm release: `skill-forge-hub` (command name `skill-forge`), zero-dependency Node>=14
|
|
193
|
+
- CLI: ls list / init interactive multi-select install (auto-detects common AI assistant skill directories, supports --target/--skills)
|
|
194
|
+
- Skills included: daily-report, weekly-report, article-to-html, spec-doc2spec, spec-spec2doc
|
package/CHANGELOG.md
CHANGED
|
@@ -1,7 +1,16 @@
|
|
|
1
1
|
# CHANGELOG
|
|
2
2
|
|
|
3
|
+
[English](CHANGELOG.en.md)
|
|
4
|
+
|
|
3
5
|
SkillForge（技能锻造坊）npm 包 `skill-forge-hub`（命令名 `skill-forge`）版本变更记录。
|
|
4
6
|
|
|
7
|
+
## 1.0.7（2026-11-12）
|
|
8
|
+
|
|
9
|
+
**文档中英分离 + meta-forge 坑教训全量入规**
|
|
10
|
+
|
|
11
|
+
- 文档中英分离：README/docs/CHANGELOG 由中英混排改为纯中文 + 纯英文一一对应（README.en.md、docs/install.en.md、docs/architecture.en.md、CHANGELOG.en.md，全量英译 0.1.0→1.0.6），每份文档顶部互相链接切换；architecture 机制表四大 → 八大（CONFIG_VERSION 钥匙 / user-config 抽离 / reference 双轨 / 自检纪律 / preserve 保护清单 / 多文件隔离 / 零侵权脱敏离线 / 产物升级回炉，与 forge-rules 编号对齐）；README 两版「配置留在 SKILL.md」旧表述改为配置出站 user-config.md；package.json files 补 README.en.md 与 CHANGELOG.en.md
|
|
12
|
+
- meta-forge 坑教训入规补全：①仓库登记清单补 package.json files——1.0.5 体检③教训（漏 monthly-report/meeting-minutes/quarterly-report 三技能，装包却无技能）正式入规，登记后跑 `npm pack --dry-run` 验证；②验证环补自愈块双检查——静态门禁 A-14（HTML 内嵌 JS 含 id meta 校验 + 路径键自愈回写 + console.warn 报警）+ 运行时实测 B-5（改坏 id meta → 重开自愈为合法 v4 + 记忆经路径键恢复），机制六执行层自愈从此有验证兜底；SKILL.md description/流程第 4-5 步/usage-guide/README 中英文同步
|
|
13
|
+
|
|
5
14
|
## 1.0.6（2026-11-12）
|
|
6
15
|
|
|
7
16
|
**meta-forge 规范与模板对齐：三大实战教训入规 + template 模板现代化**
|
package/README.en.md
ADDED
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
# SkillForge · Skill Smithy
|
|
2
|
+
|
|
3
|
+
[中文](README.md)
|
|
4
|
+
|
|
5
|
+
> A workshop that gathers "AI craft" in one place — forging day-in, day-out repetitive labor into handy tools summonable by a single sentence. Every skill in the forge is a set of crafting instructions written for AI: one natural-language phrase calls it up, and it produces standardized output following a fixed procedure. The craft is host-agnostic — swap a thin frontmatter envelope and the same skill travels from one AI assistant to another.
|
|
6
|
+
|
|
7
|
+
Every skill enters through SKILL.md — the frontmatter, the generation flow, and the config pointer (user-editable config lives in user-config.md, read before every run) stay at the entry, while heavy content is split into resources/ by generation stage (or flat helper files such as design-system.md and scripts/). The AI reads each part only when it reaches that stage, keeping the resident context footprint small.
|
|
8
|
+
|
|
9
|
+
## Output Gallery
|
|
10
|
+
|
|
11
|
+
All of the following are real screenshots of actual output produced by these skills.
|
|
12
|
+
|
|
13
|
+
<table>
|
|
14
|
+
<tr>
|
|
15
|
+
<td align="center" width="50%">
|
|
16
|
+
<img src="docs/images/daily-report.png" alt="Daily report output page" width="100%"/><br/>
|
|
17
|
+
<sub>Daily report output page (task progress / tomorrow's plan / risks & blockers, three-section cards)</sub>
|
|
18
|
+
</td>
|
|
19
|
+
<td align="center" width="50%">
|
|
20
|
+
<img src="docs/images/meeting-minutes.png" alt="Meeting minutes output page" width="100%"/><br/>
|
|
21
|
+
<sub>Meeting minutes output page (meeting info / conclusions / agenda / action items, five-section cards)</sub>
|
|
22
|
+
</td>
|
|
23
|
+
</tr>
|
|
24
|
+
<tr>
|
|
25
|
+
<td align="center" width="50%">
|
|
26
|
+
<img src="docs/images/article-to-html.png" alt="Article mounting output page" width="100%"/><br/>
|
|
27
|
+
<sub>Article mounting output page (dark cover + componentized body, charts redrawn as vectors)</sub>
|
|
28
|
+
</td>
|
|
29
|
+
<td align="center" width="50%">
|
|
30
|
+
<img src="docs/images/magic-deck.png" alt="Magic slide deck cover" width="100%"/><br/>
|
|
31
|
+
<sub>Magic slide deck cover (16:9 stage, presentation + templates + themes)</sub>
|
|
32
|
+
</td>
|
|
33
|
+
</tr>
|
|
34
|
+
<tr>
|
|
35
|
+
<td align="center" width="50%">
|
|
36
|
+
<img src="docs/images/deck-stage.png" alt="Deck-stage PPTX cover page" width="100%"/><br/>
|
|
37
|
+
<sub>Deck-stage PPTX cover page (lossless HTML capture, natively editable pages)</sub>
|
|
38
|
+
</td>
|
|
39
|
+
<td align="center" width="50%">
|
|
40
|
+
<img src="docs/images/prompt-pouch.png" alt="Prompt pouch management console" width="100%"/><br/>
|
|
41
|
+
<sub>Prompt pouch management console (groups / search / favorites / tags / import & export)</sub>
|
|
42
|
+
</td>
|
|
43
|
+
</tr>
|
|
44
|
+
</table>
|
|
45
|
+
|
|
46
|
+
## Skill Categories
|
|
47
|
+
|
|
48
|
+
Skills are grouped by "what they ultimately produce" — one skill belongs to exactly one category. Categories exist only for repository organization and navigation; installation always copies skills flat into the target AI assistant's skill directory, regardless of category.
|
|
49
|
+
|
|
50
|
+
| Category | Description | Skills |
|
|
51
|
+
|:---|:---|:---|
|
|
52
|
+
| Report showcase | Multi-source data assembly (a paragraph, descriptions in files, images & materials, verbal additions — anything becomes copy) into periodic reports (daily / weekly / monthly / quarterly / annual) | daily-report, weekly-report, monthly-report, quarterly-report, annual-report |
|
|
53
|
+
| Document mounting | Document conversion & beautification: Word / Markdown / plain text → polished HTML + per-chapter screenshots | article-to-html |
|
|
54
|
+
| Engineering efficiency | Pandoc-based document ↔ spec conversion (requirement slicing / spec export to Word·PDF): mechanical Pandoc conversion + AI proofreading against errors | spec-doc2spec, spec-spec2doc |
|
|
55
|
+
| Presentation showcase | From content to presentation: HTML-form magic slides (playback + templates + themes) and .pptx stage decks (natively editable pages + cover captures) | magic-deck, deck-stage |
|
|
56
|
+
| Data preparation | Excel / CSV / charts, data cleaning & template organizing (planned) | (planned) |
|
|
57
|
+
| Communication & collaboration | Meeting minutes (action items with owners and deadlines, the source of the reporting chain) and prompt management (prompt-pouch local console) | meeting-minutes, prompt-pouch |
|
|
58
|
+
| Skill crafting | The meta skill that forges skills themselves (create skills / plugins) | meta-forge |
|
|
59
|
+
|
|
60
|
+
## Skill List
|
|
61
|
+
|
|
62
|
+
| Skill | Category | Directory | Description |
|
|
63
|
+
|:---|:---|:---|:---|
|
|
64
|
+
| daily-report | Report showcase | [daily-report/](daily-report/) | Multi-source daily reports (today's task progress / tomorrow's plan / risks & blockers): a paragraph, descriptions in files, images, or verbal additions all work; natural-language dates (today / yesterday / last Wednesday / Oct 20); consecutive multi-day batch; custom templates; 12-industry dictionary |
|
|
65
|
+
| weekly-report | Report showcase | [weekly-report/](weekly-report/) | Multi-source weekly reports (this week's conclusion + task progress / next week's plan / risks & blockers + weekly overview card); configurable week end (default Friday); natural-language week targeting (this week / last week / 2nd week of October / holiday-anchored) |
|
|
66
|
+
| monthly-report | Report showcase | [monthly-report/](monthly-report/) | Multi-source monthly reports (four sections: monthly overview / key achievements / problems & improvements / next month's plan); developer users can aggregate the month's git commits; 12-industry dictionary, custom templates, natural-language month targeting |
|
|
67
|
+
| quarterly-report | Report showcase | [quarterly-report/](quarterly-report/) | Multi-source quarterly summaries (four sections: quarter overview / key achievements / problems & improvements / next quarter's plan): core data cards with QoQ (vs last quarter) and YoY (vs last year) dual baselines, overview includes a Q1–Q4 trend chart; achievements in an M1/M2/M3 monthly timeline; 12-industry dictionary, custom templates |
|
|
68
|
+
| annual-report | Report showcase | [annual-report/](annual-report/) | Multi-source annual summaries (five sections: year overview / core achievements / experience & growth / shortcomings & reflection / new-year plan): full-year git commit aggregation + verbal input; 12-industry dictionary, custom templates, natural-language year targeting |
|
|
69
|
+
| article-to-html | Document mounting | [article-to-html/](article-to-html/) | Word / Markdown / plain text → polished standalone HTML (Source Han Sans SC + Roboto, both free for commercial use; charts redrawn with HTML/CSS), per-chapter screenshots (Retina 2x); a ready-made HTML file can be captured directly or beautified first |
|
|
70
|
+
| spec-doc2spec | Engineering efficiency | [spec-doc2spec/](spec-doc2spec/) | Word / Markdown requirement docs → structured requirement slices (thin entry + resources volumes); auto-detects Pandoc and guides cross-platform installation when missing |
|
|
71
|
+
| spec-spec2doc | Engineering efficiency | [spec-spec2doc/](spec-spec2doc/) | Markdown specs → Word / PDF deliverables; auto-detects Pandoc and guides cross-platform installation when missing; dual PDF paths (xelatex / Chrome print fallback) |
|
|
72
|
+
| magic-deck | Presentation showcase | [magic-deck/](magic-deck/) | Content → single-file HTML slide deck (16:9 stage + playback engine + sixteen layout templates + seventeen themes + 21 domain template packs + five chart animations + animation library + fullscreen pure-playback mode): autoplay/loop/interval, keyboard hotkeys, in-page links, per-page PNG captures and body copying |
|
|
73
|
+
| deck-stage | Presentation showcase | [deck-stage/](deck-stage/) | Reports / materials → professional .pptx stage decks: three-question interaction (materials → page skeleton table → build method), regular pages natively editable (data cards / timelines / bar charts / pie charts / line charts), cover & closing pages captured losslessly from HTML, speaker notes per page; visuals share the same source as the report family (tech/biz/mono/light/warm five themes) |
|
|
74
|
+
| meta-forge | Skill crafting | [meta-forge/](meta-forge/) | The meta skill: forges complete skill packages from requirements (thin entry + resources split + user-config), auto-embeds the eight mechanisms (CONFIG_VERSION key / user-config extraction / reference dual-track / doc-sync self-check discipline / preserve list / multi-file isolation / infringement-free, desensitized & offline / output reforge upgrades), auto-registers in the README category table, cli.js CATEGORIES and package.json files on repo entry (no skill missing from the npm package) |
|
|
75
|
+
| meeting-minutes | Communication & collaboration | [meeting-minutes/](meeting-minutes/) | Multi-source meeting minutes (five sections: meeting info / conclusions / agenda discussion / resolutions & action items / next meeting): action items with owners and deadlines (source of the reporting chain, citable by daily/weekly/monthly/quarterly reports); built-in 12 meeting-type dictionaries, custom templates |
|
|
76
|
+
| prompt-pouch | Communication & collaboration | [prompt-pouch/](prompt-pouch/) | Prompt management console: generates and maintains a local HTML management page (group sidebar / search / drag & button sorting / favorites / {variable} interpolation / one-click copy / full tag interactions / JSON import & export / group emoji quick panel), data stored in data/prompts.json with rolling backups in backup/, page and data separated, dual-hand collaboration (direct page edits + AI writing) |
|
|
77
|
+
|
|
78
|
+
## Quick Start
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
npm i -g skill-forge-hub # global install
|
|
82
|
+
skill-forge ls # list all skills (read-only)
|
|
83
|
+
skill-forge init # interactive skill picker, auto-detects & installs to your AI assistant's skill directory
|
|
84
|
+
skill-forge update # upgrade installed skills (config-version aware, local config protected)
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
After installation, just say "write a daily report", "write a weekly report", "write a monthly report", "write a quarterly report", "write an annual report", "take meeting minutes", or hand it a document to trigger a skill; asking "how do I use daily-report / meeting-minutes / deck-stage" prints the usage guide.
|
|
88
|
+
|
|
89
|
+
## Documentation
|
|
90
|
+
|
|
91
|
+
| Document | Content |
|
|
92
|
+
|:---|:---|
|
|
93
|
+
| [docs/install.en.md](docs/install.en.md) | Installation & upgrade in depth: both install methods, command reference, upgrade & config-protection mechanics, maintainer conventions (CONFIG_VERSION bump rules). Chinese version [docs/install.md](docs/install.md) |
|
|
94
|
+
| [docs/architecture.en.md](docs/architecture.en.md) | Architecture & conventions: directory layout, skill anatomy (thin entry + resources), the eight mechanisms, splitting conventions, general principles. Chinese version [docs/architecture.md](docs/architecture.md) |
|
|
95
|
+
| [CHANGELOG.en.md](CHANGELOG.en.md) | Version changelog. Chinese version [CHANGELOG.md](CHANGELOG.md) |
|
|
96
|
+
|
|
97
|
+
## License
|
|
98
|
+
|
|
99
|
+
[MIT](LICENSE)
|
package/README.md
CHANGED
|
@@ -1,105 +1,99 @@
|
|
|
1
1
|
# SkillForge · 技能锻造坊
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
**SkillForge** is a curated collection of AI craft skills — repetitive daily work, forged into tools that answer with a single command. Each skill is a set of craft instructions written for the AI: one natural-language request sets it in motion, and a polished, standardized deliverable comes out the other end. The craft is host-agnostic — a thin frontmatter envelope is all it takes to carry it from one AI assistant to another.
|
|
3
|
+
[English](README.en.md)
|
|
6
4
|
|
|
7
|
-
|
|
5
|
+
> 一处集中收纳「AI 手艺」的工坊——把日复一日的重复劳作，锻造成一句指令就能完成的顺手工具。坊中每一件技能都是一份写给 AI 的手艺说明，一句自然语言即可唤起，按既定工序产出标准化成果；手艺与宿主无关——换一份薄薄的 frontmatter 信封，就能从一位 AI 助手带去另一位。
|
|
8
6
|
|
|
9
|
-
|
|
7
|
+
所有技能均以 SKILL.md 为入口——frontmatter、生成流程、配置指引（用户可改配置出站在 user-config.md，执行前先读）留在入口，重内容按生成阶段拆到 resources/ 或平铺辅助文件（如 design-system.md、scripts/），AI 执行到对应阶段才读取，降低常驻上下文占用。
|
|
10
8
|
|
|
11
|
-
## 产物画廊
|
|
9
|
+
## 产物画廊
|
|
12
10
|
|
|
13
|
-
以下均为各技能产出的真实成品截图。
|
|
11
|
+
以下均为各技能产出的真实成品截图。
|
|
14
12
|
|
|
15
13
|
<table>
|
|
16
14
|
<tr>
|
|
17
15
|
<td align="center" width="50%">
|
|
18
|
-
<img src="docs/images/daily-report.png" alt="日报成品页
|
|
19
|
-
<sub>日报成品页（任务进度 / 明日计划 /
|
|
16
|
+
<img src="docs/images/daily-report.png" alt="日报成品页" width="100%"/><br/>
|
|
17
|
+
<sub>日报成品页（任务进度 / 明日计划 / 风险阻塞三段卡）</sub>
|
|
20
18
|
</td>
|
|
21
19
|
<td align="center" width="50%">
|
|
22
|
-
<img src="docs/images/meeting-minutes.png" alt="会议纪要成品页
|
|
23
|
-
<sub>会议纪要成品页（会议信息 / 结论 / 议题 /
|
|
20
|
+
<img src="docs/images/meeting-minutes.png" alt="会议纪要成品页" width="100%"/><br/>
|
|
21
|
+
<sub>会议纪要成品页（会议信息 / 结论 / 议题 / 行动项五段卡）</sub>
|
|
24
22
|
</td>
|
|
25
23
|
</tr>
|
|
26
24
|
<tr>
|
|
27
25
|
<td align="center" width="50%">
|
|
28
|
-
<img src="docs/images/article-to-html.png" alt="文档装裱成品页
|
|
29
|
-
<sub>文档装裱成品页（暗色封面 +
|
|
26
|
+
<img src="docs/images/article-to-html.png" alt="文档装裱成品页" width="100%"/><br/>
|
|
27
|
+
<sub>文档装裱成品页（暗色封面 + 组件化正文，图表矢量重绘）</sub>
|
|
30
28
|
</td>
|
|
31
29
|
<td align="center" width="50%">
|
|
32
|
-
<img src="docs/images/magic-deck.png" alt="魔法幻灯封面
|
|
33
|
-
<sub>魔法幻灯封面（16:9 舞台，放映 + 模板 +
|
|
30
|
+
<img src="docs/images/magic-deck.png" alt="魔法幻灯封面" width="100%"/><br/>
|
|
31
|
+
<sub>魔法幻灯封面（16:9 舞台，放映 + 模板 + 主题）</sub>
|
|
34
32
|
</td>
|
|
35
33
|
</tr>
|
|
36
34
|
<tr>
|
|
37
35
|
<td align="center" width="50%">
|
|
38
|
-
<img src="docs/images/deck-stage.png" alt="登台 PPTX 封面页
|
|
39
|
-
<sub>登台 PPTX 封面页（HTML
|
|
36
|
+
<img src="docs/images/deck-stage.png" alt="登台 PPTX 封面页" width="100%"/><br/>
|
|
37
|
+
<sub>登台 PPTX 封面页（HTML 保真截图，原生可编辑页）</sub>
|
|
40
38
|
</td>
|
|
41
39
|
<td align="center" width="50%">
|
|
42
|
-
<img src="docs/images/prompt-pouch.png" alt="锦囊提示词管理台
|
|
43
|
-
<sub>锦囊提示词管理台（分组 / 搜索 / 收藏 / 标签 /
|
|
40
|
+
<img src="docs/images/prompt-pouch.png" alt="锦囊提示词管理台" width="100%"/><br/>
|
|
41
|
+
<sub>锦囊提示词管理台（分组 / 搜索 / 收藏 / 标签 / 导入导出）</sub>
|
|
44
42
|
</td>
|
|
45
43
|
</tr>
|
|
46
44
|
</table>
|
|
47
45
|
|
|
48
|
-
## 技能分类
|
|
46
|
+
## 技能分类
|
|
49
47
|
|
|
50
48
|
按「技能最终产出什么」归类，一个技能只归一类；分类只用于本仓库组织与导航，安装时始终平铺复制到目标 AI 助手的技能目录，与分类无关。
|
|
51
49
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
| 分类 Category | 说明（中） Description | 收录技能 Skills |
|
|
50
|
+
| 分类 | 说明 | 收录技能 |
|
|
55
51
|
|:---|:---|:---|
|
|
56
|
-
|
|
|
57
|
-
|
|
|
58
|
-
|
|
|
59
|
-
|
|
|
60
|
-
|
|
|
61
|
-
|
|
|
62
|
-
|
|
|
52
|
+
| 报表汇演 | 多源数据整理（一段文字 / 文件里的描述 / 图片与素材 / 口头补充，什么材料都能成稿），按周期产出报告（日报 / 周报 / 月报 / 季报 / 年报） | daily-report、weekly-report、monthly-report、quarterly-report、annual-report |
|
|
53
|
+
| 文档装裱 | 文档转换与美化：Word / Markdown / 纯文本 → 精美 HTML + 逐章截图 | article-to-html |
|
|
54
|
+
| 工程提效 | 基于 Pandoc 的文档 ↔ 规格互转（需求文档切片 / 规格导出 Word·PDF），Pandoc 机械转换 + AI 校对防错 | spec-doc2spec、spec-spec2doc |
|
|
55
|
+
| 演示汇演 | 从内容到演示：HTML 形态的魔法幻灯（放映 + 模板 + 主题）与 .pptx 登台文稿（原生可编辑页 + 封面截图） | magic-deck、deck-stage |
|
|
56
|
+
| 数据整备 | Excel / CSV / 图表、数据清洗与模板整理（规划中） | （规划中） |
|
|
57
|
+
| 沟通协作 | 会议纪要（行动项带负责人与截止时间，汇报链源头）与提示词管理（锦囊本地管理台） | meeting-minutes、prompt-pouch |
|
|
58
|
+
| 技能自造 | 锻造技能本身的元技能（创建技能 / 插件） | meta-forge |
|
|
63
59
|
|
|
64
|
-
## 技能清单
|
|
60
|
+
## 技能清单
|
|
65
61
|
|
|
66
|
-
| 技能
|
|
62
|
+
| 技能 | 分类 | 目录 | 说明 |
|
|
67
63
|
|:---|:---|:---|:---|
|
|
68
|
-
| daily-report | 报表汇演
|
|
69
|
-
| weekly-report | 报表汇演
|
|
70
|
-
| monthly-report | 报表汇演
|
|
71
|
-
| quarterly-report | 报表汇演
|
|
72
|
-
| annual-report | 报表汇演
|
|
73
|
-
| article-to-html | 文档装裱
|
|
74
|
-
| spec-doc2spec | 工程提效
|
|
75
|
-
| spec-spec2doc | 工程提效
|
|
76
|
-
| magic-deck | 演示汇演
|
|
77
|
-
| deck-stage | 演示汇演
|
|
78
|
-
| meta-forge | 技能自造
|
|
79
|
-
| meeting-minutes | 沟通协作
|
|
80
|
-
| prompt-pouch | 沟通协作
|
|
81
|
-
|
|
82
|
-
## 快速开始
|
|
64
|
+
| daily-report | 报表汇演 | [daily-report/](daily-report/) | 多源数据生成日报（今日任务进度/明日计划/风险阻塞点）：一段文字、文件里的描述、图片或口头补充皆可成稿；支持自然语言日期（今天/昨天/上周三/10月20号）、连续多日批量、自定义模板、12 行业词条 |
|
|
65
|
+
| weekly-report | 报表汇演 | [weekly-report/](weekly-report/) | 多源数据生成周报（本周结论 + 本周任务进度/下周计划/风险阻塞点 + 本周概览卡）；周结束日可配置（默认周五），支持自然语言周定位（本周/上周/10月第2周/节假日锚定） |
|
|
66
|
+
| monthly-report | 报表汇演 | [monthly-report/](monthly-report/) | 多源数据生成月报（四段式：月度概览/本月关键成果/问题与改进/下月计划），开发类用户可聚合当月 git 提交；12 行业职业词典，支持自定义模板与自然语言月份定位 |
|
|
67
|
+
| quarterly-report | 报表汇演 | [quarterly-report/](quarterly-report/) | 多源数据生成季度总结（四段式：季度概览/季度关键成果/问题与改进/下季度计划）：核心数据卡带环比（较上季度）+ 同比（较去年同期）双基准，概览附 Q1-Q4 季度走势图；成果段按 M1/M2/M3 月时间线；12 行业职业词典，支持自定义模板 |
|
|
68
|
+
| annual-report | 报表汇演 | [annual-report/](annual-report/) | 多源数据生成年度总结（五段式：年度概览/核心成果/经验成长/不足反思/新年规划）：git 全年提交聚合 + 会话口述；12 行业职业词典，支持自定义模板与自然语言年度定位 |
|
|
69
|
+
| article-to-html | 文档装裱 | [article-to-html/](article-to-html/) | Word / Markdown / 纯文本 → 精美独立 HTML（思源黑体 + Roboto 商用免费字体，图表 HTML/CSS 重绘），逐章截图（Retina 2x）；现成 HTML 可直接截图或先美化 |
|
|
70
|
+
| spec-doc2spec | 工程提效 | [spec-doc2spec/](spec-doc2spec/) | Word / Markdown 需求文档转结构化需求切片（薄入口 + resources 分册）；自动检测 Pandoc，未装引导跨系统安装 |
|
|
71
|
+
| spec-spec2doc | 工程提效 | [spec-spec2doc/](spec-spec2doc/) | Markdown 规格导出为 Word / PDF 交付文档；自动检测 Pandoc，未装引导跨系统安装；PDF 双路径（xelatex / Chrome 打印兜底） |
|
|
72
|
+
| magic-deck | 演示汇演 | [magic-deck/](magic-deck/) | 内容 → 单文件 HTML 幻灯（16:9 舞台 + 播放引擎 + 十六套版式模板 + 十七套主题 + 领域成套模板 21 套 + 图表动画五式 + 动画库 + 全屏放映纯净模式）：自动播放/循环/间隔、键盘热键、页内连接、逐页 PNG 截图与主体复制 |
|
|
73
|
+
| deck-stage | 演示汇演 | [deck-stage/](deck-stage/) | 报告/素材 → 专业 .pptx 登台文稿：三问交互（素材 → 页骨架表 → 成片方式），常规页原生可编辑（数据卡/时间线/柱图/饼图/折线），封面与结尾页 HTML 截图保真，每页可带演讲备注；视觉与报表同源（tech/biz/mono/light/warm 五主题） |
|
|
74
|
+
| meta-forge | 技能自造 | [meta-forge/](meta-forge/) | 元技能：从需求出发锻造完整技能包（薄入口 + resources 拆分 + user-config），自动植入八大机制（CONFIG_VERSION 钥匙 / user-config 抽离 / reference 双轨 / 自检纪律 / preserve 保护清单 / 多文件隔离 / 零侵权脱敏离线 / 产物升级回炉），入仓库时自动登记 README 分类表、cli.js CATEGORIES 与 package.json files（npm 包内容不遗漏） |
|
|
75
|
+
| meeting-minutes | 沟通协作 | [meeting-minutes/](meeting-minutes/) | 多源材料生成会议纪要（五段式：会议信息/会议结论/议题讨论/决议与行动项/下次会议）：行动项带负责人与截止时间（汇报链源头，可被日报/周报/月报/季报引用）；内置 12 类会议类型词典，支持自定义模板 |
|
|
76
|
+
| prompt-pouch | 沟通协作 | [prompt-pouch/](prompt-pouch/) | 锦囊提示词管理台：生成并维护本地 HTML 管理页面（分组侧栏/搜索/拖拽与按钮排序/收藏/{变量}插值/一键复制/标签全交互/导入导出 JSON 备份/分组 emoji 快捷面板），数据存 data/prompts.json、滚动备份在 backup/ 子目录，页面与数据分离，双笔协作（页面直写 + AI 代笔） |
|
|
77
|
+
|
|
78
|
+
## 快速开始
|
|
83
79
|
|
|
84
80
|
```bash
|
|
85
|
-
npm i -g skill-forge-hub # 全局安装
|
|
86
|
-
skill-forge ls #
|
|
87
|
-
skill-forge init # 交互式挑选技能，自动探测并安装到 AI 助手技能目录
|
|
88
|
-
skill-forge update #
|
|
81
|
+
npm i -g skill-forge-hub # 全局安装
|
|
82
|
+
skill-forge ls # 列出全部技能（只读）
|
|
83
|
+
skill-forge init # 交互式挑选技能，自动探测并安装到 AI 助手技能目录
|
|
84
|
+
skill-forge update # 升级已安装技能（配置版本感知，本地配置受保护）
|
|
89
85
|
```
|
|
90
86
|
|
|
91
87
|
安装后直接说「写日报」「写周报」「写月报」「写季报」「写年报」「记会议」或丢给它一个文档即可触发；问「日报怎么用 / 会议纪要怎么用 / 登台怎么用」等输出使用说明。
|
|
92
88
|
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
## 文档导航 · Documentation
|
|
89
|
+
## 文档导航
|
|
96
90
|
|
|
97
|
-
| 文档
|
|
91
|
+
| 文档 | 内容 |
|
|
98
92
|
|:---|:---|
|
|
99
|
-
| [docs/install.md](docs/install.md) | 安装与升级详解：两种安装方式、命令参考、升级与配置保护机制、维护者约定（CONFIG_VERSION
|
|
100
|
-
| [docs/architecture.md](docs/architecture.md) | 架构与规范：目录结构、技能形态（薄入口 + resources
|
|
101
|
-
| [CHANGELOG.md](CHANGELOG.md) |
|
|
93
|
+
| [docs/install.md](docs/install.md) | 安装与升级详解：两种安装方式、命令参考、升级与配置保护机制、维护者约定（CONFIG_VERSION 递增规则）。英文版 [docs/install.en.md](docs/install.en.md) |
|
|
94
|
+
| [docs/architecture.md](docs/architecture.md) | 架构与规范：目录结构、技能形态（薄入口 + resources）、八大机制、拆分规范、通用原则。英文版 [docs/architecture.en.md](docs/architecture.en.md) |
|
|
95
|
+
| [CHANGELOG.md](CHANGELOG.md) | 版本变更记录。英文版 [CHANGELOG.en.md](CHANGELOG.en.md) |
|
|
102
96
|
|
|
103
|
-
## 许可证
|
|
97
|
+
## 许可证
|
|
104
98
|
|
|
105
99
|
[MIT](LICENSE)
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# Architecture & Conventions
|
|
2
|
+
|
|
3
|
+
[中文](architecture.md)
|
|
4
|
+
|
|
5
|
+
> This document describes the repository layout, skill anatomy (thin entry + resources), the eight core mechanisms, and the splitting conventions.
|
|
6
|
+
|
|
7
|
+
## Directory Layout
|
|
8
|
+
|
|
9
|
+
```
|
|
10
|
+
.
|
|
11
|
+
├── README.md # intro + output gallery + categories + skill list (English: README.en.md)
|
|
12
|
+
├── CHANGELOG.md # version changelog (English: CHANGELOG.en.md)
|
|
13
|
+
├── docs/ # docs (install / architecture / output screenshots; Chinese & English one-to-one)
|
|
14
|
+
│ ├── install.md # installation & upgrade in depth (English: install.en.md)
|
|
15
|
+
│ ├── architecture.md # this document (English: architecture.en.md)
|
|
16
|
+
│ └── images/ # output screenshots
|
|
17
|
+
├── cli.js # installer (ls / init / update, zero-dependency Node>=14)
|
|
18
|
+
├── package.json # npm package definition (skill-forge-hub, command name skill-forge)
|
|
19
|
+
├── template/ # new-skill template (thin entry + resources splitting conventions)
|
|
20
|
+
├── meta-forge/ # meta skill: forges skills (eight-mechanism embedding + repo registration)
|
|
21
|
+
├── article-to-html/
|
|
22
|
+
│ ├── SKILL.md # document → polished HTML full flow + per-chapter screenshots (with embedded usage guide)
|
|
23
|
+
│ ├── design-system.md # design system (fonts / colors / typography / chart redrawing)
|
|
24
|
+
│ ├── user-config.md # ⚙️ user config (THEME etc., never overwritten on upgrade)
|
|
25
|
+
│ ├── .preserve # upgrade preserve list (design-system.md is user-editable)
|
|
26
|
+
│ └── scripts/ # font install / docx extraction / font inlining scripts
|
|
27
|
+
├── daily-report/ (weekly-report / monthly-report / quarterly-report / annual-report share the same shape)
|
|
28
|
+
│ ├── SKILL.md # thin entry: frontmatter + generation flow + rules summary
|
|
29
|
+
│ ├── user-config.md # ⚙️ user config (CONFIG_VERSION + default config + custom templates)
|
|
30
|
+
│ └── resources/ # heavy content split by generation stage, read on demand
|
|
31
|
+
│ ├── usage-guide.md # 📖 usage guide (verbatim source for usage-only answers)
|
|
32
|
+
│ ├── date-parsing.md # 🗓 date parsing (natural language first)
|
|
33
|
+
│ ├── data-collection.md # 📥 data collection (multi-source: verbal / text / files / images)
|
|
34
|
+
│ ├── content-rules.md # ✍️ content rules (aggregation sources / text-only mode / output format / writing style)
|
|
35
|
+
│ ├── industry-dictionary.md # 🏭 industry adaptation (12-industry dictionary)
|
|
36
|
+
│ └── disk-and-html.md # 💾 local save / HTML styles / content-png capture spec
|
|
37
|
+
├── magic-deck/
|
|
38
|
+
│ ├── SKILL.md # thin entry: magic deck generation flow + rules summary
|
|
39
|
+
│ ├── user-config.md # ⚙️ user config
|
|
40
|
+
│ └── resources/
|
|
41
|
+
│ ├── usage-guide.md # 📖 usage guide (features / hotkeys / capture / copy / fullscreen)
|
|
42
|
+
│ ├── deck-spec.md # full spec (skeleton / theme colors / template library / hotkey table / capture implementation)
|
|
43
|
+
│ └── reference.html # output skeleton (generation clones it and swaps content piece by piece)
|
|
44
|
+
├── deck-stage/
|
|
45
|
+
│ ├── SKILL.md # thin entry: stage-deck three-question interaction + generation flow
|
|
46
|
+
│ ├── user-config.md # ⚙️ user config
|
|
47
|
+
│ ├── package.json # dependency declaration (pptxgenjs)
|
|
48
|
+
│ └── resources/
|
|
49
|
+
│ ├── usage-guide.md # 📖 usage guide
|
|
50
|
+
│ ├── data-schema.md # data.json structure (paragraph → page type / section color mapping)
|
|
51
|
+
│ ├── pptx-builder.js # source of truth: reads data.json, produces 16:9 pptx
|
|
52
|
+
│ └── cover-template.html # cover/closing capture template
|
|
53
|
+
├── prompt-pouch/
|
|
54
|
+
│ ├── SKILL.md # thin entry: prompt-pouch console generation flow
|
|
55
|
+
│ ├── user-config.md # ⚙️ user config (DIR/DATA_DIR/BACKUP_DIR etc.)
|
|
56
|
+
│ └── resources/
|
|
57
|
+
│ ├── usage-guide.md # 📖 usage guide
|
|
58
|
+
│ ├── data-format.md # prompts.json data format
|
|
59
|
+
│ └── reference.html # output skeleton
|
|
60
|
+
├── spec-doc2spec/ (spec-spec2doc shares the same shape)
|
|
61
|
+
│ ├── SKILL.md # thin entry: Pandoc conversion + AI proofreading flow
|
|
62
|
+
│ ├── user-config.md # ⚙️ user config
|
|
63
|
+
│ └── resources/ # volumes: checklist proofreading / images handling / structure organizing / pdf-path dual PDF paths / usage-guide
|
|
64
|
+
├── quarterly-report/ # same shape as daily-report; quarterly specifics: QoQ/YoY dual baselines / Q1-Q4 trend chart / M1-M3 monthly timeline
|
|
65
|
+
├── meeting-minutes/ # same shape as daily-report; minutes specifics: five sections / action-item triads / 12 meeting-type dictionaries
|
|
66
|
+
└── weekly-report/ # same shape as daily-report; weekly specifics: WEEK_END week end / week targeting / weekly overview card / X.XD duration (1D=8H)
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## Skill Anatomy
|
|
70
|
+
|
|
71
|
+
- **SKILL.md keeps only**: the frontmatter, the generation-flow overview (each step names the resource it reads), the "⚙️ config & custom templates" pointer section (all user-editable config lives in user-config.md — must be read before every run), and a rules summary (3–5 hard rules).
|
|
72
|
+
- **resources/ is one-file-one-job**: split by generation stage, with SKILL.md flow nodes annotated `read resources/xxx.md`; each resource is self-contained and readable on its own, with no cross-references.
|
|
73
|
+
- **Usage-only answers**: when the user only asks how to use a skill without requesting generation, read `resources/usage-guide.md` and echo it verbatim (retitle the first heading to "<Skill> Usage Guide").
|
|
74
|
+
- **User config extraction**: all user-editable content lives in `user-config.md` (with `CONFIG_VERSION` on the first line), never overwritten on upgrade.
|
|
75
|
+
|
|
76
|
+
## The Eight Core Mechanisms
|
|
77
|
+
|
|
78
|
+
| Mechanism | Description |
|
|
79
|
+
|:---|:---|
|
|
80
|
+
| CONFIG_VERSION key | The first line of user-config.md declares the config-structure version; bump by 1 whenever the official structure changes (keys added / renamed / removed) and document the migration rules in the SKILL.md "config version mechanism" section. Both the CLI updater and the AI self-check this version before running: version went up → back up as `.bak-<timestamp>` → interactive three-way choice (official overwrite / keep mine + `.upstream` companion / decide later). |
|
|
81
|
+
| user-config extraction | User-editable content (default config + custom templates) is extracted from SKILL.md into a standalone `user-config.md`; SKILL.md keeps only the pointer section (must be read before every run). BUILTIN_PRESERVE plus the skill's `.preserve` list guard it doubly on upgrade, so local edits persist forever. |
|
|
82
|
+
| reference dual-track | Skills that produce HTML (report family / magic deck / prompt pouch) keep a `resources/reference.html` as the visual source of truth: generation clones its skeleton and swaps content piece by piece, so output matches the official demo. Outputs carry an `sf-template` version stamp + a stable ID meta, enabling "reforge" upgrades of old outputs per the output-upgrade section. |
|
|
83
|
+
| doc-sync self-check discipline | After touching any file, grep the whole repo to verify keywords — zero stale terms allowed; hard gates before delivery: headless (Playwright/Chrome) open with zero JS errors + screenshot proof that content is complete; static gates (frontmatter matches the declared version). IDs are locked to the standard UUID v4 format (crypto.randomUUID()) and checked for collisions by scanning the output directory before writing. |
|
|
84
|
+
| .preserve list | Skills with semi-customizable assets (design systems / template drafts, files users may edit) declare them in a `.preserve` list: the CLI never overwrites these on upgrade, and official updates are saved as `.upstream` companions for manual merging. |
|
|
85
|
+
| multi-file isolation | Pages with localStorage memory namespace their keys by an in-page embedded unique ID (standard UUID v4) — multiple outputs never cross-talk, and memories survive renames/moves; page-level self-healing: when the id meta is invalid/missing, the page heals itself to a standard v4 via a path key and writes it back to the meta. |
|
|
86
|
+
| infringement-free, desensitized & offline | Zero brand fonts (free-for-commercial-use fonts only), no CDN so pages open offline, zero real identities in sample data (generic placeholders). |
|
|
87
|
+
| output reforge upgrades | HTML carries a template version stamp (bumped on business / data-format / page changes); after an upgrade, old outputs can be interactively reforged (shallow upgrade = block replacement; deep upgrade = md rebuild), and generation proactively scans for old versions and suggests the trigger phrase; deep rebuilds of user-data skills must keep the page's stable ID (a new ID = lost data), and data files are never touched. |
|
|
88
|
+
|
|
89
|
+
## Splitting Conventions
|
|
90
|
+
|
|
91
|
+
- **New skills follow the `template/` structure**, directory name = skill name (lowercase-hyphen), and must be registered in the README category table + cli.js CATEGORIES + package.json files.
|
|
92
|
+
- **Existing skills keep their own shape**: article-to-html uses a flat SKILL.md + design-system.md + scripts/ layout (its usage guide is embedded in the SKILL.md "user usage guide" section).
|
|
93
|
+
- **General principles**: zero external dependencies (no CDN / external links, offline double-click works), cross-platform (macOS / Windows).
|
|
94
|
+
- **Config upgrades**: bump CONFIG_VERSION and document migration rules; both CLI update and AI execution back up and prompt accordingly.
|
|
95
|
+
- **Meta skill**: for meta-forge, `resources/forge-rules.md` is the source of truth (clarification checklist / structure / eight mechanisms / validation / repo registration); the SKILL.md flow and template/ both align with it.
|
package/docs/architecture.md
CHANGED
|
@@ -1,89 +1,95 @@
|
|
|
1
|
-
# 架构与规范
|
|
1
|
+
# 架构与规范
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[English](architecture.en.md)
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
> 本文档描述仓库目录结构、技能形态（薄入口 + resources）、八大机制与拆分规范。
|
|
6
|
+
|
|
7
|
+
## 目录结构
|
|
6
8
|
|
|
7
9
|
```
|
|
8
10
|
.
|
|
9
|
-
├── README.md #
|
|
10
|
-
├── CHANGELOG.md #
|
|
11
|
-
├── docs/ # 文档（安装升级 / 架构规范 /
|
|
12
|
-
│ ├── install.md #
|
|
13
|
-
│ ├── architecture.md #
|
|
14
|
-
│ └── images/ # 产物成品截图
|
|
15
|
-
├── cli.js # 安装器（ls / init / update，零依赖 Node>=14
|
|
16
|
-
├── package.json # npm 包定义（skill-forge-hub，命令名 skill-forge
|
|
17
|
-
├── template/ # 新技能模板（薄入口 + resources
|
|
18
|
-
├── meta-forge/ # 元技能：造 skill 的 skill
|
|
11
|
+
├── README.md # 介绍 + 产物画廊 + 技能分类 + 技能清单（英文版 README.en.md）
|
|
12
|
+
├── CHANGELOG.md # 版本变更记录（英文版 CHANGELOG.en.md）
|
|
13
|
+
├── docs/ # 文档（安装升级 / 架构规范 / 产物截图，中英一一对应）
|
|
14
|
+
│ ├── install.md # 安装与升级详解（英文版 install.en.md）
|
|
15
|
+
│ ├── architecture.md # 本文档（英文版 architecture.en.md）
|
|
16
|
+
│ └── images/ # 产物成品截图
|
|
17
|
+
├── cli.js # 安装器（ls / init / update，零依赖 Node>=14）
|
|
18
|
+
├── package.json # npm 包定义（skill-forge-hub，命令名 skill-forge）
|
|
19
|
+
├── template/ # 新技能模板（薄入口 + resources 拆分规范）
|
|
20
|
+
├── meta-forge/ # 元技能：造 skill 的 skill（八大机制植入 + 仓库登记）
|
|
19
21
|
├── article-to-html/
|
|
20
22
|
│ ├── SKILL.md # 文档 → 精美 HTML 完整流程 + 逐章截图（含内嵌使用说明）
|
|
21
|
-
│ ├── design-system.md # 设计系统（字体 / 配色 / 排版 /
|
|
22
|
-
│ ├── user-config.md # ⚙️ 用户配置（THEME
|
|
23
|
-
│ ├── .preserve # 升级保留清单（design-system.md
|
|
24
|
-
│ └── scripts/ # 字体安装 / docx 抽取 / 字体内联脚本
|
|
25
|
-
├── daily-report/（weekly-report / monthly-report / quarterly-report / annual-report
|
|
26
|
-
│ ├── SKILL.md # 薄入口：frontmatter + 生成流程 + 规则速览
|
|
27
|
-
│ ├── user-config.md # ⚙️ 用户配置（CONFIG_VERSION + 默认配置 +
|
|
28
|
-
│ └── resources/ # 重内容按生成阶段拆分，AI 按需读取
|
|
29
|
-
│ ├── usage-guide.md # 📖
|
|
30
|
-
│ ├── date-parsing.md # 🗓
|
|
31
|
-
│ ├── data-collection.md # 📥 数据收集（多源聚合：口述 / 文字 / 文件 /
|
|
32
|
-
│ ├── content-rules.md # ✍️ 内容规则（聚合来源 / 纯文字模式 / 输出格式 /
|
|
33
|
-
│ ├── industry-dictionary.md # 🏭 行业适配（12
|
|
34
|
-
│ └── disk-and-html.md # 💾 本地落盘 / HTML 样式 / content-png 截图规范
|
|
23
|
+
│ ├── design-system.md # 设计系统（字体 / 配色 / 排版 / 图表重绘）
|
|
24
|
+
│ ├── user-config.md # ⚙️ 用户配置（THEME 等，升级不覆盖）
|
|
25
|
+
│ ├── .preserve # 升级保留清单（design-system.md 用户可改）
|
|
26
|
+
│ └── scripts/ # 字体安装 / docx 抽取 / 字体内联脚本
|
|
27
|
+
├── daily-report/（weekly-report / monthly-report / quarterly-report / annual-report 同构）
|
|
28
|
+
│ ├── SKILL.md # 薄入口：frontmatter + 生成流程 + 规则速览
|
|
29
|
+
│ ├── user-config.md # ⚙️ 用户配置（CONFIG_VERSION + 默认配置 + 自定义模板）
|
|
30
|
+
│ └── resources/ # 重内容按生成阶段拆分，AI 按需读取
|
|
31
|
+
│ ├── usage-guide.md # 📖 使用说明（咨询应答的原样输出源）
|
|
32
|
+
│ ├── date-parsing.md # 🗓 日期解析（自然语言优先）
|
|
33
|
+
│ ├── data-collection.md # 📥 数据收集（多源聚合：口述 / 文字 / 文件 / 图片）
|
|
34
|
+
│ ├── content-rules.md # ✍️ 内容规则（聚合来源 / 纯文字模式 / 输出格式 / 写作风格）
|
|
35
|
+
│ ├── industry-dictionary.md # 🏭 行业适配（12 行业职业词典）
|
|
36
|
+
│ └── disk-and-html.md # 💾 本地落盘 / HTML 样式 / content-png 截图规范
|
|
35
37
|
├── magic-deck/
|
|
36
|
-
│ ├── SKILL.md # 薄入口：魔法幻灯生成流程 + 规则速览
|
|
37
|
-
│ ├── user-config.md # ⚙️ 用户配置
|
|
38
|
+
│ ├── SKILL.md # 薄入口：魔法幻灯生成流程 + 规则速览
|
|
39
|
+
│ ├── user-config.md # ⚙️ 用户配置
|
|
38
40
|
│ └── resources/
|
|
39
|
-
│ ├── usage-guide.md # 📖
|
|
40
|
-
│ ├── deck-spec.md #
|
|
41
|
-
│ └── reference.html #
|
|
41
|
+
│ ├── usage-guide.md # 📖 使用说明（功能/热键/截图/复制/全屏）
|
|
42
|
+
│ ├── deck-spec.md # 完整规范（骨架/主题色值/模板库/热键表/截图实现）
|
|
43
|
+
│ └── reference.html # 成品骨架（生成时以此为骨逐处替换内容）
|
|
42
44
|
├── deck-stage/
|
|
43
|
-
│ ├── SKILL.md # 薄入口：登台 PPTX 三问交互 + 生成流程
|
|
44
|
-
│ ├── user-config.md # ⚙️ 用户配置
|
|
45
|
-
│ ├── package.json # 依赖声明（pptxgenjs
|
|
45
|
+
│ ├── SKILL.md # 薄入口：登台 PPTX 三问交互 + 生成流程
|
|
46
|
+
│ ├── user-config.md # ⚙️ 用户配置
|
|
47
|
+
│ ├── package.json # 依赖声明（pptxgenjs）
|
|
46
48
|
│ └── resources/
|
|
47
|
-
│ ├── usage-guide.md # 📖 使用说明
|
|
48
|
-
│ ├── data-schema.md # data.json 结构（段落 →
|
|
49
|
-
│ ├── pptx-builder.js # 真相源：读 data.json 产 16:9 pptx
|
|
50
|
-
│ └── cover-template.html # 封面/结尾截图底版
|
|
49
|
+
│ ├── usage-guide.md # 📖 使用说明
|
|
50
|
+
│ ├── data-schema.md # data.json 结构（段落 → 页类型/节色映射）
|
|
51
|
+
│ ├── pptx-builder.js # 真相源：读 data.json 产 16:9 pptx
|
|
52
|
+
│ └── cover-template.html # 封面/结尾截图底版
|
|
51
53
|
├── prompt-pouch/
|
|
52
|
-
│ ├── SKILL.md # 薄入口：锦囊管理台生成流程
|
|
53
|
-
│ ├── user-config.md # ⚙️ 用户配置（DIR/DATA_DIR/BACKUP_DIR
|
|
54
|
+
│ ├── SKILL.md # 薄入口：锦囊管理台生成流程
|
|
55
|
+
│ ├── user-config.md # ⚙️ 用户配置（DIR/DATA_DIR/BACKUP_DIR 等）
|
|
54
56
|
│ └── resources/
|
|
55
|
-
│ ├── usage-guide.md # 📖 使用说明
|
|
56
|
-
│ ├── data-format.md # prompts.json 数据格式
|
|
57
|
-
│ └── reference.html # 成品骨架
|
|
58
|
-
├── spec-doc2spec/（spec-spec2doc
|
|
59
|
-
│ ├── SKILL.md # 薄入口：Pandoc 转换 + AI 校对流程
|
|
60
|
-
│ ├── user-config.md # ⚙️ 用户配置
|
|
57
|
+
│ ├── usage-guide.md # 📖 使用说明
|
|
58
|
+
│ ├── data-format.md # prompts.json 数据格式
|
|
59
|
+
│ └── reference.html # 成品骨架
|
|
60
|
+
├── spec-doc2spec/（spec-spec2doc 同构）
|
|
61
|
+
│ ├── SKILL.md # 薄入口：Pandoc 转换 + AI 校对流程
|
|
62
|
+
│ ├── user-config.md # ⚙️ 用户配置
|
|
61
63
|
│ └── resources/ # 分册：checklist 校对清单 / images 图片处理 / structure 目录组织 / pdf-path PDF 双路径 / usage-guide
|
|
62
64
|
├── quarterly-report/ # 结构同 daily-report，季报专属差异：环比/同比双基准 / Q1-Q4 走势图 / M1-M3 月时间线
|
|
63
65
|
├── meeting-minutes/ # 结构同 daily-report，纪要专属差异：五段式 / 行动项三要素 / 12 类会议词典
|
|
64
66
|
└── weekly-report/ # 结构同 daily-report，周报专属差异：WEEK_END 周结束日 / 周定位解析 / 本周概览卡 / 用时 X.XD（1D=8H）
|
|
65
67
|
```
|
|
66
68
|
|
|
67
|
-
## 技能形态
|
|
69
|
+
## 技能形态
|
|
68
70
|
|
|
69
|
-
- **SKILL.md 只保留**：frontmatter、生成流程总览（每步标注读哪个 resource）、「⚙️
|
|
70
|
-
- **resources/ 一文件一职责**：按生成阶段拆分，SKILL.md 流程节点标注 `读 resources/xxx.md`；每份 resource 独立可读，不互相引用。
|
|
71
|
-
- **咨询应答**：用户只问用法不要求生成时，读 `resources/usage-guide.md` 原样输出（首行标题按技能改为「XX生成器使用指南」）。
|
|
72
|
-
- **用户配置抽离**：所有用户可改内容在 `user-config.md`（首行 `CONFIG_VERSION`），升级永不覆盖。
|
|
71
|
+
- **SKILL.md 只保留**：frontmatter、生成流程总览（每步标注读哪个 resource）、「⚙️ 配置与自定义模板」指引段（用户可改配置全部出站在 user-config.md，执行前必须先 Read）、规则速览（3-5 条硬性规则）。
|
|
72
|
+
- **resources/ 一文件一职责**：按生成阶段拆分，SKILL.md 流程节点标注 `读 resources/xxx.md`；每份 resource 独立可读，不互相引用。
|
|
73
|
+
- **咨询应答**：用户只问用法不要求生成时，读 `resources/usage-guide.md` 原样输出（首行标题按技能改为「XX生成器使用指南」）。
|
|
74
|
+
- **用户配置抽离**：所有用户可改内容在 `user-config.md`（首行 `CONFIG_VERSION`），升级永不覆盖。
|
|
73
75
|
|
|
74
|
-
##
|
|
76
|
+
## 八大机制
|
|
75
77
|
|
|
76
|
-
| 机制
|
|
78
|
+
| 机制 | 说明 |
|
|
77
79
|
|:---|:---|
|
|
78
|
-
| CONFIG_VERSION
|
|
79
|
-
| user-config
|
|
80
|
-
| reference
|
|
81
|
-
|
|
|
80
|
+
| CONFIG_VERSION 钥匙 | `user-config.md` 首行声明配置结构版本；官方结构变化（新增/改名/删除配置键）时递增 1 并在 SKILL.md「配置版本机制」节写明迁移规则。CLI 升级与 AI 执行前都自检该版本：版本升了 → 备份 `.bak-时间戳` → 交互三选一（官方覆盖 / 保留我的 + `.upstream` 对照 / 稍后处理）。 |
|
|
81
|
+
| user-config 抽离 | 用户可改内容（默认配置 + 自定义模板）从 SKILL.md 抽离到独立 `user-config.md`，SKILL.md 只留指引段（执行前必须先 Read）。升级时 BUILTIN_PRESERVE + 技能 `.preserve` 清单双重保护，本地修改永久保留。 |
|
|
82
|
+
| reference 双轨 | 成品 HTML 形态的技能（报表族 / 魔法幻灯 / 锦囊）以 `resources/reference.html` 为视觉真相源：生成时以此为骨逐处替换内容，保证产物样式与官方演示一致；产物头部带 `sf-template` 版本戳 + 稳定 ID meta，按「产物升级（回炉）」节可把旧产物升级到新模板。 |
|
|
83
|
+
| 文档同步自检纪律 | 改任一文件 grep 全仓核对关键词，旧词零残留；交付前硬门禁：Playwright/Chrome headless 打开产物零 JS 错误 + 截图验证内容完整；静态门禁（frontmatter 与版本声明一致）。ID 格式定死（crypto.randomUUID() 标准 v4），落盘前顺扫目录查重。 |
|
|
84
|
+
| .preserve 保护清单 | 技能含半定制资产（设计系统 / 模板底稿等用户可改文件）时，用 `.preserve` 清单声明：CLI 升级永不覆盖这些文件，官方更新另存 `.upstream` 对照，可按需手动合并。 |
|
|
85
|
+
| 多文件隔离 | 页面有 localStorage 记忆时，键按页内嵌唯一 ID（标准 UUID v4）命名空间——多份产物互不串台、改名/移动目录记忆不丢；页面执行层自愈：id meta 非法/缺失时按路径键自愈为标准 v4 并回写 meta。 |
|
|
86
|
+
| 零侵权脱敏离线 | 品牌字体零出现（只用免费商用字体）、禁 CDN 页面离线可开、示例数据零真实身份（通用占位）。 |
|
|
87
|
+
| 产物升级回炉 | HTML 带模板版本戳（业务/数据格式/页面改动均 bump），升级后可扫旧产物交互式回炉（浅升级区块替换 / 深升级 md 重建），生成时顺扫旧版主动提示触发语；用户数据类深升级重建必须沿用原页稳定 ID（换 ID = 数据失联），数据文件一概不动。 |
|
|
82
88
|
|
|
83
|
-
## 拆分规范
|
|
89
|
+
## 拆分规范
|
|
84
90
|
|
|
85
|
-
- **新技能按 `template/` 结构创建**，目录名 = 技能名（英文短横线），并归入 README「技能分类」表对应分类 + 同步 cli.js CATEGORIES 与 package.json files。
|
|
86
|
-
- **已有技能按各自结构维护**：article-to-html 采用 SKILL.md + design-system.md + scripts/ 平铺结构（使用说明内嵌 SKILL.md「用户使用说明」节）。
|
|
87
|
-
- **通用原则**：零外部依赖（禁 CDN / 外链，内网离线双击可开）、双系统兼容（macOS / Windows）。
|
|
88
|
-
- **配置升级**：user-config.md 首行带 `CONFIG_VERSION`，官方配置结构变化时递增并写明迁移规则；CLI update 与 AI 执行时均按该版本做备份 + 迁移提示。
|
|
89
|
-
- **元技能**：meta-forge 造技能时的规范真相源在 `resources/forge-rules.md`（澄清清单 / 结构规范 /
|
|
91
|
+
- **新技能按 `template/` 结构创建**，目录名 = 技能名（英文短横线），并归入 README「技能分类」表对应分类 + 同步 cli.js CATEGORIES 与 package.json files。
|
|
92
|
+
- **已有技能按各自结构维护**：article-to-html 采用 SKILL.md + design-system.md + scripts/ 平铺结构（使用说明内嵌 SKILL.md「用户使用说明」节）。
|
|
93
|
+
- **通用原则**：零外部依赖（禁 CDN / 外链，内网离线双击可开）、双系统兼容（macOS / Windows）。
|
|
94
|
+
- **配置升级**：user-config.md 首行带 `CONFIG_VERSION`，官方配置结构变化时递增并写明迁移规则；CLI update 与 AI 执行时均按该版本做备份 + 迁移提示。
|
|
95
|
+
- **元技能**：meta-forge 造技能时的规范真相源在 `resources/forge-rules.md`（澄清清单 / 结构规范 / 八大机制 / 校验清单 / 仓库登记），SKILL.md 流程节点与 template/ 模板均与之对齐。
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
# Installation & Upgrade
|
|
2
|
+
|
|
3
|
+
[中文](install.md)
|
|
4
|
+
|
|
5
|
+
> This document covers both install methods, the command reference, and the config-protection mechanics applied on upgrade.
|
|
6
|
+
|
|
7
|
+
## Method 1: Global npm Install (Recommended)
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm i -g skill-forge-hub
|
|
11
|
+
skill-forge ls # list all skills & descriptions (read-only)
|
|
12
|
+
skill-forge init # interactive skill picker, auto-detects & installs to the AI assistant's skill directory
|
|
13
|
+
skill-forge update # upgrade installed skills (config-version aware, see below)
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Non-interactive / explicit directory:
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
skill-forge init --target ~/.claude/skills --skills daily-report,weekly-report
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
> **deck-stage dependency note**: deck-stage needs PptxGenJS. Installing directly from this repo copies the skill's node_modules along (works offline); the npm global package excludes node_modules, so the CLI prompts `cd <skill dir>/deck-stage && npm install` to install it once.
|
|
23
|
+
|
|
24
|
+
## Method 2: Manual Copy
|
|
25
|
+
|
|
26
|
+
Copy the skill directories into your AI assistant's skill directory (any assistant supporting the SKILL.md format works).
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
cp -R daily-report weekly-report monthly-report quarterly-report annual-report <your AI assistant's skill directory>/
|
|
30
|
+
cp -R magic-deck prompt-pouch <your AI assistant's skill directory>/
|
|
31
|
+
cp -R spec-doc2spec spec-spec2doc <your AI assistant's skill directory>/
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
After copying, say "write a daily report", "write a weekly report", "write a monthly report", "write a quarterly report", "write an annual report", "take meeting minutes", or hand it a document to trigger a skill; asking "how do I use daily-report / weekly-report / monthly-report / quarterly-report / meeting-minutes / deck-stage" prints the usage guide.
|
|
35
|
+
|
|
36
|
+
## Command Reference
|
|
37
|
+
|
|
38
|
+
| Command | Description |
|
|
39
|
+
|:---|:---|
|
|
40
|
+
| `skill-forge ls` | List all skills (category + name + description), read-only |
|
|
41
|
+
| `skill-forge init` | Interactive pick from the list: a=install all / pick by number (installed marked ★; confirm with s to skip installed and install only new ones) |
|
|
42
|
+
| `skill-forge update` | Upgrade all installed skills (config-version aware) |
|
|
43
|
+
| `skill-forge update --skills a,b` | Upgrade only the named skills (uninstalled ones are skipped with a notice) |
|
|
44
|
+
| `skill-forge --version` | Show version |
|
|
45
|
+
| `skill-forge --help` | Show full help |
|
|
46
|
+
|
|
47
|
+
Common flags (for init / update):
|
|
48
|
+
|
|
49
|
+
| Flag | Description |
|
|
50
|
+
|:---|:---|
|
|
51
|
+
| `--target <dir>` (`-t`) | Explicit skill directory; defaults to auto-detecting common assistant dirs (~/.qoder-cn, ~/.claude, ~/.cursor, ...), interactive pick when several are found |
|
|
52
|
+
| `--skills a,b` (`-s`) | Named skill list: init skips the picker and installs/upgrades exactly these (good for scripts); update upgrades only these |
|
|
53
|
+
| `--yes` (`-y`) | Skip confirmation; on config-version change defaults to "keep mine + official copy saved as .upstream" |
|
|
54
|
+
|
|
55
|
+
Command aliases: `list` = `ls`, `install` = `init`, `upgrade` = `update`.
|
|
56
|
+
|
|
57
|
+
## Upgrade & Config Protection
|
|
58
|
+
|
|
59
|
+
`skill-forge update` (all installed skills by default, or `--skills a,b`) protects your config before overwriting any skill files.
|
|
60
|
+
|
|
61
|
+
- **Always preserved**: an existing `user-config.md` in the target directory (and any files declared in the skill's `.preserve` list) is never overwritten — your local config persists forever; when the official config gains updates, a `.upstream` companion file is saved so you can merge new config points manually
|
|
62
|
+
- **Version aware**: when the official `user-config.md` declares a `CONFIG_VERSION` on its first line higher than your local version (config structure grew / shrank / was renamed) —
|
|
63
|
+
1. your config is first backed up as `user-config.md.bak-<timestamp>`
|
|
64
|
+
2. interactive three-way choice: `[1] official overwrite` (old config recoverable from the backup) / `[2] keep mine` + official copy saved as `.upstream` (default) / `[3] decide later` (no companion file generated this time)
|
|
65
|
+
3. `--yes` or non-interactive environments default to `[2]`, the safest option
|
|
66
|
+
- **Version match**: silent upgrade — only skill files are updated, config stays untouched
|
|
67
|
+
- **Structure sync**: upgrades sync official file additions/removals precisely via the `.installed-manifest` — only files listed in the manifest that the official version deleted (and now-empty directories) are cleaned up, self-created user files are never touched (older installs without a manifest skip cleanup and get the manifest written after upgrade); `user-config.md`, `.preserve` list files, `.upstream` companions, `.bak-*` backups and `node_modules` dependencies are never touched
|
|
68
|
+
|
|
69
|
+
Maintainer conventions: whenever the official config structure changes (keys added / renamed / removed), bump `CONFIG_VERSION` in `user-config.md` by 1 and document the migration rules in the SKILL.md "config version mechanism" section (the AI also self-checks this version before every run).
|
package/docs/install.md
CHANGED
|
@@ -1,29 +1,29 @@
|
|
|
1
|
-
# 安装与升级
|
|
1
|
+
# 安装与升级
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[English](install.en.md)
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
> 本文档详述 SkillForge 的两种安装方式、命令参考，以及升级时的配置保护机制。
|
|
6
|
+
|
|
7
|
+
## 方式一：npm 全局安装（推荐）
|
|
6
8
|
|
|
7
9
|
```bash
|
|
8
10
|
npm i -g skill-forge-hub
|
|
9
|
-
skill-forge ls #
|
|
10
|
-
skill-forge init # 交互式挑选技能，自动探测并安装到 AI 助手技能目录
|
|
11
|
-
skill-forge update #
|
|
11
|
+
skill-forge ls # 列出全部技能与说明（只读）
|
|
12
|
+
skill-forge init # 交互式挑选技能，自动探测并安装到 AI 助手技能目录
|
|
13
|
+
skill-forge update # 升级已安装技能（配置版本感知，见下）
|
|
12
14
|
```
|
|
13
15
|
|
|
14
|
-
非交互 /
|
|
16
|
+
非交互 / 指定目录场景：
|
|
15
17
|
|
|
16
18
|
```bash
|
|
17
19
|
skill-forge init --target ~/.claude/skills --skills daily-report,weekly-report
|
|
18
20
|
```
|
|
19
21
|
|
|
20
22
|
> **deck-stage 依赖说明**：deck-stage 需要 PptxGenJS。从本仓库直接 init 会连带复制技能目录内 node_modules，离线可用；npm 全局装出的包不含 node_modules，安装时会提示 `cd <技能目录>/deck-stage && npm install` 补装一次即可。
|
|
21
|
-
>
|
|
22
|
-
> **deck-stage dependency note**: deck-stage needs PptxGenJS. Installing directly from this repo copies the skill's node_modules along (works offline); the npm global package excludes node_modules, so the CLI prompts `cd <skill dir>/deck-stage && npm install` to install it once.
|
|
23
23
|
|
|
24
|
-
## 方式二：手动复制
|
|
24
|
+
## 方式二：手动复制
|
|
25
25
|
|
|
26
|
-
将技能目录复制到你所用的 AI 助手的技能目录（支持 SKILL.md 格式、本地加载技能的助手均可）。
|
|
26
|
+
将技能目录复制到你所用的 AI 助手的技能目录（支持 SKILL.md 格式、本地加载技能的助手均可）。
|
|
27
27
|
|
|
28
28
|
```bash
|
|
29
29
|
cp -R daily-report weekly-report monthly-report quarterly-report annual-report <你的 AI 助手技能目录>/
|
|
@@ -33,39 +33,37 @@ cp -R spec-doc2spec spec-spec2doc <你的 AI 助手技能目录>/
|
|
|
33
33
|
|
|
34
34
|
复制后直接说「写日报」「写周报」「写月报」「写季报」「写年报」「记会议」或丢给它一个文档即可触发；问「日报怎么用 / 周报怎么用 / 月报怎么用 / 季报怎么用 / 会议纪要怎么用 / 登台怎么用」输出使用说明。
|
|
35
35
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
## 命令参考 · Command Reference
|
|
36
|
+
## 命令参考
|
|
39
37
|
|
|
40
|
-
| 命令
|
|
38
|
+
| 命令 | 说明 |
|
|
41
39
|
|:---|:---|
|
|
42
|
-
| `skill-forge ls` | 列出全部技能（分类 + 名称 + 说明），只读
|
|
43
|
-
| `skill-forge init` | 列清单交互挑选：a=全部安装 / 编号挑选（已装标 ★，确认时可 s
|
|
44
|
-
| `skill-forge update` |
|
|
45
|
-
| `skill-forge update --skills a,b` |
|
|
46
|
-
| `skill-forge --version` | 显示版本号
|
|
47
|
-
| `skill-forge --help` | 显示完整帮助
|
|
40
|
+
| `skill-forge ls` | 列出全部技能（分类 + 名称 + 说明），只读 |
|
|
41
|
+
| `skill-forge init` | 列清单交互挑选：a=全部安装 / 编号挑选（已装标 ★，确认时可 s 跳过已装只装新） |
|
|
42
|
+
| `skill-forge update` | 升级全部已安装技能（配置版本感知） |
|
|
43
|
+
| `skill-forge update --skills a,b` | 只升级指定技能（未安装的提示跳过） |
|
|
44
|
+
| `skill-forge --version` | 显示版本号 |
|
|
45
|
+
| `skill-forge --help` | 显示完整帮助 |
|
|
48
46
|
|
|
49
|
-
通用参数（init / update
|
|
47
|
+
通用参数（init / update 通用）：
|
|
50
48
|
|
|
51
|
-
| 参数
|
|
49
|
+
| 参数 | 说明 |
|
|
52
50
|
|:---|:---|
|
|
53
|
-
| `--target <目录>`（`-t`） | 指定技能目录；缺省自动探测常见助手目录（~/.qoder-cn、~/.claude、~/.cursor 等），探测到多个时交互选择
|
|
54
|
-
| `--skills a,b`（`-s`） | 指定技能名列表：init 时跳过选择直接安装/升级指定技能（适合脚本与单件补装）；update 时只升级指定技能
|
|
55
|
-
| `--yes`（`-y`） | 跳过确认直接执行；配置版本变化时默认「保留我的 + 官方版另存 .upstream
|
|
51
|
+
| `--target <目录>`（`-t`） | 指定技能目录；缺省自动探测常见助手目录（~/.qoder-cn、~/.claude、~/.cursor 等），探测到多个时交互选择 |
|
|
52
|
+
| `--skills a,b`（`-s`） | 指定技能名列表：init 时跳过选择直接安装/升级指定技能（适合脚本与单件补装）；update 时只升级指定技能 |
|
|
53
|
+
| `--yes`（`-y`） | 跳过确认直接执行；配置版本变化时默认「保留我的 + 官方版另存 .upstream 对照」 |
|
|
56
54
|
|
|
57
|
-
命令别名：`list` = `ls`、`install` = `init`、`upgrade` = `update`。
|
|
55
|
+
命令别名：`list` = `ls`、`install` = `init`、`upgrade` = `update`。
|
|
58
56
|
|
|
59
|
-
## 升级与配置保护
|
|
57
|
+
## 升级与配置保护
|
|
60
58
|
|
|
61
|
-
`skill-forge update`（默认升级全部已装技能，可用 `--skills a,b`
|
|
59
|
+
`skill-forge update`（默认升级全部已装技能，可用 `--skills a,b` 指定）在覆盖技能文件前自动保护你的配置。
|
|
62
60
|
|
|
63
|
-
-
|
|
64
|
-
-
|
|
61
|
+
- **常驻保护**：目标目录已存在的 `user-config.md`（及技能 `.preserve` 清单声明的文件）永不被覆盖，你的本地配置永久保留；官方配置内容有更新时另存 `.upstream` 对照文件，可按需手动合并新配置点
|
|
62
|
+
- **版本感知**：官方 `user-config.md` 首行的 `CONFIG_VERSION` 高于你的本地版本（配置结构增/减/改名）时——
|
|
65
63
|
1. 先把你的配置备份为 `user-config.md.bak-<时间戳>`
|
|
66
64
|
2. 交互三选一：`[1] 官方覆盖`（旧配置在备份中随时找回）/ `[2] 保留我的` + 官方版另存 `.upstream` 对照（默认）/ `[3] 稍后处理`（本次不生成对照文件）
|
|
67
65
|
3. `--yes` 或非交互环境默认 `[2]`，最安全
|
|
68
|
-
-
|
|
69
|
-
-
|
|
66
|
+
- **版本一致**：无感升级，只更新技能文件，配置原样保留
|
|
67
|
+
- **结构同步**：升级按 `.installed-manifest` 安装清单精准同步官方文件增删——只清理清单内官方已删除的文件与空目录，用户自建文件一律不动（旧版本安装无清单时跳过清理，升级后补写）；`user-config.md`、`.preserve` 清单文件、`.upstream` 对照、`.bak-*` 备份与 `node_modules` 依赖永远不动
|
|
70
68
|
|
|
71
|
-
|
|
69
|
+
技能维护者约定：官方配置结构每次变化（新增/改名/删除配置键）时，`user-config.md` 的 `CONFIG_VERSION` 递增 1，并在 SKILL.md「配置版本机制」节写明迁移规则（AI 每次执行前也会自检该版本）。
|
package/meta-forge/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: meta-forge
|
|
3
|
-
description: 锻造新技能的元技能（造 skill 的 skill）。按 SkillForge 工坊规范从需求出发生成完整技能包（薄入口 SKILL.md + 按阶段拆分的 resources/ + 用户配置 user-config.md），自动植入机制体系：CONFIG_VERSION 配置版本钥匙、user-config 配置抽离、reference 双轨（含 HTML 输出时）、多文件隔离（页面有 localStorage 记忆时）、零侵权脱敏离线纪律（含 HTML 输出时）、产物升级回炉（含 HTML 输出时）、preserve 保护清单（含半定制资产时）、文档同步自检纪律；技能入 SkillForge 仓库时同步登记 README
|
|
3
|
+
description: 锻造新技能的元技能（造 skill 的 skill）。按 SkillForge 工坊规范从需求出发生成完整技能包（薄入口 SKILL.md + 按阶段拆分的 resources/ + 用户配置 user-config.md），自动植入机制体系：CONFIG_VERSION 配置版本钥匙、user-config 配置抽离、reference 双轨（含 HTML 输出时）、多文件隔离（页面有 localStorage 记忆时）、零侵权脱敏离线纪律（含 HTML 输出时）、产物升级回炉（含 HTML 输出时）、preserve 保护清单（含半定制资产时）、文档同步自检纪律；技能入 SkillForge 仓库时同步登记 README 分类表、cli.js CATEGORIES 与 package.json files。当用户请求创建新技能、造一个 skill、做一个 XX 技能、把 XX 流程固化成技能，或询问 meta-forge 用法（怎么造技能/元锻炉怎么用）时使用。
|
|
4
4
|
allowed-tools: Bash, Read, Write
|
|
5
5
|
disable-model-invocation: false
|
|
6
6
|
---
|
|
@@ -15,8 +15,8 @@ disable-model-invocation: false
|
|
|
15
15
|
1. **需求澄清**（技能名、触发场景、产出形态、可配置项、是否含 HTML 输出、是否入仓库）→ 读 `resources/forge-rules.md` 的「一、澄清清单」
|
|
16
16
|
2. **结构生成**（薄入口 + resources 拆分 + 咨询应答接线）→ 读 `resources/forge-rules.md` 的「二、结构规范」
|
|
17
17
|
3. **机制植入**（CONFIG_VERSION 钥匙 / user-config 抽离 / reference 双轨 / 多文件隔离 / 零侵权脱敏离线 / 产物升级回炉 / preserve 保护清单 / 自检纪律，缺一不可；含 HTML 输出加机制三、七、八，页面有 localStorage 记忆加机制六，含半定制资产加机制五）→ 读 `resources/forge-rules.md` 的「三、机制体系」
|
|
18
|
-
4. **验证环**（静态门禁 grep 逐项 + 含 HTML 时 Playwright 运行时实测：零 JS 错误 / 键带路径 / 刷新恢复 / 多文件隔离 + 交付报告附验证证据，任一未过修复重跑禁止跳过）→ 读 `resources/forge-rules.md` 的「四、验证环」
|
|
19
|
-
5. **仓库登记**（技能入 SkillForge 仓库时：README 技能分类表/技能清单/目录结构 + cli.js CATEGORIES 同步登记，登记后跑 `skill-forge ls` 验证）→ 读 `resources/forge-rules.md` 的「五、仓库登记」
|
|
18
|
+
4. **验证环**（静态门禁 grep 逐项 + 含 HTML 时 Playwright 运行时实测：零 JS 错误 / 键带路径 / 刷新恢复 / 多文件隔离 / 自愈实测 + 交付报告附验证证据，任一未过修复重跑禁止跳过）→ 读 `resources/forge-rules.md` 的「四、验证环」
|
|
19
|
+
5. **仓库登记**（技能入 SkillForge 仓库时：README 技能分类表/技能清单/目录结构 + cli.js CATEGORIES + package.json files 同步登记，登记后跑 `skill-forge ls` 与 `npm pack --dry-run` 验证）→ 读 `resources/forge-rules.md` 的「五、仓库登记」
|
|
20
20
|
6. **使用咨询**（用户只问「怎么造技能」等用法、未要求创建）→ 读 `resources/usage-guide.md`，将其内容原样输出（首行标题改为「元锻炉使用指南」），不创建任何文件
|
|
21
21
|
|
|
22
22
|
## ⚙️ 配置与自定义
|
|
@@ -110,6 +110,7 @@
|
|
|
110
110
|
11. 产物版本戳（含 HTML 的技能）：reference.html 头部含 `<meta name="sf-template" content="<技能名>@N">`（N≥1）；SKILL.md 含「产物升级（回炉）」节且判定含无版本戳/无稳定 ID meta 视为 v0 最旧版
|
|
111
111
|
12. 版本递增与主动提示（含 HTML 的技能）：SKILL.md 回炉节含版本递增判定（业务/数据格式/页面改动均 bump）与主动提示语（顺扫旧产物 + 告知触发语）
|
|
112
112
|
13. 入场动画兜底（含 HTML 且含滚动入场动画的技能）：reference.html 含 2s 兜底强制全显代码（`.rv:not(.in)` 模式或等价），确保 headless 截图 / 打印预览内容全显
|
|
113
|
+
14. 执行层自愈块（含 HTML 且页面有 localStorage 记忆的技能）：HTML 内嵌 JS 含 id meta 校验——非法或缺失（占位残留 / 手写变体 / 误沿用旧值）时按路径键（`sf-heal:` + location.pathname）自愈为 crypto.randomUUID() 标准 v4 并回写 meta，console.warn 显性报警
|
|
113
114
|
|
|
114
115
|
### B. 运行时实测（含 HTML 的技能必做，Playwright headless channel="chrome"）
|
|
115
116
|
|
|
@@ -117,6 +118,7 @@
|
|
|
117
118
|
2. 关键交互实测：主题/状态切换 → localStorage 键带路径 → 刷新恢复
|
|
118
119
|
3. 多文件隔离实测：复制 HTML 到第二路径（用户数据类改成换 ID）→ 两份各自读写键互不干扰；用户数据类加测：同 ID 文件移动到新目录 → 数据保留
|
|
119
120
|
4. 截图验证：headless 全页截图内容完整（标题 / 关键卡片 / 区块可见），入场动画兜底后内容全显；截图空白即失败（真实教训：入场动画无兜底 → headless 截图空白）
|
|
121
|
+
5. 自愈实测（页面有 localStorage 记忆的技能）：把 id meta 改坏（占位值或删除）→ 重新打开页面 → meta 自愈为合法 v4 + console.warn 报警 + localStorage 记忆经路径键恢复（不丢）
|
|
120
122
|
|
|
121
123
|
### C. 验证证据（交付报告必附）
|
|
122
124
|
|
|
@@ -130,3 +132,4 @@
|
|
|
130
132
|
3. cli.js 的 CATEGORIES 数组：同步登记（name/en/skills），与 README 分类表一致
|
|
131
133
|
4. README「目录结构」图：按需补新技能目录
|
|
132
134
|
5. 登记后跑 `skill-forge ls` 验证技能出现在正确分类下
|
|
135
|
+
6. package.json 的 files 数组：补技能目录名——npm 包内容遗漏教训（1.0.5 曾漏 monthly-report/meeting-minutes/quarterly-report 三技能，装包却无技能）；登记后跑 `npm pack --dry-run` 验证新技能目录出现在包内容清单中
|
|
@@ -15,8 +15,8 @@ meta-forge 是「造 skill 的 skill」：把一段重复劳作，按 SkillForge
|
|
|
15
15
|
6. 多文件隔离——页面有 localStorage 记忆时，键按页内嵌唯一 ID（标准 UUID v4）命名空间，多份产物互不串台、改名/移动目录记忆不丢
|
|
16
16
|
7. 零侵权脱敏离线——品牌字体零出现、禁 CDN 页面离线可开、示例数据零真实身份（通用占位）
|
|
17
17
|
8. 产物升级回炉——HTML 带模板版本戳（业务/数据格式/页面改动均 bump），升级后可扫旧产物交互式回炉（浅升级区块替换/深升级 md 重建），生成时顺扫旧版主动提示触发语
|
|
18
|
-
- 交付前跑验证环（偏差必被发现）：静态门禁逐项 grep + 含 HTML 时 Playwright 实测（零 JS 错误 / 键带路径 / 刷新恢复 /
|
|
19
|
-
- 技能入 SkillForge 仓库时，自动登记 README
|
|
18
|
+
- 交付前跑验证环（偏差必被发现）：静态门禁逐项 grep + 含 HTML 时 Playwright 实测（零 JS 错误 / 键带路径 / 刷新恢复 / 多文件隔离 / 自愈实测），验证证据随交付报告附上
|
|
19
|
+
- 技能入 SkillForge 仓库时，自动登记 README 技能分类表/技能清单/目录结构、cli.js CATEGORIES 与 package.json files（npm 包不遗漏技能）
|
|
20
20
|
|
|
21
21
|
## 怎么用
|
|
22
22
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "skill-forge-hub",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.7",
|
|
4
4
|
"description": "SkillForge (技能锻造坊) — a curated collection of AI craft skills. Install once, then pick skills interactively: daily/weekly/monthly/quarterly/annual reports, meeting minutes, article-to-HTML, magic-deck slides, deck-stage PPTX, prompt-pouch manager, Pandoc doc converters, meta-forge.",
|
|
5
5
|
"bin": {
|
|
6
6
|
"skill-forge": "cli.js"
|
|
@@ -24,7 +24,9 @@
|
|
|
24
24
|
"docs",
|
|
25
25
|
"README.md",
|
|
26
26
|
"CHANGELOG.md",
|
|
27
|
-
"LICENSE"
|
|
27
|
+
"LICENSE",
|
|
28
|
+
"README.en.md",
|
|
29
|
+
"CHANGELOG.en.md"
|
|
28
30
|
],
|
|
29
31
|
"keywords": [
|
|
30
32
|
"skillforge",
|