skill-forge-hub 1.3.1 → 1.3.3

package/CHANGELOG.en.md

@@ -4,6 +4,24 @@
 
 Version history of the SkillForge npm package `skill-forge-hub` (command name `skill-forge`).
 
+## 1.3.3 (2026-11-13)
+
+**prompt-pouch "retrieval" task type + tuning/feedback loop (@12)**
+
+- New "retrieval" task (check-before-use): "what in the pouch fits XX?" → AI reads prompts.json, semantically matches and lists candidates (index/title/group/match reason), applies the chosen one directly; for daily tasks (daily/weekly reports, retrospectives, emails) AI silently scans the pouch first — reuse when a template matches, otherwise finish normally and ask once whether to stash the result; SKILL.md task types 3 → 4, usage-guide gains item 11 "retrieval" plus an "active retrieval" scenario
+- Tuning & feedback loop: "this one doesn't work, fix it" → read original + feedback → before/after diff → confirm and write back (updatedAt timeline visible); "this one is good" → recorded into the optional notes field (AI-maintained only); detail modal gains a read-only "📝 使用心得" (usage notes) section (hidden when absent, legacy data compatible); data-format.md schema example / field spec / maintenance rules updated in three places
+- user-config.md aligned to the SkillForge standard shape: yaml fence + "⚙️ 默认配置" section + upgrade-protection intro + temporary verbal override block (keys unchanged, CONFIG_VERSION still 4)
+- Template stamp prompt-pouch@11 → @12 (detail modal gains the usage-notes section, page structure change)
+
+## 1.3.2 (2026-11-13)
+
+**prompt-pouch in-page usage scenarios + full functional check**
+
+- Functional check all green: 18/18 cards, zero JS errors; search/detail/delete-confirm/add/sort/theme-switch interactions verified; deleting a non-empty group triggers toast guard (confirm only for empty groups, both by design); the template page's three-tier fallback 404 probes are by design
+- In-page "usage tips" sidebar card and help panel (4 → 6 blocks) now cover conversation-saving scenarios: "save the last few rounds of chat into the pouch" with two-step confirmation, delete-first-confirm with prompts.json.bak-timestamp backup before write, and "rollback/restore pouch data" archive selection
+- usage-guide gains a "Typical scenarios" section: conversation capture / starting from scratch / delete & rollback / migration to a new machine
+- Template stamp prompt-pouch@10 → @11 (help panel structure change)
+
 ## 1.3.1 (2026-11-12)
 
 **Daily/weekly template sample data generalized + CSDN article visual refresh**

package/CHANGELOG.md

@@ -4,6 +4,24 @@
 
 SkillForge（技能锻造坊）npm 包 `skill-forge-hub`（命令名 `skill-forge`）版本变更记录。
 
+## 1.3.3（2026-11-13）
+
+**prompt-pouch「取用」任务类型 + 调优/效果反馈闭环（@12）**
+
+- 新增「取用」任务（先查后用）：说「锦囊里有什么适合 XX 的」→ AI 读 prompts.json 语义匹配列候选（序号/标题/分组/匹配理由），选定直接套用执行；日常任务（写日报/周报/复盘/邮件等）动手前先静默快扫锦囊——有模板告知并套用、无则完成后轻问是否入囊；SKILL.md 任务类型三类→四类，usage-guide 新增第 11 条取用与「主动取用」场景
+- 调优与效果反馈闭环：说「这条不好用，帮我改」→ 读原文 + 反馈 → 改版对照（旧→新）→ 确认写回（updatedAt 时间线可查）；说「这条好用」→ 记入可选 notes 字段（AI 代笔专属），页面详情弹窗新增「📝 使用心得」区只读展示（无则不显示，旧数据兼容），data-format.md schema 示例/字段约定/维护规则三处同步
+- user-config.md 对齐 SkillForge 规范形态：yaml 围栏 + 「⚙️ 默认配置」小节 + 顶部升级保护说明 + 底部临时口头要求引用块（键值不变，CONFIG_VERSION 仍 4）
+- 版本戳 prompt-pouch@11 → @12（详情弹窗新增使用心得区，页面结构变化）
+
+## 1.3.2（2026-11-13）
+
+**prompt-pouch 页内使用场景三处布道 + 功能体检**
+
+- 功能体检全绿：18/18 卡片数、零 JS 报错，搜索/详情/删除确认/新增/排序/换肤全交互验证通过；删除非空分组走 toast 保护提示（组空才弹确认框，均设计内）；模板页三级兜底探测 404 为设计内行为
+- 页内「锦囊用法」侧栏说明卡与「使用帮助」面板（4 段扩 6 段）补充对话保存场景：对 AI 说「把上一轮/最近几轮对话存进锦囊」两段确认入囊、删除先确认且落盘前留 prompts.json.bak-时间戳、「回退/恢复锦囊数据」选档回滚
+- usage-guide 新增「典型使用场景」章节：对话沉淀 / 从零开始 / 对话删除与回退 / 换电脑迁移
+- 版本戳 prompt-pouch@10 → @11（帮助面板结构变化）
+
 ## 1.3.1（2026-11-12）
 
 **日报/周报模板示例数据通用化 + CSDN 推广文图文改版**

package/docs/articles/ai-prompt-management-skill-pouch.md

