skill-forge-hub 1.3.12 → 1.3.13

package/CHANGELOG.en.md

@@ -4,6 +4,14 @@
 
 Version history of the SkillForge npm package `skill-forge-hub` (command name `skill-forge`).
 
+## 1.3.13 (2026-11-13)
+
+**one-pager template dock slimmer, no auto-close on pick, × close button (@15); version self-check for prompt-pouch & meta-forge**
+
+- one-pager template dock: width tightened from 720px to 480px (fits the content instead of spanning 80% of the screen); picking a template no longer auto-folds the panel (users may click through to compare), close via the new × round button, handle reopens; stamp one-pager@14 → @15
+- prompt-pouch version self-check at all touchpoints: every invocation (generate / init / maintain / retrieve / open) silently compares the page stamp against the current template (two meta lines, zero network, no data touched); the result only affects prompting, never execution — open asks proactively (with an update-point list, rebuild keeps the original pouch-id, prompts.json untouched), maintain/retrieve ends with a one-line nudge, declined once means silent for the session
+- meta-forge mechanism #8 gains "tool-type product version self-check": the clarification list adds a product-type question (tool-type vs snapshot), forging tool-type skills (fixed page reopened often, accumulating data) automatically embeds the all-touchpoint self-check + per-scenario prompting; the static gate adds a matching check, and the template's rebuild section syncs the tool-type branch
+
 ## 1.3.12 (2026-11-13)
 
 **one-pager privilege templates get "mood response": six signature palettes now track the theme's light/dark mood (@14)**

package/CHANGELOG.md

@@ -4,6 +4,14 @@
 
 SkillForge（技能锻造坊）npm 包 `skill-forge-hub`（命令名 `skill-forge`）版本变更记录。
 
+## 1.3.13（2026-11-13）
+
+**one-pager 模板坞收窄适配 + 点选不收起 + × 关闭（@15）；锦囊与元锻炉新增版本自检机制**
+
+- one-pager 模板坞：宽度从 720px 收紧到 480px（内容适配不再占屏八成）；点选模板不再自动收起（用户连点对比不同模板效果），改由面板右上角 × 圆钮关闭、把手可重开；版本戳 one-pager@14 → @15
+- prompt-pouch 版本自检全时机：每次调用（生成/初始化/维护/取用/打开）先静默比对页面版本戳与模板当前版（两行 meta、零网络、不碰数据），结果只影响提示不影响执行；提示分场景——打开时主动询问升级（附更新点清单，回炉升级沿用原页 pouch-id、prompts.json 数据不动）、维护/取用收尾一句话轻提示、拒绝后本次会话静默
+- meta-forge 机制八新增「工具型产物版本自检」：澄清清单新增产物类型一问（工具型/快照型分流），锻造工具型技能（固定页面反复打开、数据累积）自动植入全时机版本自检 + 场景分级提示；验证环静态门禁新增对应检查项，template 回炉节模板同步工具型分支
+
 ## 1.3.12（2026-11-13）
 
 **one-pager 特许模板「氛围响应」：六款风格固有色随主题明暗冷暖适配（@14）**

package/meta-forge/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: meta-forge
-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 用法（怎么造技能/元锻炉怎么用）时使用。
+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 用法（怎么造技能/元锻炉怎么用）时使用。
 allowed-tools: Bash, Read, Write
 disable-model-invocation: false
 ---
@@ -14,7 +14,7 @@ disable-model-invocation: false
 0. **读用户配置**（DIR/REGISTER/CONFIG_VERSION）→ 先 Read 同目录 `user-config.md`
 1. **需求澄清**（技能名、触发场景、产出形态、可配置项、是否含 HTML 输出、是否入仓库）→ 读 `resources/forge-rules.md` 的「一、澄清清单」
 2. **结构生成**（薄入口 + resources 拆分 + 咨询应答接线）→ 读 `resources/forge-rules.md` 的「二、结构规范」
-3. **机制植入**（CONFIG_VERSION 钥匙 / user-config 抽离 / reference 双轨 / 多文件隔离 / 零侵权脱敏离线 / 产物升级回炉 / preserve 保护清单 / 自检纪律，缺一不可；含 HTML 输出加机制三、七、八，页面有 localStorage 记忆加机制六，含半定制资产加机制五）→ 读 `resources/forge-rules.md` 的「三、机制体系」
+3. **机制植入**（CONFIG_VERSION 钥匙 / user-config 抽离 / reference 双轨 / 多文件隔离 / 零侵权脱敏离线 / 产物升级回炉 / preserve 保护清单 / 自检纪律，缺一不可；含 HTML 输出加机制三、七、八，页面有 localStorage 记忆加机制六，含半定制资产加机制五，工具型产物加机制八「工具型产物版本自检」）→ 读 `resources/forge-rules.md` 的「三、机制体系」
 4. **验证环**（静态门禁 grep 逐项 + 含 HTML 时 Playwright 运行时实测：零 JS 错误 / 键带路径 / 刷新恢复 / 多文件隔离 / 自愈实测 + 交付报告附验证证据，任一未过修复重跑禁止跳过）→ 读 `resources/forge-rules.md` 的「四、验证环」
 5. **仓库登记**（技能入 SkillForge 仓库时：README 技能分类表/技能清单/目录结构 + cli.js CATEGORIES + package.json files 同步登记，登记后跑 `skill-forge ls` 与 `npm pack --dry-run` 验证）→ 读 `resources/forge-rules.md` 的「五、仓库登记」
 6. **使用咨询**（用户只问「怎么造技能」等用法、未要求创建）→ 读 `resources/usage-guide.md`，将其内容原样输出（首行标题改为「元锻炉使用指南」），不创建任何文件