@@ -5,7 +5,7 @@
 
 好提示词是资产。但大多数人的提示词过着流浪生活——散落在聊天记录、备忘录、收藏夹、转发消息里。当时灵光一闪写下的那段精妙引导，三个月后想再用，翻遍历史找不到，只能凭记忆重写，还得从头调教。
 
-「锦囊」（prompt-pouch）就是为这件事造的 AI 技能：一个本地 HTML 管理台，把提示词按分组收纳、全文搜索、一键复制，还能给提示词留 {变量} 插值位——同一段模板，填入不同对象就能反复复用。下面是一套十分钟上手流程。
+「锦囊」（prompt-pouch）就是为这件事造的 AI 技能：一个本地 HTML 管理台，把提示词按分组收纳、全文搜索、一键复制，还能给提示词留 {变量} 插值位——同一段模板，填入不同对象就能反复复用。页面与数据严格分离，双笔协作：页面可直写，AI 可代笔，你只管说，刷新即见。下面是一套十分钟上手流程。
 
 ## 第一步：安装（一分钟）
 
@@ -18,15 +18,25 @@ skill-forge init        # 交互勾选 prompt-pouch
 
 ## 第二步：初始化（一句话）
 
-对 AI 说「建一个锦囊」。它会在你指定的目录生成两个东西：管理页面 `prompt-pouch.html` 和真相源 `data/prompts.json`。页面负责展示，数据负责记忆，两者严格分离——这是后面一切安全的根。
+对 AI 说「建一个锦囊」。它会在你指定的目录生成两个东西：管理页面 `prompt-pouch.html` 和真相源 `data/prompts.json`。页面负责展示，数据负责记忆，两者严格分离——这是后面一切安全的根。首次初始化自带一份各职业通用的示例五组（写作输出/沟通协作/规划执行/复盘成长/提问艺术，每条都带 {变量} 插值），打开就有满屏样例可看；不需要样例也可以要「空锦囊」。页面内置五套主题（暖棕金/深蓝科技/IDEA 黑亮/IDEA 白亮/薄荷绿），右下角换肤坞随点随换。
+
+还没建？也不用先建——直接对 AI 说「把 XX 存进锦囊」，它会从创建开始一路引导到入囊，全程不用你操心目录。
 
 ## 第三步：开始收藏（口述即可）
 
-不用打开编辑器。对 AI 说「把这段话加进锦囊」——比如把某次对话里验证过的那段「角色设定 + 输出格式」整段收进去，它替你写进 JSON；刷新页面即见。当然也可以直接在页面表单里手动录入。
+**单条入囊**：对 AI 说「把这段话加进锦囊」——比如把某次对话里验证过的那段「角色设定 + 输出格式」整段收进去。不说分组也行：AI 会按语义推荐现有分组（内容讲周报就建议归入「写作输出」并说明理由），现有分组装不下就推荐新建一个。确认后它替你写进 JSON，刷新页面即见。
+
+**对话沉淀**：说「把上一轮对话存进锦囊」「把最近几轮对话整理进锦囊」——AI 先把对话提炼成条目清单（标题/正文），再给你看两样东西：智能打标（每条自动配 1-3 个语义标签，可改可删）与插值泛化建议（如「把『Q3 报告』换成 {报告主题}，这条就能复用于任何主题」）。条目确认后，再推荐分组方案，两段确认一次落盘；条目少（≤3 条）时两段合一，一次确认。
+
+也可以直接在页面表单里手动录入：点「＋ 新增提示词」填表保存，授权目录后即写即存。
 
 ## 第四步：用起来
 
-管理台该有的都有：分组侧栏（带计数徽章）、关键词搜索（命中高亮）、收藏星标、标签点击过滤、四种排序（手动拖拽可用）、JSON 导入导出备份、使用频率统计。挑提示词时看频率，就知道哪些真正好用。
+管理台该有的都有：分组侧栏（带计数徽章）、关键词搜索（命中高亮）、收藏星标、标签点击过滤、四种排序（最新添加/最近使用/使用频率/手动，拖拽可用）、{变量} 插值填充面板（点复制自动弹面板填值）、卡片「👁 详情」弹窗（全文滚动 + 创建/修改时间线）、JSON 导入导出、使用频率统计。挑提示词时看频率，就知道哪些真正好用。
+
+**删除与回退**：页面删提示词/分组都弹页内统一确认框防误触（分组内还有条目时先移出或删）；对 AI 说「删掉锦囊里 XX」同样先确认。AI 落盘前会留 `prompts.json.bak-时间戳` 备份，删错说「回退/恢复锦囊数据」，列出备份档选档恢复（恢复前还会再备份当前版，双保险）。页面侧另有自动备份：数据一有变更 2 秒内备份到 backup/（滚动双备份），页内「↩ 恢复」一键回滚。
+
+**换电脑迁移**：旧机「⤓ 导出」JSON 文件，新机「⤒ 导入」整库恢复（含分组与标签）；复制 data/ 与 backup/ 两个目录过去同样可行。
 
 ## 为什么做成「技能」而不是「应用」
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-forge-hub",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "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 空格缩进），用户刷新页面即见；③打开——用户说「打开锦囊」时 起本地服务并按平台打开浏览器访问管理页面。 数据通过 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
 ---
@@ -28,32 +28,42 @@ disable-model-invocation: false
    - **明确入囊**：用户说「把这段话/这段对话/这个文件 加进锦囊、存成提示词、收藏这句话、整理进锦囊」→ 直接进入维护或批量整理流程
    - **模糊意图**：用户表达可能指向锦囊但不明确（如「保存这个」「记一下这个」）→ 先 AskUserQuestion 确认（选项：放入锦囊提示词 / 只是本次会话临时记录 / 其它），确认后执行，不擅自写文件
    - **明确无关**：普通对话、没有保存意图 → 不触发任何文件操作
+   - **取用意图**：用户说「锦囊里有什么适合 XX 的」「用锦囊里那条模板」或请求写日报/周报/复盘/邮件等日常任务 → 执行步骤 3 取用流程（先查后用）
 1. **初始化**（目标目录无 `prompt-pouch.html` 时）：
    - **已有页面分支**：用户说「创建/生成」但目标目录已有 prompt-pouch.html → AskUserQuestion 三选项：A 打开现有页面（推荐，数据无损）；B 覆盖重建——旧页面先复制 .bak-时间戳，仅重置页面为新版 reference.html（DATA_DIR/BACKUP_DIR 数据目录一概不动，用户数据绝不丢）；C 取消不创建。默认推荐 A
    - **目录确认**：用户未提目录 → 用配置 `DIR`；`CONFIRM: true` 时先 AskUserQuestion 确认（选项：用默认目录 / 换目录）；用户已说「放到 XX 目录」→ 直接用该目录（本次会话有效，不改配置文件）
+   - **存内容触发的初始化**：用户因「把 XX 存进锦囊」而首次创建锦囊（目标目录无页面）→ 初始化前先 AskUserQuestion 询问示例数据（选项：A 生成示例五组（推荐，页面首开有内容可看）；B 空结构——直接进整理流程只存用户本次内容），用户未回应默认 A；选定后初始化继续，随后衔接步骤 2/6 完成本次入囊
    - 复制 `resources/reference.html` → `<DIR>/prompt-pouch.html`（原样复制，不修改任何样式与脚本；仅两处例外：①html 根标签 `data-theme` 属性值设为配置 `THEME`——reference 默认 "gold"，仅当配置非 gold 时替换该属性值；②head 中 `<meta name="pouch-id" content="...">` 的 content 替换为本次用 crypto.randomUUID() 新生成的全局唯一 ID——标准 UUID v4（十六进制 8-4-4-4-12 节，禁止手写变体、禁止沿用 reference 的占位 ID REF-POUCH-0000、禁止两份锦囊共用同一 ID；复制文件副本=同一身份共享数据）；落盘写文件前顺扫 <DIR> 下已有 html 的 pouch-id meta 查重，撞号重掷至不重复）
    - 创建 `<DIR>/<DATA_DIR>/` 与 `<DIR>/<BACKUP_DIR>/` 子目录（配置为空串则跳过、平铺根目录）；生成 `<DIR>/<DATA_DIR>/prompts.json`：`INIT_DATA: example` 时写入「各职业通用」示例五组（写作输出/沟通协作/规划执行/复盘成长/提问艺术，每组 3 条，标题与正文按下方「## 默认示例数据」清单写，**每条必带 createdAt 当前时间（YYYY-MM-DD HH:mm:ss，写到时分秒）**）；`empty` 时写空结构（version + 空 groups/prompts）
    - 收尾提示启动方式：`cd <DIR> && python3 -m http.server <PORT>`（Windows 无 python3 时 `py -m http.server`），浏览器访问 `http://localhost:<PORT>/prompt-pouch.html`（HTTP 自动读 prompts.json；file:// 直开浏览器会拦截文件读取——已授权目录则刷新自动直读 data/prompts.json，权限需重新确认时点徽标「🔓 恢复数据」一键续权，读不到则回退本地快照/镜像，推荐 HTTP 打开）
 2. **维护**（页面已存在时）：读 `<DIR>/<DATA_DIR>/prompts.json` → 按用户意图修改 → 写回（UTF-8、2 空格缩进、保留 version 字段）→ 提醒用户刷新页面
    - **落盘确认**：写回前展示将要落盘的内容（新增/修改的标题、分组、正文摘要，一句话说清改了什么），等用户确认后落盘；用户明确说「直接存/不用确认」则跳过（本次会话有效）；写回前重读最新文件合并；落盘完成后对话报告产物位置：页面文件 `<DIR>/prompt-pouch.html`、数据文件 `<DIR>/<DATA_DIR>/prompts.json`、滚动备份目录 `<DIR>/<BACKUP_DIR>/`
+   - **写回前备份**：每次修改写回前先复制 `<DIR>/<DATA_DIR>/prompts.json` 为同级 `prompts.json.bak-时间戳`（破坏性操作——删除提示词/删除或改动分组/批量整理——必做；简单新增可免但建议保留）；页面自动滚动备份只在页面运行时生效，AI 直写不触发，回退保障必须由 AI 自己留档。用户说「回退/恢复锦囊数据」时：列 `<DIR>/<DATA_DIR>/` 下 `.bak-时间戳` 清单（含时间与条目数）让用户选 → 恢复前再备份当前版（双保险）→ 恢复后机器校验 schema → 提醒用户刷新
    - **分类交互**：用户说「添加 XX」但未说分组 → 先按现有分组语义智能匹配（如内容讲周报 → 建议「写作输出 ✍️」并说明理由），匹配到则默认归入、用户可改口换组；匹配不到 → AskUserQuestion 列出全部现有分组（加「新建分组」选项）让用户选；用户指定的分组不存在 → 明确告知该分组不存在，并问是否新建（新建则补 groups 条目：id 16 位数字主键（雪花规则见 data-format.md）、name 中文、icon 一个 emoji）