@@ -42,7 +42,7 @@ disable-model-invocation: false
 
 ## 规则速览
 
-- 机制体系缺一不可：CONFIG_VERSION 钥匙（配置版本机制节 + user-config 配置块首行 CONFIG_VERSION: 1）、user-config 抽离（用户可改配置全部出站，SKILL.md 只引用不内嵌）、reference 双轨（含 HTML 输出的技能以 reference.html 为样式真相源）、多文件隔离（页面有 localStorage 记忆时键带路径命名空间）、零侵权脱敏离线（品牌字体零出现、禁 CDN 离线可开、示例数据零真实身份）、产物升级回炉（HTML 带模板版本戳、业务/数据格式/页面改动均 bump、旧产物可交互回炉、生成时顺扫旧版主动提示）、preserve 保护清单（半定制资产 .preserve 声明、CLI 升级永不覆盖、官方更新另存 .upstream 对照）、自检纪律（改一处 grep 全仓）
+- 机制体系缺一不可：CONFIG_VERSION 钥匙（配置版本机制节 + user-config 配置块首行 CONFIG_VERSION: 1）、user-config 抽离（用户可改配置全部出站，SKILL.md 只引用不内嵌）、reference 双轨（含 HTML 输出的技能以 reference.html 为样式真相源）、多文件隔离（页面有 localStorage 记忆时键带路径命名空间）、零侵权脱敏离线（品牌字体零出现、禁 CDN 离线可开、示例数据零真实身份）、产物升级回炉（HTML 带模板版本戳、业务/数据格式/页面改动均 bump、旧产物可交互回炉、生成时顺扫旧版主动提示、工具型产物全时机版本自检+场景分级提示）、preserve 保护清单（半定制资产 .preserve 声明、CLI 升级永不覆盖、官方更新另存 .upstream 对照）、自检纪律（改一处 grep 全仓）
 - 薄入口：SKILL.md 只留 frontmatter / 生成流程 / 配置节 / 机制节 / 规则速览；重内容按阶段拆 resources/，一文件一职责
 - 新技能必须带 user-config.md（含 CONFIG_VERSION: 1）、resources/usage-guide.md（咨询应答原样输出源）与 resources/skillforge-guide.txt + skillforge-guide.html（SkillForge 使用指引双版，SKILL.md 末尾带整体咨询触发节）
 - 完整规则（澄清清单 / 结构规范 / 机制体系 / 验证环 / 仓库登记）见 `resources/forge-rules.md`

package/meta-forge/resources/forge-rules.md

@@ -12,7 +12,8 @@
 4. **可配置项**：哪些行为用户会想改？→ 全部进 user-config.md
 5. **是否含 HTML 输出**：是 → 必须建 reference.html 双轨机制（机制三）；否 → 无此要求
 6. **页面是否有 localStorage 记忆**（含 HTML 时必问：主题/偏好/用户数据等）：是 → 机制六（多文件隔离）必植入
-7. **归属**：入 SkillForge 仓库（需登记）还是独立技能（不登记）？
+7. **产物类型**（含 HTML 时必问）：工具型——固定页面反复打开、数据累积（如提示词管理台），升级提示是体验关键；快照型/生成型——生成即归档（如日报/文章页），旧产物不再改。工具型 → 机制八「工具型产物版本自检」必植入
+8. **归属**：入 SkillForge 仓库（需登记）还是独立技能（不登记）？
 
 ## 二、结构规范（薄入口 + resources 拆分）
 
@@ -94,7 +95,8 @@
 - 用户数据类细则（IndexedDB 数据按稳定 ID 命名空间存取的技能）：深升级重建必须沿用原页稳定 ID meta 值（换 ID = 数据失联，重建后原收藏/分组照旧读回）；<DATA_DIR> 数据文件一概不动
 - 回炉交互：用户说「升级旧产物/回炉」→ 扫落盘目录读版本戳筛旧版（无版本戳或缺少稳定 ID meta 的产物视为 v0 最旧版，一并进清单） → 列清单（文件/旧版本/手改状态：旧 html 正文与 md 正文对比，不一致视为可能手改）→ AskUserQuestion 选全部或部分 → 逐份升级 → 报告三段式（✅ 已升级 / ⚠️ 手改保留 / 🟡 失败项原因）
 - 版本递增判定：模板业务改动（板块/段落/标题体系）、数据格式改动（字段/存储结构）、页面改动（样式/布局/交互）任一发生即模板升级，版本戳 +1 并同步 reference.html 与 SKILL.md「产物升级（回炉）」节；纯措辞润色不 bump