+   - **调优**：用户说「这条不好用，帮我改」→ 读原文 + 用户反馈 → 输出改版对照（旧 → 新）→ 用户确认后写回（updatedAt 更新到时分秒，写回前重读合并 + 先备份）
+   - **效果反馈**：用户说「这条好用 / 这条用着顺手」→ 定位条目，把反馈写进可选 `notes` 字段（无则新建；一段使用心得/效果备注，页面详情弹窗「📝 使用心得」只读展示，页面表单不编辑此字段）；说「这条不好用」但不想改 → 同样记入 notes 留档
 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 条数（证明数据被正确读到；落回内置示例种子即自检失败）→ 收尾停服务
    - 未通过 → 修复后重跑，禁止跳过直接交付
-3. **打开页面**：用户说「打开锦囊 / 打开提示词页面」→
+3. **取用（先查后用）**（用户说「锦囊里有什么适合 XX 的」「用锦囊里那条模板」或请求日常任务时）：
+   - 读 `<DIR>/<DATA_DIR>/prompts.json` → 按标题/正文/标签/分组名语义匹配 → 列候选清单（序号 | 标题 | 分组 | 匹配理由），≤3 条全列、超过则列最相关 3-5 条
+   - 用户选定某条 → 直接按该模板执行任务（含 {变量} 按上下文填充）或输出正文供复制；用户不选 → 不强行套用
+   - 无匹配 → 正常完成任务，完成后轻问一句「这次的写法要不要收进锦囊？下次直接复用」——用户同意则衔接维护/批量整理流程
+   - **日常任务取用纪律**：用户请求写日报/周报/复盘/邮件等常见任务时，先静默快扫锦囊有无匹配模板：有 → 告知「锦囊里有现成的 XX 模板，我来套用」并执行；无 → 不打断、正常完成，完成后一句轻问是否入囊（用户说「不用查锦囊」则本次跳过）
+4. **打开页面**：用户说「打开锦囊 / 打开提示词页面」→
    - 目标目录无页面时先执行步骤 1（初始化）
    - 后台起本地服务（`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）与页面文件完整路径
-4. **结构规则与维护操作** → 读 `resources/data-format.md`（schema、id 规范、createdAt、updatedAt、排序落盘、插值语法、排序模式）
-5. **批量整理入囊**（用户给一堆文字/文件/说「把最近对话框内容整理进锦囊」）——两段确认，一段不跳：
+5. **结构规则与维护操作** → 读 `resources/data-format.md`（schema、id 规范、createdAt、updatedAt、排序落盘、插值语法、排序模式）
+6. **批量整理入囊**（用户给一堆文字/文件/说「把最近对话框内容整理进锦囊」）——两段确认，一段不跳：
    - 读 `<DIR>/<DATA_DIR>/prompts.json` 现状
    - **第一段 · 定条目**：逐条提炼候选提示词（标题/正文），**默认 AI 智能打标**——每条自动配 1-3 个语义标签（无需用户要求，默认就做；用户可改可删）；同时给**插值泛化建议**（识别可泛化的具体词——人名/日期/数字/对象名，建议改为 {变量}，附改写前后对比与复用效果，如「把『Q3 报告』换成 {报告主题}，这条就能复用于任何主题」）。输出条目清单表（序号 | 标题 | AI 建议标签 | 插值建议），等用户确认条目（增/删/改标题正文/改标签/接受或拒绝插值建议），不擅自落盘
    - **第二段 · 定分组**：基于定稿条目输出分组方案表（每条归入哪个现有组 + 语义匹配理由；现有组装不下的条目推荐新建分组：中文名 + emoji icon + 一句推荐理由），等用户确认分组（换组/改名/改推荐组名）
    - 两段都确认后一次性落盘：id 雪花规则、createdAt 当天、各组 order 续排，写回前重读最新文件合并；落盘后提醒用户刷新页面
    - 条目少（≤3 条）时两段可合并一次确认：报完整方案表（条目 + 标签 + 分组 + 插值建议），一次确认
-6. **使用咨询**（用户只问「锦囊怎么用」等用法、未要求生成或修改）→ 读 `resources/usage-guide.md`，将其内容原样输出（首行标题改为「锦囊使用指南」），不读写任何文件
+7. **使用咨询**（用户只问「锦囊怎么用」等用法、未要求生成或修改）→ 读 `resources/usage-guide.md`，将其内容原样输出（首行标题改为「锦囊使用指南」），不读写任何文件
 
 
 ## 🔧 报修处理流程（用户报页面问题时）
@@ -68,7 +78,7 @@ disable-model-invocation: false
 
 ## 产物升级（回炉）
 
-生成/初始化页面时头部写版本戳 `<meta name="sf-template" content="prompt-pouch@10">`（模板升级时递增 @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@12">`（模板升级时递增 @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 份旧版锦囊，说『把我旧锦囊都升级成新样式』即可一键升级」，不让用户背触发语。
 
 ## ⚙️ 配置与自定义主题
 

package/prompt-pouch/resources/data-format.md

@@ -17,6 +17,7 @@
       "tags": ["日报", "工作"],
       "order": 1,
       "favorite": true,
+      "notes": "用着顺手——结构清晰，客户沟通场景反复复用",
       "createdAt": "2026-11-10 14:23:45",
       "updatedAt": "2026-11-10 16:05:12"
     }
@@ -34,6 +35,7 @@
 - `prompts[].tags`：1-3 个短标签，用于搜索、过滤与归类（AI 批量整理时默认智能打标，用户可在页面悬停 ✕ 删 / ＋ 加 / 编辑表单增删改）
 - `prompts[].createdAt`：添加时间（YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss，**新增提示词必写到时分秒**）；旧数据可无此字段或仅日期（页面按 order 兜底排序，数字 id 时间序可辅助）
 - `prompts[].updatedAt`：最近一次内容修改时间（格式同 createdAt，写到时分秒）；新增不写、首次修改才写，仅重排 order 不更新
+- `prompts[].notes`：**可选**，string，AI 代笔专属字段——用户说「这条好用/不好用」或给使用反馈时由 AI 写入（一段使用心得/效果备注）；页面详情弹窗「📝 使用心得」只读展示，页面表单不编辑此字段；旧数据无此字段正常兼容
 
 ### id 生成规则（雪花变体）
 
@@ -48,6 +50,7 @@
 - **新增提示词**：用户说「把 XX 加到锦囊的写作输出分组」→ 补一条 prompts 记录（id 按雪花规则生成数字主键、group/title/content/tags/order/favorite/createdAt 齐全，createdAt 写到时分秒）；未指定分组时，优先选语义最匹配的现有分组，实在没有才新建分组并先询问
 - **修改**：定位 id 或标题，只改用户指定的字段；「修改锦囊里『日报速写』的内容」→ 整段替换 content；改标题/分组/内容/标签时把 updatedAt 更新为当前时间（格式同 createdAt，写到时分秒）
 - **删除**：删 prompts 条目；删分组前须先处理组内条目（移组或一并删除，需与用户确认）
+- **效果反馈（notes）**：用户说「这条好用/用着顺手」→ 定位条目，把反馈写进可选 `notes` 字段（无则新建；简洁一段话，追加或整体替换皆可，先重读最新再合并写回）；说「这条不好用」但不想改 → 同样记入 notes 留档
 - **排序与分组**：用户粘贴「复制变更指令」文本 → 先按「分组调整」节改各条 `group`（把「X」从「A」移到「B」），再按「各组顺序」节每组列表顺序重写 `order`；指令含「未保存」提示时，说明用户拖拽后未复制最新指令，以指令内容为准
 - **分组顺序**：用户页面拖拽分组条 → 重排 groups 数组顺序（分组展示顺序 = 数组顺序，无独立 order 字段）；未授权目录时页面复制「请把锦囊分组顺序调整为：A、B、C」指令，AI 按新顺序整体重写 groups 数组即可
 - **新建分组**：id 按雪花规则生成数字主键，name 中文，icon 一个 emoji

package/prompt-pouch/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="prompt-pouch@10">
+<meta name="sf-template" content="prompt-pouch@12">
 <meta name="pouch-id" content="REF-POUCH-0000">
 <title>锦囊 Prompt Pouch — 提示词管理台</title>
 <style>
@@ -625,6 +625,13 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
   font-size:11px; color:var(--muted); margin-bottom:12px;
 }
 .detail-vars b{ color:var(--gold); }