-- 主动提示：每次生成 HTML 或用户使用该技能 HTML 产出时，顺扫落盘目录读版本戳；发现低于当前模板版本的旧产物，主动告知「技能模板已升级至 vN，检测到 X 份旧版产物（vN-1），说『把我旧XX都升级成新样式』即可一键升级」，不让用户背触发语
+- 主动提示（快照型/生成型产物——生成即归档，如日报/文章页）：每次生成 HTML 时顺扫落盘目录读版本戳；发现低于当前模板版本的旧产物，主动告知「技能模板已升级至 vN，检测到 X 份旧版产物（vN-1），说『把我旧XX都升级成新样式』即可一键升级」，不让用户背触发语
+- 工具型产物版本自检（固定页面反复打开、数据累积的技能——如提示词管理台，澄清清单确认工具型时必植入）：每次调用本 skill（生成/初始化/维护/取用/打开）先静默自检——读目标页面版本戳与 reference.html 当前版比对（两行 meta、零网络、不碰数据），结果只影响「提示」不影响「执行」，版本旧也绝不拒绝或推迟本次任务。提示分场景：打开场景主动问（起服务前 AskUserQuestion：A 升级后打开（推荐）——走回炉流程、沿用原页稳定 ID meta 值、数据文件一概不动；B 直接打开旧版——本次会话不再询问；询问时附更新点清单：检索 CHANGELOG 相关条目 + 版本差区间归纳 2-5 条用户可感知变化，一句话一条）；维护/取用场景照常执行、收尾报告一句轻提示（「页面还是旧版（@N，当前 @M），说『升级XX』即可换新」，不弹问不打断）；用户拒绝过升级则本次会话静默。SKILL.md 执行流程第 0 步后固定写「版本自检（静默前置，全时机）」步骤
 
 ## 四、验证环（交付前全过，偏差必被发现）
 
@@ -112,8 +114,9 @@
 10. 示例数据脱敏：全文 grep 无真实项目名/人名/公司名/平台名/本机路径（/Users/具体用户名、~/SmartDeveloper 等）；页脚署名 GENERATED BY AI TEAM
 11. 产物版本戳（含 HTML 的技能）：reference.html 头部含 `<meta name="sf-template" content="<技能名>@N">`（N≥1）；SKILL.md 含「产物升级（回炉）」节且判定含无版本戳/无稳定 ID meta 视为 v0 最旧版
 12. 版本递增与主动提示（含 HTML 的技能）：SKILL.md 回炉节含版本递增判定（业务/数据格式/页面改动均 bump）与主动提示语（顺扫旧产物 + 告知触发语）
-13. 入场动画兜底（含 HTML 且含滚动入场动画的技能）：reference.html 含 2s 兜底强制全显代码（`.rv:not(.in)` 模式或等价），确保 headless 截图 / 打印预览内容全显
-14. 执行层自愈块（含 HTML 且页面有 localStorage 记忆的技能）：HTML 内嵌 JS 含 id meta 校验——非法或缺失（占位残留 / 手写变体 / 误沿用旧值）时按路径键（`sf-heal:` + location.pathname）自愈为 crypto.randomUUID() 标准 v4 并回写 meta，console.warn 显性报警
+13. 工具型产物版本自检（工具型技能）：SKILL.md 执行流程含「版本自检（静默前置，全时机）」步骤（静默比对版本戳、零网络不碰数据、结果只影响提示不影响执行）+ 场景分级提示（打开主动问/维护取用一句话/拒绝会话静默）
+14. 入场动画兜底（含 HTML 且含滚动入场动画的技能）：reference.html 含 2s 兜底强制全显代码（`.rv:not(.in)` 模式或等价），确保 headless 截图 / 打印预览内容全显
+15. 执行层自愈块（含 HTML 且页面有 localStorage 记忆的技能）：HTML 内嵌 JS 含 id meta 校验——非法或缺失（占位残留 / 手写变体 / 误沿用旧值）时按路径键（`sf-heal:` + location.pathname）自愈为 crypto.randomUUID() 标准 v4 并回写 meta，console.warn 显性报警
 
 ### B. 运行时实测（含 HTML 的技能必做，Playwright headless channel="chrome"）
 

package/one-pager/SKILL.md

@@ -62,7 +62,7 @@ disable-model-invocation: false
 
 ## 产物升级（回炉）
 