+.detail-notes{
+  display:block; margin-bottom:10px; padding:10px 14px;
+  background:rgba(0,0,0,.14); border:1px dashed var(--border); border-radius:10px;
+  font-size:12px; line-height:1.8; color:var(--muted);
+}
+.detail-notes b{ color:var(--gold); }
+.detail-notes .note-body{ margin-top:2px; color:var(--text); white-space:pre-wrap; word-break:break-word; }
 .detail-times{
   display:flex; flex-wrap:wrap; gap:4px 16px;
   font-size:11px; color:var(--muted); margin-bottom:10px;
@@ -810,6 +817,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
     </div>
     <div class="detail-times" id="detailTimes" style="display:none"></div>
     <div class="detail-content" id="detailContent"></div>
+    <div class="detail-notes" id="detailNotes" style="display:none"></div>
     <div class="detail-vars" id="detailVars" style="display:none"></div>
     <div class="fp-ops">
       <button class="btn" id="detailClose">关闭</button>
@@ -852,15 +860,23 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
         <div class="hp-d">页面点 <b>「＋ 新增提示词」/「👁 详情」/「✎」/「🗑」</b>（授权目录即写即存），或对 AI 说 <b>「把 XX 加到锦囊的写作输出分组」</b>，AI 写入 data/prompts.json，刷新即见。</div>
       </div>
       <div class="hp-item">
-        <div class="hp-t">② 排序与移动</div>
+        <div class="hp-t">② 对话整理入囊</div>
+        <div class="hp-d">对 AI 说 <b>「把上一轮对话存进锦囊」「把最近几轮对话整理进锦囊」</b>——AI 提炼条目并智能打标、给 {变量} 泛化建议，确认条目后再推荐分组（装不下的建议新建），两段确认一次性入囊；还没锦囊时会先引导创建。</div>
+      </div>
+      <div class="hp-item">
+        <div class="hp-t">③ 排序与移动</div>
         <div class="hp-d">默认最新添加在前，可切「最近使用 / 使用频率 / 手动顺序」；拖动卡片或点 ▲▼ 自动切回手动、点 ⇄ 移到其它分组，点 <b>📋 复制变更指令</b> 交给 AI 落盘。</div>
       </div>
       <div class="hp-item">
-        <div class="hp-t">③ 打开方式</div>
+        <div class="hp-t">④ 删除与回退</div>
+        <div class="hp-d">页面点 🗑 删除弹统一确认框防误触（分组内有条目需先移出或删）；对 AI 说删同样先确认——AI 落盘前留 <b>prompts.json.bak-时间戳</b> 备份，说 <b>「回退/恢复锦囊数据」</b> 选档回滚。</div>
+      </div>
+      <div class="hp-item">
+        <div class="hp-t">⑤ 打开方式</div>
         <div class="hp-d">HTTP 访问读 data/prompts.json；file:// 直开则回退到本地缓存快照。</div>
       </div>
       <div class="hp-item">
-        <div class="hp-t">④ 数据安全</div>
+        <div class="hp-t">⑥ 数据安全</div>
         <div class="hp-d">收藏与排序存浏览器本地（IndexedDB）刷新不丢；每次变更 2 秒内自动备份到 backup/pouch-backup.json（滚动双备份），未授权时降级本地快照（保留 5 份）；<b>「📂 换目录」</b> 可随时重配，↩ 一键恢复。</div>
       </div>
     </div>
@@ -1033,7 +1049,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
       html += '<div class="nav-item' + (state.curGroup===g.id?' on':'') + '" data-g="' + g.id + '" draggable="true" title="拖拽调整分组顺序"><span class="icon">' + g.icon + '</span><span class="g-name">' + escapeHtml(g.name) + '</span><span class="cnt">' + n + '</span><span class="g-ops"><button class="g-edit" title="编辑分组">✎</button><button class="g-del" title="删除分组">🗑</button></span></div>';
     });
     html += '</div>';
-    html += '<div class="side-tip"><b>锦囊用法</b><br>· 页面直接增删改：＋ 新建分组 / ＋ 新增提示词 / ✎ 编辑 / 🗑 删除（授权目录即写即存）<br>· 也可对 AI 说「把 XX 加到写作输出分组」<br>· 顶栏切换排序；⇄ 移组、拖卡片排序自动保存；拖分组条调整分组顺序<br>· 点卡片标签按标签筛选（再点取消）；标签悬停 ✕ 删 / ＋ 加；⤓ 导出 / ⤒ 导入 JSON 备份<br>· ⭐ 收藏常用 · 复制次数在卡片右上角</div>';
+    html += '<div class="side-tip"><b>锦囊用法</b><br>· 页面直接增删改：＋ 新建分组 / ＋ 新增提示词 / ✎ 编辑 / 🗑 删除（授权目录即写即存）<br>· 对 AI 说「把刚才这轮对话存进锦囊」——提炼条目、推荐分组，确认后入囊；也可说「把 XX 加到写作输出分组」<br>· 顶栏切换排序；⇄ 移组、拖卡片排序自动保存；拖分组条调整分组顺序<br>· 点卡片标签按标签筛选（再点取消）；标签悬停 ✕ 删 / ＋ 加；⤓ 导出 / ⤒ 导入 JSON 备份<br>· 删错对 AI 说「回退/恢复锦囊数据」选档回滚<br>· ⭐ 收藏常用 · 复制次数在卡片右上角</div>';
     sideNav.innerHTML = html;
     sideNav.querySelectorAll('.nav-item').forEach(function(el){
       el.addEventListener('click', function(){
@@ -1691,6 +1707,11 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
     if (times.length){ tEl.style.display = 'flex'; tEl.innerHTML = times.join(''); }
     else { tEl.style.display = 'none'; }
     document.getElementById('detailContent').innerHTML = hlHtml(p.content, state.query);
+    var nEl = document.getElementById('detailNotes');
+    if (p.notes && String(p.notes).trim()){
+      nEl.style.display = 'block';
+      nEl.innerHTML = '<b>📝 使用心得</b><div class="note-body">' + hlHtml(p.notes, state.query) + '</div>';
+    } else { nEl.style.display = 'none'; }
     var vars = extractVars(p.content);
     var vEl = document.getElementById('detailVars');
     if (vars.length){

package/prompt-pouch/resources/usage-guide.md

@@ -14,14 +14,25 @@
 8. **标签全交互**：点卡片标签立即按标签筛选（顶栏出现「🏷 标签」胶囊，点 ✕ 或再点同标签取消，切分组自动清除，与搜索叠加）；标签悬停出「✕」点它直接删除该标签；标签不满 3 个时悬停出「＋」快速加标签（多个用逗号分隔）——已授权目录即写即存，未授权时操作指令复制给 AI 落盘
 9. **分组排序**：左侧分组条可直接拖拽调整顺序（已授权目录即写即存，未授权时指令自动复制给 AI 落盘）
 10. **导入 / 导出**：顶栏「⤓ 导出」把当前全部数据下载为 JSON 备份文件（文件名带时间戳）；「⤒ 导入」选择 JSON 文件整库覆盖现有数据（导入前自动备份，可从「↩ 恢复」回滚；未授权目录时导出仍可用、导入需先授权）
+11. **取用（先查后用）**：对 AI 说「锦囊里有什么适合写产品周报的？」——AI 读数据文件按标题/正文/标签/分组语义匹配，列候选清单（序号 | 标题 | 分组 | 匹配理由），选定某条即直接按模板执行（含 {变量} 按上下文填充）或输出正文供复制；日常任务（写日报/周报/复盘/邮件等）AI 会先静默扫一眼锦囊——有现成模板就告知「锦囊里有现成的 XX 模板，我来套用」，没有就正常完成、完成后轻问一句「这次的写法要不要收进锦囊？下次直接复用」；说「不用查锦囊」可跳过
+
+## 典型使用场景
+
+- **对话沉淀**：对 AI 说「把上一轮对话存进锦囊」「把最近几轮对话整理进锦囊」「把最近一小时聊的内容存进锦囊」——AI 先把对话提炼成条目清单（标题/正文/智能标签/插值泛化建议），你确认条目后再按现有分组推荐归类（装不下的推荐新建分组），确认后一次性入囊
+- **从零开始**：还没创建锦囊时直接说「把 XX 存进锦囊」——AI 会先确认目录并引导创建页面（可选示例数据），随后无缝衔接入囊流程
+- **对话删除与回退**：对 AI 说「删掉锦囊里 XX 分组 / XX 这条」——先确认、落盘前自动留 `prompts.json.bak-时间戳` 备份；删错说「回退/恢复锦囊数据」，列出备份档供选档恢复（恢复前再备份当前版，双保险）
+- **换电脑迁移**：旧机「⤓ 导出」JSON 文件 → 新机「⤒ 导入」整库恢复（含分组与标签）；收藏、排序等页面本地态存浏览器本地（随页面 pouch-id 身份），不随 JSON 迁移
+- **主动取用**：说「锦囊里有什么适合 XX 的？」「用锦囊里那条模板」——AI 先查后用，命中即复用、未命中完成后再问是否沉淀入囊；写日报/周报前让 AI 先翻锦囊，往往有现成模板可套
+- **调优与效果反馈**：说「这条不好用，帮我改」——AI 读原文 + 你的反馈 → 给改版对照（旧 → 新）→ 确认后写回（更新时间线可见）；用完说「这条好用」→ AI 在数据里记一行可选 notes（页面详情弹窗「📝 使用心得」只读展示），给下次取用提供参考
 
 ## 特色功能
 
 - **搜索高亮**：搜索框输入关键词，命中卡片的标题/正文/标签中匹配词以主题色徽标高亮（五主题自适应）；命中落在正文三行折叠区之外时，卡片顶部提示「正文命中，详见详情」，点开详情弹窗全文同样高亮
 - **{变量} 插值**：内容含花括号占位（如「{功能名}」）的提示词，点复制会自动弹出填充面板，填入变量后实时预览再复制
-- **自动备份（默认开启）**：数据一有变更 2 秒内自动备份——首次变更会请求授权写入 prompt-pouch.html 所在目录（弹窗选同目录即可，选一次后浏览器记住），写 backup/pouch-backup.json 并滚动保留上一版 .prev.json；未授权或浏览器不支持时自动降级为本地快照（浏览器内保留最近 5 份），页内「↩ 恢复」均可一键回滚；顶栏「📂 换目录」可随时重新配置备份目录
+- **自动备份（默认开启）**：数据一有变更 2 秒内自动备份——首次变更会请求授权写入 prompt-pouch.html 所在目录（弹窗选同目录即可，选一次后浏览器记住），写 backup/pouch-backup.json 并滚动保留上一版 .prev.json；未授权或浏览器不支持时自动降级为本地快照（浏览器内保留最近 5 份），页内「↩ 恢复」均可一键回滚；顶栏「📂 换目录」可随时重新配置备份目录；AI 代笔修改（对话中说增删改）落盘前也会在 data/ 目录留 `prompts.json.bak-时间戳`，说「回退/恢复锦囊数据」即可选档回滚
 - **统一确认弹框**：删除提示词/分组、覆盖导入、恢复备份、授权与换备份目录等需要确认的操作，都用页内统一样式的确认弹框（不再弹浏览器原生对话框）；删除/覆盖/恢复等危险操作为红调按钮，Esc 或点遮罩均可取消
 - **详情弹窗**：点卡片「👁 详情」弹出全文查看（超长内容限高 52vh 内滚动），带复制与修改入口，附时间线（创建 / 上次修改 / 最近使用）；含 {变量} 的模板会在弹窗里标出变量清单，复制时自动进入填充面板
+- **📝 使用心得**：AI 代笔维护的可选 notes 字段——用完说「这条好用」即可记录一行心得，详情弹窗「📝 使用心得」区只读展示（无心得不显示）；页面表单不编辑此字段，由对话维护，旧数据无此字段完全兼容
 - **页面直写（双笔）**：页面增删改直接写入 data/prompts.json（与自动备份共用同一目录授权）；未授权时自动降级——生成操作指令复制到剪贴板，粘贴给 AI 落盘
 - **侧栏局部滚动**：分组较多时，左侧「收藏 + 分组列表」区域独立滚动（窄滚动条，滚动区最大高度 = 屏幕高度减去顶栏、「全部」行与底部说明卡），「＋ 新建分组」在「全部」行右侧不随滚动、「全部」固定不滚；底部「锦囊用法」说明卡完整展示不裁剪，侧栏随页面整体滚动即可读完；窄屏下自动恢复平铺排列
 - **批量整理入囊**：把一堆文字/文件交给 AI，或说「把最近对话框内容整理进锦囊」——两段确认：先定条目（AI 默认智能打标——每条自动配 1-3 个语义标签，可改可删；含具体词的可泛化为 {变量} 插值，附改写示例）→ 再定分组（归组理由 + 装不下的推荐新分组名），都确认后一次性写入；条目少（≤3 条）两段合一

package/prompt-pouch/user-config.md

@@ -1,22 +1,25 @@
-CONFIG_VERSION: 4
+# 用户配置（升级技能时本文件不会被覆盖）
 
-# 页面与数据目录（prompt-pouch.html 与 prompts.json 的落盘处）
-DIR: ~/prompt-pouch
-DIR_WIN: %USERPROFILE%\prompt-pouch
+> 你的个人配置全放在这里。skill-forge 升级技能时官方只更新 SKILL.md 与 resources/，
+> 本文件始终保留你的版本——锦囊落盘目录、预览端口、初始化数据、主题放心改。
+> 官方升级若带来新配置点，会另存 `user-config.upstream.md` 对照文件到同目录，
+> 你按需查看并手动合并新配置点到本文件。
 
-# 本地预览端口（HTTP 方式访问 data/prompts.json）
-PORT: 8933
+## ⚙️ 默认配置（用户可手动修改；临时口头要求永远优先）
 
-# 数据与备份子目录（相对 DIR；空串 = 平铺在 DIR 根下，旧行为）。v4 起 DATA_DIR 默认 data（语义正名：目录放的是全量数据不是缓存；v3 及以前默认 cache）
-DATA_DIR: data
-BACKUP_DIR: backup
+```yaml
+CONFIG_VERSION: 4              # 配置结构版本：skill 升级时若配置结构变化会递增；AI 每次执行前对比 SKILL.md「配置版本机制」节声明的当前版本，不一致时按 SKILL.md 的迁移规则处理（先备份本文件为带时间戳 .bak，再迁移，最后对话告知用户）
+DIR: ~/prompt-pouch            # 落盘根目录（prompt-pouch.html 与 prompts.json 的落盘处，目录不存在时初始化自动创建）
+DIR_WIN: %USERPROFILE%\prompt-pouch   # Windows 落盘根目录
+PORT: 8933                     # 本地预览端口（HTTP 方式访问 data/prompts.json；端口被占时自动换 PORT+1 再试）
+DATA_DIR: data                 # 数据子目录（相对 DIR；空串 = 平铺在 DIR 根下，旧行为）。v4 起默认 data（语义正名：目录放的是全量数据不是缓存；v3 及以前默认 cache）
+BACKUP_DIR: backup             # 备份子目录（相对 DIR；页面自动备份滚动双档，AI 代笔落盘前留 prompts.json.bak-时间戳）
+INIT_DATA: example             # 首次初始化数据：example = 示例五组（写作输出/沟通协作/规划执行/复盘成长/提问艺术，各职业通用）；empty = 空结构
+THEME: gold                    # 页面主题（初始化时写入页面根标签 data-theme；页面右下角换肤坞可随时切换）——gold 暖棕金（默认）/ tech 深蓝科技 / mono IDEA 黑亮 / light IDEA 白亮 / mint 薄荷绿
+CONFIRM: false                 # 初始化/落盘前是否先确认目标目录
+```
 
-# 首次初始化数据：example = 示例五组（写作输出/沟通协作/规划执行/复盘成长/提问艺术，各职业通用）；empty = 空结构
-INIT_DATA: example
+> 临时口头要求（仅对当次生效，不修改上方配置）：说「把锦囊建在 XX 目录」→ 当次 DIR 改用该目录（仅初始化时）；说「先确认目录」→ 当次 CONFIRM=true、说「不用确认」→ 当次 CONFIRM=false；说「锦囊要示例数据」→ 当次 INIT_DATA=example、说「空锦囊就行」→ 当次 INIT_DATA=empty；说「不用查锦囊」→ 当次跳过取用纪律（日常任务不先翻锦囊）。
 
-# 页面主题（初始化时写入页面根标签 data-theme；页面右下角换肤坞可随时切换）
-# 可选：gold 暖棕金（默认）/ tech 深蓝科技 / mono IDEA 黑亮 / light IDEA 白亮 / mint 薄荷绿
-THEME: gold
-
-# 初始化/落盘前是否先确认目标目录
-CONFIRM: false
+---
+> 更多用法见 SKILL.md 与 resources/ 分册。