-生成 HTML 时头部写版本戳 `<meta name="sf-template" content="one-pager@14">`（模板升级时递增 @N 并同步 reference.html 与本文档）。用户说「升级旧海报/回炉」时：顺扫海报库根目录（DIR 值）下两种形态——新子目录形态 `<slug>/poster.html` 与旧平铺形态 `poster-*.html`，读版本戳筛旧版（无版本戳或缺少 `<meta name="poster-id">` 稳定 ID 的产物视为 v0 最旧版，一并进清单）→ 列清单（文件/旧版本）→ AskUserQuestion 选全部或部分 → 逐份升级：浅升级（仅 CSS/JS 变化）对旧页替换 `<style>` 块与交互脚本、正文原样保留；深升级（DOM 结构变化）从同目录 md 底稿按当前 reference.html 重建，先备份旧版 `.bak-时间戳`，重建必须沿用原页 poster-id meta 值（换 ID = 模板/主题记忆失联）→ 报告三段式：✅ 已升级清单 / ⚠️ 手改保留说明 / 🟡 失败项原因。模板改动分级：业务改动、数据格式改动、页面改动任一发生即模板升级，版本戳 +1 并同步 reference.html 与本文档；纯措辞润色不 bump。每次生成 HTML 时顺扫落盘目录读版本戳：发现旧版产物主动告知用户「说『把我旧海报都升级成新样式』即可一键升级」。
+生成 HTML 时头部写版本戳 `<meta name="sf-template" content="one-pager@15">`（模板升级时递增 @N 并同步 reference.html 与本文档）。用户说「升级旧海报/回炉」时：顺扫海报库根目录（DIR 值）下两种形态——新子目录形态 `<slug>/poster.html` 与旧平铺形态 `poster-*.html`，读版本戳筛旧版（无版本戳或缺少 `<meta name="poster-id">` 稳定 ID 的产物视为 v0 最旧版，一并进清单）→ 列清单（文件/旧版本）→ AskUserQuestion 选全部或部分 → 逐份升级：浅升级（仅 CSS/JS 变化）对旧页替换 `<style>` 块与交互脚本、正文原样保留；深升级（DOM 结构变化）从同目录 md 底稿按当前 reference.html 重建，先备份旧版 `.bak-时间戳`，重建必须沿用原页 poster-id meta 值（换 ID = 模板/主题记忆失联）→ 报告三段式：✅ 已升级清单 / ⚠️ 手改保留说明 / 🟡 失败项原因。模板改动分级：业务改动、数据格式改动、页面改动任一发生即模板升级，版本戳 +1 并同步 reference.html 与本文档；纯措辞润色不 bump。每次生成 HTML 时顺扫落盘目录读版本戳：发现旧版产物主动告知用户「说『把我旧海报都升级成新样式』即可一键升级」。
 
 ## 规则速览
 

package/one-pager/resources/reference.html

@@ -3,7 +3,7 @@
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<meta name="sf-template" content="one-pager@14">
+<meta name="sf-template" content="one-pager@15">
 <meta name="poster-id" content="REF-POSTER-0000">
 <title>AI 改变工作 · 一页纸海报</title>
 <style>
@@ -633,7 +633,7 @@ body{background:linear-gradient(180deg,var(--bg) 12%,var(--bg2) 135%);color:var(
 .tpl-watermark footer{display:flex;flex-direction:column;align-items:flex-end;font-size:12px;color:var(--muted);gap:6px;margin-top:auto}
 
 /* ▼ 用户模板 CSS 内嵌点（TPL_DIR 模板的 TPL_CSS 块插到本行之前，无用户模板则保持原样） */
-/* ═══ 切换坞（可折叠）：模板坞（32 标签七组流派 + 用户模板）在顶部、主题坞（25 色点 5×5）在右下角；默认折叠成胶囊把手，点开选完自动收起 ═══ */
+/* ═══ 切换坞（可折叠）：模板坞（32 标签七组流派 + 用户模板）在顶部、主题坞（25 色点 5×5）在右下角；默认折叠成胶囊把手，点开可连续试选不收起，右上角 × 圆钮关闭 ═══ */
 .dock-tpl{position:fixed;right:18px;top:18px;display:flex;flex-direction:column;align-items:flex-end;gap:8px;z-index:1001}
 .dock-theme{position:fixed;right:18px;bottom:18px;display:flex;flex-direction:column;align-items:flex-end;gap:8px;z-index:1001}
 .dock-bar{display:flex;align-items:center;gap:8px;background:var(--panel-solid);border:1px solid var(--border);border-radius:999px;padding:7px 13px;color:var(--text);cursor:pointer;box-shadow:0 4px 18px rgba(0,0,0,.3);transition:border-color .15s ease;font-family:inherit}
@@ -644,6 +644,7 @@ body{background:linear-gradient(180deg,var(--bg) 12%,var(--bg2) 135%);color:var(
 .dock-theme.fold .bar-arrow{transform:rotate(-90deg)}
 .dock-theme .bar-arrow{transform:rotate(180deg)}
 .dock-body{display:flex;flex-wrap:wrap;justify-content:flex-end;gap:6px;background:var(--panel-solid);border:1px solid var(--border);border-radius:14px;padding:8px 10px;max-width:min(720px,calc(100vw - 36px));box-shadow:0 4px 18px rgba(0,0,0,.3)}
+.dock-tpl .dock-body{max-width:min(480px,calc(100vw - 36px));position:relative}
 .dock-theme .dock-body{display:grid;grid-template-columns:repeat(5,18px);gap:11px 10px;border-radius:14px;padding:12px 13px;max-width:none;position:relative}
 .th-close{position:absolute;top:-10px;right:-10px;width:22px;height:22px;border-radius:50%;border:1px solid var(--border);background:var(--panel-solid);color:var(--muted);font-size:14px;line-height:1;display:flex;align-items:center;justify-content:center;cursor:pointer;box-shadow:0 2px 8px rgba(0,0,0,.28);padding:0}
 .th-close:hover{color:var(--text);border-color:var(--accent)}
@@ -710,6 +711,7 @@ html.theming, html.theming *, html.theming *::before, html.theming *::after{ tra
 <div class="dock-tpl fold" id="tplDock">
   <button class="dock-bar" id="tplBar" type="button" title="模板切换（点击展开/收起）"><span class="bar-tpl-name">模板</span><span class="bar-arrow">▾</span></button>
   <div class="dock-body">
+  <button class="th-close" id="tpClose" type="button" title="关闭（点顶部「模板」标签可重新打开）" aria-label="关闭模板面板">×</button>
   <span class="tp-sep">现代主义</span>
   <button class="tp-btn on" data-tpl="classic" title="经典舞台">经典</button>
   <button class="tp-btn" data-tpl="minimal" title="极简留白">极简</button>
@@ -1259,7 +1261,6 @@ html.theming, html.theming *, html.theming *::before, html.theming *::after{ tra
       try { localStorage.setItem(TPL_KEY, curP); } catch(e) {}
       document.querySelectorAll('.tp-btn').forEach(function(x){ x.classList.toggle('on', x === b); });
       var bt = document.querySelector('#tplBar .bar-tpl-name'); if (bt) bt.textContent = '模板 · ' + b.textContent;
-      document.getElementById('tplDock').classList.add('fold');
       render();
     });
   });
@@ -1282,6 +1283,8 @@ html.theming, html.theming *, html.theming *::before, html.theming *::after{ tra
   bindBar('themeDock');
   var thClose = document.getElementById('thClose');
   if (thClose) thClose.addEventListener('click', function(){ document.getElementById('themeDock').classList.add('fold'); });
+  var tpClose = document.getElementById('tpClose');
+  if (tpClose) tpClose.addEventListener('click', function(){ document.getElementById('tplDock').classList.add('fold'); });
   var initTplBtn = document.querySelector('#tplDock .tp-btn[data-tpl="' + curP + '"]');
   var btEl = document.querySelector('#tplBar .bar-tpl-name');
   if (btEl) btEl.textContent = '模板 · ' + (initTplBtn ? initTplBtn.textContent : '自定义');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-forge-hub",
-  "version": "1.3.12",
+  "version": "1.3.13",
   "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.",
   "bin": {
     "skill-forge": "cli.js"

package/prompt-pouch/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prompt-pouch
-description: 锦囊（prompt-pouch）提示词管理 Skill：生成并维护一个本地 HTML 提示词管理页面（锦囊管理台）， 暖棕金/深蓝科技/IDEA 黑亮/IDEA 白亮/薄荷绿五套主题（右下角换肤坞随时切换，THEME 配置可设默认），页面披四层科技氛围（网格/星点/扫描线/光带，与日报/周报/年报同源、卡片带细纹），功能为分组侧栏（带计数徽章）+ 搜索（关键词高亮）+ 卡片网格 + 四种排序（最新添加默认/最近使用/使用频率/手动， 拖拽与 ▲▼ 自动切手动）+ 分组条拖拽排序 + 标签交互（点击过滤/悬停删/快捷加）+ 导入导出 JSON 备份 + 使用统计 + 收藏星标 + {变量} 插值填充面板 + 一键复制 + 卡片「👁 详情」弹窗 （全文滚动查看 / 复制 / 修改 / 创建修改时间线）；数据存 <DIR>/data/prompts.json（DATA_DIR 可配）， 页面与数据严格分离，双笔协作（页面经授权目录直写，AI 代笔维护）。四类任务：①初始化——目标目录无页面时确认目录（默认用户配置 DIR） 并生成 prompt-pouch.html（样式真相源为 resources/reference.html，原样复制）与 data/prompts.json （默认示例五组：写作输出/沟通协作/规划执行/复盘成长/提问艺术，每条带 createdAt；页面另内置同款示例种子 DEFAULT_POUCH，prompts.json 读不到时兜底展示）；②维护——用户说「把这段话/这段对话/这个文件/XX 加进锦囊、存成提示词、收藏这句话」或口述增删改提示词与分组、调整排序、导入导出备份、 切换收藏，读写 prompts.json（UTF-8、2 空格缩进），用户刷新页面即见；③取用——用户说「锦囊里有什么适合 XX 的」列候选推荐；日常任务（写日报/周报/复盘/邮件等）动手前先查锦囊匹配模板，有则套用执行、无则完成后轻问是否入囊。④打开——用户说「打开锦囊」时 起本地服务并按平台打开浏览器访问管理页面。 数据通过 HTTP 方式访问（file:// 直开会回退浏览器缓存快照，需提示用户起本地服务）。 当用户问「锦囊怎么用/使用说明」时输出 resources/usage-guide.md 内容，不执行任何文件操作。
+description: 锦囊（prompt-pouch）提示词管理 Skill：生成并维护一个本地 HTML 提示词管理页面（锦囊管理台）， 暖棕金/深蓝科技/IDEA 黑亮/IDEA 白亮/薄荷绿五套主题（右下角换肤坞随时切换，THEME 配置可设默认），页面披四层科技氛围（网格/星点/扫描线/光带，与日报/周报/年报同源、卡片带细纹），功能为分组侧栏（带计数徽章）+ 搜索（关键词高亮）+ 卡片网格 + 四种排序（最新添加默认/最近使用/使用频率/手动， 拖拽与 ▲▼ 自动切手动）+ 分组条拖拽排序 + 标签交互（点击过滤/悬停删/快捷加）+ 导入导出 JSON 备份 + 使用统计 + 收藏星标 + {变量} 插值填充面板 + 一键复制 + 卡片「👁 详情」弹窗 （全文滚动查看 / 复制 / 修改 / 创建修改时间线）；数据存 <DIR>/data/prompts.json（DATA_DIR 可配）， 页面与数据严格分离，双笔协作（页面经授权目录直写，AI 代笔维护）。四类任务：①初始化——目标目录无页面时确认目录（默认用户配置 DIR） 并生成 prompt-pouch.html（样式真相源为 resources/reference.html，原样复制）与 data/prompts.json （默认示例五组：写作输出/沟通协作/规划执行/复盘成长/提问艺术，每条带 createdAt；页面另内置同款示例种子 DEFAULT_POUCH，prompts.json 读不到时兜底展示）；②维护——用户说「把这段话/这段对话/这个文件/XX 加进锦囊、存成提示词、收藏这句话」或口述增删改提示词与分组、调整排序、导入导出备份、 切换收藏，读写 prompts.json（UTF-8、2 空格缩进），用户刷新页面即见；③取用——用户说「锦囊里有什么适合 XX 的」列候选推荐；日常任务（写日报/周报/复盘/邮件等）动手前先查锦囊匹配模板，有则套用执行、无则完成后轻问是否入囊。④打开——用户说「打开锦囊」时 起本地服务并按平台打开浏览器访问管理页面（打开前静默自检页面版本，旧则列出更新点询问是否升级，同意走回炉升级）。 数据通过 HTTP 方式访问（file:// 直开会回退浏览器缓存快照，需提示用户起本地服务）。 当用户问「锦囊怎么用/使用说明」时输出 resources/usage-guide.md 内容，不执行任何文件操作。
 allowed-tools: ["Bash", "Read", "Write", "Edit"]
 disable-model-invocation: false
 ---
@@ -24,6 +24,9 @@ disable-model-invocation: false
 ## 执行流程
 
 0. **读用户配置**（DIR/DIR_WIN/PORT/DATA_DIR/BACKUP_DIR/INIT_DATA/CONFIRM/THEME/CONFIG_VERSION）→ 先 Read 同目录 `user-config.md`
+0.1 **版本自检（静默前置，全时机）**：目标目录存在 `prompt-pouch.html` 时，读其 `<meta name="sf-template">` 版本戳与 `resources/reference.html` 当前版比对（读两行 meta，零网络、不碰数据），结果只影响「提示」不影响「执行」：
+   - 版本一致 / 无页面（首次初始化）→ 静默跳过，直接进对应流程
+   - 版本旧 → 记下版本差（旧 @N → 当前 @M），按场景分级提示（打开见步骤 4、维护见步骤 2、取用见步骤 3）；禁止因版本旧而拒绝或推迟执行本次任务
 0.5 **意图识别与确认**：
    - **明确入囊**：用户说「把这段话/这段对话/这个文件 加进锦囊、存成提示词、收藏这句话、整理进锦囊」→ 直接进入维护或批量整理流程
    - **模糊意图**：用户表达可能指向锦囊但不明确（如「保存这个」「记一下这个」）→ 先 AskUserQuestion 确认（选项：放入锦囊提示词 / 只是本次会话临时记录 / 其它），确认后执行，不擅自写文件
@@ -42,6 +45,7 @@ disable-model-invocation: false
    - **分类交互**：用户说「添加 XX」但未说分组 → 先按现有分组语义智能匹配（如内容讲周报 → 建议「写作输出 ✍️」并说明理由），匹配到则默认归入、用户可改口换组；匹配不到 → AskUserQuestion 列出全部现有分组（加「新建分组」选项）让用户选；用户指定的分组不存在 → 明确告知该分组不存在，并问是否新建（新建则补 groups 条目：id 16 位数字主键（雪花规则见 data-format.md）、name 中文、icon 一个 emoji）
    - **调优**：用户说「这条不好用，帮我改」→ 读原文 + 用户反馈 → 输出改版对照（旧 → 新）→ 用户确认后写回（updatedAt 更新到时分秒，写回前重读合并 + 先备份）
    - **效果反馈**：用户说「这条好用 / 这条用着顺手」→ 定位条目，把反馈写进可选 `notes` 字段（无则新建；一段使用心得/效果备注，页面详情弹窗「📝 使用心得」只读展示，页面表单不编辑此字段）；说「这条不好用」但不想改 → 同样记入 notes 留档
+   - **版本轻提示**：0.1 自检发现页面旧版 → 本次维护照常执行（读写 prompts.json 与页面版本无关），收尾报告末尾附一句「锦囊页面还是旧版（@N，当前 @M），说『升级锦囊』即可换新」，不弹问、不打断；用户拒绝过升级则本次会话静默不提
 2.5 **交付前自检**（初始化与每次维护落盘后必做，硬门禁不可跳过）：
    - **json 机器校验**：`python3 -c "import json;json.load(open('<DIR>/<DATA_DIR>/prompts.json',encoding='utf-8'))"`（Windows 用 py）解析通过，且 schema 自查无缺（version/groups/prompts 齐全、group 引用存在、order 连续、新增条目 createdAt 到时分秒）
    - **页面零报错验证**：Playwright headless（缺则 `pip3 install --user playwright`；用系统 Chrome，channel="chrome" 无需下载浏览器）→ 起本地服务 `cd <DIR> && python3 -m http.server <PORT>` → goto `http://localhost:<PORT>/prompt-pouch.html` → 挂 pageerror 监听（零容忍）→ 断言卡片数 `document.querySelectorAll('.card').length` 等于 prompts.json 的 prompts 条数（证明数据被正确读到；落回内置示例种子即自检失败）→ 收尾停服务
@@ -51,8 +55,11 @@ disable-model-invocation: false
    - 用户选定某条 → 直接按该模板执行任务（含 {变量} 按上下文填充）或输出正文供复制；用户不选 → 不强行套用
    - 无匹配 → 正常完成任务，完成后轻问一句「这次的写法要不要收进锦囊？下次直接复用」——用户同意则衔接维护/批量整理流程
    - **日常任务取用纪律**：用户请求写日报/周报/复盘/邮件等常见任务时，先静默快扫锦囊有无匹配模板：有 → 告知「锦囊里有现成的 XX 模板，我来套用」并执行；无 → 不打断、正常完成，完成后一句轻问是否入囊（用户说「不用查锦囊」则本次跳过）
+   - **版本轻提示**：0.1 自检发现页面旧版 → 取用照常执行，收尾一句话附注（同上）；拒绝过则静默
 4. **打开页面**：用户说「打开锦囊 / 打开提示词页面」→
    - 目标目录无页面时先执行步骤 1（初始化）
+   - **打开时升级询问**：0.1 自检发现页面旧版 → 起服务前先 AskUserQuestion（选项：A 升级后打开（推荐）——走「产物升级（回炉）」流程：备份旧页 .bak-时间戳 + 换新版并沿用原页 pouch-id（收藏/分组记忆不丢）+ prompts.json 数据不动，升完照常打开；B 直接打开旧版——本次会话不再询问）。询问时附更新点清单：检索 CHANGELOG.md 中 prompt-pouch 相关条目，结合版本差区间列出 2-5 条用户可感知的变化（新功能/体验改进，一句话一条）；CHANGELOG 查不到时据 reference.html 与旧页差异自行归纳
+   - 版本一致 → 直接起服务打开，零打扰
    - 后台起本地服务（`cd <DIR> && python3 -m http.server <PORT>`，Windows 用 `py -m http.server`；端口被占则换 PORT+1 再试）
    - 按平台打开浏览器：darwin → `open http://localhost:<PORT>/prompt-pouch.html`；win32 → `start` 同 URL；linux → `xdg-open` 同 URL
    - 打开后对话中报访问地址（http://localhost:<PORT>/prompt-pouch.html）与页面文件完整路径
@@ -78,7 +85,7 @@ disable-model-invocation: false
 
 ## 产物升级（回炉）
 
-生成/初始化页面时头部写版本戳 `<meta name="sf-template" content="prompt-pouch@17">`（模板升级时递增 @N 并同步 reference.html 与本文档）。用户说「升级旧锦囊/回炉旧页面/旧锦囊换新样式」时：扫 `<DIR>` 下 `prompt-pouch.html` 读版本戳筛出旧版（无版本戳或缺少 `<meta name="pouch-id">` 稳定 ID 的产物视为 v0 最旧版，一并进清单）→ 列清单（文件/旧版本/有无用户数据）→ AskUserQuestion 选全部或部分 → 逐份升级：浅升级（仅 CSS/JS 变化）对旧页替换 `<style>` 块与交互脚本；深升级（DOM 结构变化）从 reference.html 重建，**必须沿用原页 pouch-id meta 值**（IndexedDB 用户数据按 pouch-id 命名空间存取，换 ID = 数据失联，重建后原收藏/分组照旧读回），`<DIR>/<DATA_DIR>/prompts.json` 数据文件一概不动，先备份旧页 `.bak-时间戳` → 报告三段式：✅ 已升级清单 / ⚠️ 手改保留说明 / 🟡 失败项原因。模板改动分级：业务改动（板块/段落/标题体系）、数据格式改动（字段/存储结构）、页面改动（样式/布局/交互）任一发生即模板升级，版本戳 +1 并同步 reference.html 与本文档；纯措辞润色不 bump。每次生成/初始化新锦囊时顺扫 `<DIR>` 读版本戳：发现旧版产物主动告知「技能模板已升级至 vN，检测到 X 份旧版锦囊，说『把我旧锦囊都升级成新样式』即可一键升级」，不让用户背触发语。
+生成/初始化页面时头部写版本戳 `<meta name="sf-template" content="prompt-pouch@17">`（模板升级时递增 @N 并同步 reference.html 与本文档）。用户说「升级旧锦囊/回炉旧页面/旧锦囊换新样式」时：扫 `<DIR>` 下 `prompt-pouch.html` 读版本戳筛出旧版（无版本戳或缺少 `<meta name="pouch-id">` 稳定 ID 的产物视为 v0 最旧版，一并进清单）→ 列清单（文件/旧版本/有无用户数据）→ AskUserQuestion 选全部或部分 → 逐份升级：浅升级（仅 CSS/JS 变化）对旧页替换 `<style>` 块与交互脚本；深升级（DOM 结构变化）从 reference.html 重建，**必须沿用原页 pouch-id meta 值**（IndexedDB 用户数据按 pouch-id 命名空间存取，换 ID = 数据失联，重建后原收藏/分组照旧读回），`<DIR>/<DATA_DIR>/prompts.json` 数据文件一概不动，先备份旧页 `.bak-时间戳` → 报告三段式：✅ 已升级清单 / ⚠️ 手改保留说明 / 🟡 失败项原因。模板改动分级：业务改动（板块/段落/标题体系）、数据格式改动（字段/存储结构）、页面改动（样式/布局/交互）任一发生即模板升级，版本戳 +1 并同步 reference.html 与本文档；纯措辞润色不 bump。**每次调用本 skill（生成/初始化/维护/取用/打开）都先顺扫 `<DIR>` 读版本戳**（见步骤 0.1）：发现旧版产物按场景分级提示——打开场景主动询问升级（步骤 4），维护/取用场景收尾一句话轻提示（步骤 2/3），初始化生成场景直接按当前模板生成并主动告知；用户拒绝升级后本次会话不再提示，不让用户背触发语。
 
 ## ⚙️ 配置与自定义主题
 

package/template/SKILL.md

@@ -35,7 +35,7 @@ disable-model-invocation: false
 
 ## 产物升级（回炉）——仅含 HTML 输出的技能保留本节，否则删除
 
-生成 HTML 时头部写版本戳 `<meta name="sf-template" content="<skill>@1">`（模板升级时递增 @N 并同步 reference.html 与本文档）。用户说「升级旧产物/回炉旧页面/旧XX换新样式」时：扫落盘目录读版本戳筛出旧版（无版本戳或缺少稳定 ID meta 的产物视为 v0 最旧版，一并进清单）→ 列清单（文件/旧版本/手改状态）→ AskUserQuestion 选全部或部分 → 逐份升级：浅升级（仅 CSS/JS 变化）对旧页替换 `<style>` 块与交互脚本、正文原样保留；深升级（DOM 结构变化）从同目录 md 底稿按当前 reference.html 重建且**沿用原页稳定 ID meta 值**（用户数据类换 ID = 数据失联），先备份旧版 `.bak-时间戳` → 报告三段式：✅ 已升级清单 / ⚠️ 手改保留说明 / 🟡 失败项原因。模板改动分级：业务改动（板块/段落/标题体系）、数据格式改动（字段/存储结构）、页面改动（样式/布局/交互）任一发生即模板升级，版本戳 +1 并同步 reference.html 与本文档；纯措辞润色不 bump。每次生成 HTML 时顺扫落盘目录读版本戳：发现旧版产物主动告知「技能模板已升级至 vN，检测到 X 份旧版产物，说『把我旧XX都升级成新样式』即可一键升级」，不让用户背触发语。
+生成 HTML 时头部写版本戳 `<meta name="sf-template" content="<skill>@1">`（模板升级时递增 @N 并同步 reference.html 与本文档）。用户说「升级旧产物/回炉旧页面/旧XX换新样式」时：扫落盘目录读版本戳筛出旧版（无版本戳或缺少稳定 ID meta 的产物视为 v0 最旧版，一并进清单）→ 列清单（文件/旧版本/手改状态）→ AskUserQuestion 选全部或部分 → 逐份升级：浅升级（仅 CSS/JS 变化）对旧页替换 `<style>` 块与交互脚本、正文原样保留；深升级（DOM 结构变化）从同目录 md 底稿按当前 reference.html 重建且**沿用原页稳定 ID meta 值**（用户数据类换 ID = 数据失联），先备份旧版 `.bak-时间戳` → 报告三段式：✅ 已升级清单 / ⚠️ 手改保留说明 / 🟡 失败项原因。模板改动分级：业务改动（板块/段落/标题体系）、数据格式改动（字段/存储结构）、页面改动（样式/布局/交互）任一发生即模板升级，版本戳 +1 并同步 reference.html 与本文档；纯措辞润色不 bump。每次生成 HTML 时顺扫落盘目录读版本戳：发现旧版产物主动告知「技能模板已升级至 vN，检测到 X 份旧版产物，说『把我旧XX都升级成新样式』即可一键升级」，不让用户背触发语。（工具型产物——固定页面反复打开、数据累积——每次调用本 skill 全时机顺扫，执行流程第 0 步后固定加「版本自检（静默前置，全时机）」步骤：静默比对版本戳、结果只影响提示不影响执行；打开场景主动问——起服务前 AskUserQuestion「A 升级后打开（推荐）/B 直接打开旧版（本次会话不再问）」附更新点清单；维护/取用场景收尾一句话轻提示；拒绝过后本会话静默）
 
 ## 文档同步自检纪律（维护者必读）