skill-forge-hub 0.5.4 → 1.0.1

package/prompt-pouch/SKILL.md

@@ -2,12 +2,12 @@
 name: prompt-pouch
 description: >
   锦囊（prompt-pouch）提示词管理 Skill：生成并维护一个本地 HTML 提示词管理页面（锦囊管理台），
-  暖棕金/深蓝科技/Darcula 深灰蓝/薄荷绿四套主题（右下角换肤坞随时切换，THEME 配置可设默认），功能为分组侧栏（带计数徽章）+ 搜索（关键词高亮）+ 卡片网格 + 四种排序（最新添加默认/最近使用/使用频率/手动，
-  拖拽与 ▲▼ 自动切手动）+ 使用统计 + 收藏星标 + {变量} 插值填充面板 + 一键复制 + 卡片「👁 详情」弹窗
+  暖棕金/深蓝科技/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 加进锦囊、存成提示词、收藏这句话」或口述增删改提示词与分组、调整排序、
+  （默认示例五组：写作输出/沟通协作/规划执行/复盘成长/提问艺术，每条带 createdAt；页面另内置同款示例种子 DEFAULT_POUCH，prompts.json 读不到时兜底展示）；②维护——用户说「把这段话/这段对话/这个文件/XX 加进锦囊、存成提示词、收藏这句话」或口述增删改提示词与分组、调整排序、导入导出备份、
   切换收藏，读写 prompts.json（UTF-8、2 空格缩进），用户刷新页面即见；③打开——用户说「打开锦囊」时
   起本地服务并按平台打开浏览器访问管理页面。
   数据通过 HTTP 方式访问（file:// 直开会回退浏览器缓存快照，需提示用户起本地服务）。
@@ -57,20 +57,21 @@ disable-model-invocation: false
    - 后台起本地服务（`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
 4. **结构规则与维护操作** → 读 `resources/data-format.md`（schema、id 规范、createdAt、updatedAt、排序落盘、插值语法、排序模式）
-5. **批量整理入囊**（用户给一堆文字/文件/说「把最近对话框内容整理进锦囊」）：
-   - 读 `<DIR>/<DATA_DIR>/prompts.json` 现状 → 逐条提炼候选提示词（标题/正文/建议归入哪个现有组/标签 1-3 个）
-   - 输出整理方案表给用户：每条建议分组与理由、**插值泛化建议**（识别可泛化的具体词——人名/日期/数字/对象名，建议改为 {变量}，附改写前后对比与复用效果，如「把『Q3 报告』换成 {报告主题}，这条就能复用于任何主题」）；现有组装不下的条目推荐新建分组（中文名 + emoji icon + 一句推荐理由），不擅自落盘
-   - 用户口述调整（换组/改名/删条目/改推荐组名/接受或拒绝插值建议）→ 确认后一次性落盘：id 雪花规则、createdAt 当天、各组 order 续排，写回前重读最新文件合并
-   - 落盘后提醒用户刷新页面
+5. **批量整理入囊**（用户给一堆文字/文件/说「把最近对话框内容整理进锦囊」）——两段确认，一段不跳：
+   - 读 `<DIR>/<DATA_DIR>/prompts.json` 现状
+   - **第一段 · 定条目**：逐条提炼候选提示词（标题/正文），**默认 AI 智能打标**——每条自动配 1-3 个语义标签（无需用户要求，默认就做；用户可改可删）；同时给**插值泛化建议**（识别可泛化的具体词——人名/日期/数字/对象名，建议改为 {变量}，附改写前后对比与复用效果，如「把『Q3 报告』换成 {报告主题}，这条就能复用于任何主题」）。输出条目清单表（序号 | 标题 | AI 建议标签 | 插值建议），等用户确认条目（增/删/改标题正文/改标签/接受或拒绝插值建议），不擅自落盘
+   - **第二段 · 定分组**：基于定稿条目输出分组方案表（每条归入哪个现有组 + 语义匹配理由；现有组装不下的条目推荐新建分组：中文名 + emoji icon + 一句推荐理由），等用户确认分组（换组/改名/改推荐组名）
+   - 两段都确认后一次性落盘：id 雪花规则、createdAt 当天、各组 order 续排，写回前重读最新文件合并；落盘后提醒用户刷新页面
+   - 条目少（≤3 条）时两段可合并一次确认：报完整方案表（条目 + 标签 + 分组 + 插值建议），一次确认
 6. **使用咨询**（用户只问「锦囊怎么用」等用法、未要求生成或修改）→ 读 `resources/usage-guide.md`，将其内容原样输出（首行标题改为「锦囊使用指南」），不读写任何文件
 
 ## ⚙️ 配置与自定义主题
 
 **执行本 skill 前必须先 Read 同目录 `user-config.md`**：目录（DIR/DIR_WIN）、端口（PORT）、初始化数据（INIT_DATA）、确认开关（CONFIRM）、主题（THEME）等默认配置都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留。
 
-**THEME 主题机制**：页面内置四套主题——gold 暖棕金（默认）/ tech 深蓝科技 / mono Darcula 深灰蓝（JetBrains IDE 同款观感）/ mint 薄荷绿。初始化复制 reference.html 后，将 html 根标签 `data-theme` 属性值设为配置 `THEME`（仅此一处修改）；页面右下角「换肤坞」色点可随时切换主题，选择经浏览器 localStorage 持久（key: sf-pouch-theme），刷新后保持；localStorage 优先级高于根标签 data-theme。已初始化的页面改配置 THEME 不追溯——用户手动换过主题即以其选择为准。
+**THEME 主题机制**：页面内置五套主题——gold 暖棕金（默认）/ tech 深蓝科技 / mono IDEA 黑亮（JetBrains New UI Dark 官方色系，编辑区 #1e1f22 + 面板 #2b2d30）/ light IDEA 白亮（IntelliJ Light 官方色系）/ mint 薄荷绿。初始化复制 reference.html 后，将 html 根标签 `data-theme` 属性值设为配置 `THEME`（仅此一处修改）；页面右下角「换肤坞」色点可随时切换主题，选择经浏览器 localStorage 持久（key: sf-pouch-theme），刷新后保持；localStorage 优先级高于根标签 data-theme。已初始化的页面改配置 THEME 不追溯——用户手动换过主题即以其选择为准。
 
-**配置版本机制（升级保护）**：user-config.md 头部 `CONFIG_VERSION` 标识结构版本。升级 skill 后若发现新版本结构（如 v2 新增 THEME 字段）而用户配置是旧版：先备份旧配置为 `user-config.md.bak-时间戳`，将旧值迁移进新结构（保留用户已有 DIR/PORT/INIT_DATA/CONFIRM，缺失字段补默认值），更新 CONFIG_VERSION，最后用一句话告知用户配置已升级、旧文件备份在哪。v4 特例：用户配置 DATA_DIR: cache（v3 旧默认、非用户显式自定义）→ 目录改名 cache→data（先复制 .bak-时间戳）并同步更新配置值；用户显式自定义过其它目录名则尊重其选择不动。 **无法迁移项处理**（值域失效 / 语义漂移 / 数据不兼容）：三绝不——绝不静默（无法迁移项停下问，不猜值）、绝不丢失（旧值永远在备份）、一次说清（升级报告三段式：⚠️ 版本与备份路径 / ✅ 已自动迁移 / 🟡 无法迁移项逐条附原因+影响+建议替代）；随后 AskUserQuestion 三选项（A 用建议值 / B 用户给新值 / C 保持旧配置——不更新 CONFIG_VERSION，每次执行再提醒）；报告必附回滚一句话；数据文件（prompts.json）迁移前先复制 .bak-时间戳，能映射则映射、不能则写兼容层（旧 id 兼容保留即范例）或留备份提示手动整理
+**配置版本机制（升级保护）**：user-config.md 头部 `CONFIG_VERSION` 标识结构版本，本 skill 当前要求版本为 4；配置结构如有变化必须同步更新此版本号与迁移说明。升级 skill 后若发现新版本结构（如 v2 新增 THEME 字段）而用户配置是旧版：先备份旧配置为 `user-config.md.bak-时间戳`，将旧值迁移进新结构（保留用户已有 DIR/PORT/INIT_DATA/CONFIRM，缺失字段补默认值），更新 CONFIG_VERSION，最后用一句话告知用户配置已升级、旧文件备份在哪。v4 特例：用户配置 DATA_DIR: cache（v3 旧默认、非用户显式自定义）→ 目录改名 cache→data（先复制 .bak-时间戳）并同步更新配置值；用户显式自定义过其它目录名则尊重其选择不动。 **无法迁移项处理**（值域失效 / 语义漂移 / 数据不兼容）：三绝不——绝不静默（无法迁移项停下问，不猜值）、绝不丢失（旧值永远在备份）、一次说清（升级报告三段式：⚠️ 版本与备份路径 / ✅ 已自动迁移 / 🟡 无法迁移项逐条附原因+影响+建议替代）；随后 AskUserQuestion 三选项（A 用建议值 / B 用户给新值 / C 保持旧配置——不更新 CONFIG_VERSION，每次执行再提醒）；报告必附回滚一句话；数据文件（prompts.json）迁移前先复制 .bak-时间戳，能映射则映射、不能则写兼容层（旧 id 兼容保留即范例）或留备份提示手动整理
 
 ## 核心约束
 
@@ -85,4 +86,4 @@ disable-model-invocation: false
 - **页面双笔纪律**：页面经目录授权后可直写 prompts.json（增删改分组与提示词、排序落盘）。AI 每次维护必须先重读最新 prompts.json 再修改写回，严禁基于会话早期读入的旧内容覆盖写回（会丢失页面刚写入的改动）；页面未授权目录时的操作会生成「复制指令」交回 AI，按指令内容落盘
 - **插值语法**：内容里的 `{变量名}`（如「{功能名}」）会被页面自动识别为填充面板变量，写内容时按需保留花括号占位
 - **插值泛化纪律**：新增/整理提示词时主动识别可泛化的具体词（人名/日期/数字/对象名），向用户建议改为 {变量}（附改写示例与复用效果），用户确认后才改；不擅自泛化，用户拒绝则原样保留
-- **主题令牌纪律**：reference.html 组件样式一律引用 CSS 变量（--gold/--gold2/--gold-dim/--border/--tag-bg/--star/--glow/--bar-hi/--bar-lo 等），禁止在组件侧硬编码暖棕金色值（#e8b04b、rgba(232,176,75,…)、rgba(23,17,12,…)）；新增样式需复用现有令牌或先在四主题块中各补一致定义；改主题只改对应 [data-theme] 块，不动组件
+- **主题令牌纪律**：reference.html 组件样式一律引用 CSS 变量（--gold/--gold2/--gold-dim/--border/--tag-bg/--star/--glow/--scan/--scan-dim/--bar-hi/--bar-lo 等），禁止在组件侧硬编码暖棕金色值（#e8b04b、rgba(232,176,75,…)、rgba(23,17,12,…)）；新增样式需复用现有令牌或先在五主题块中各补一致定义；改主题只改对应 [data-theme] 块，不动组件

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

@@ -31,7 +31,7 @@
 - `prompts[].group`：引用组的数字 id，写回前逐一校验
 - `prompts[].order`：组内排序权重，从 1 递增且尽量连续；重排时按新顺序整体重写（数字 id 天然按时间有序，可作辅助参考）
 - `prompts[].favorite`：收藏星标（页面点星为本地态，指令「收藏/取消收藏 XX」由 AI 落盘）
-- `prompts[].tags`：1-3 个短标签，用于搜索与归类
+- `prompts[].tags`：1-3 个短标签，用于搜索、过滤与归类（AI 批量整理时默认智能打标，用户可在页面悬停 ✕ 删 / ＋ 加 / 编辑表单增删改）
 - `prompts[].createdAt`：添加时间（YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss，**新增提示词必写到时分秒**）；旧数据可无此字段或仅日期（页面按 order 兜底排序，数字 id 时间序可辅助）
 - `prompts[].updatedAt`：最近一次内容修改时间（格式同 createdAt，写到时分秒）；新增不写、首次修改才写，仅重排 order 不更新
 
@@ -49,6 +49,7 @@
 - **修改**：定位 id 或标题，只改用户指定的字段；「修改锦囊里『日报速写』的内容」→ 整段替换 content；改标题/分组/内容/标签时把 updatedAt 更新为当前时间（格式同 createdAt，写到时分秒）
 - **删除**：删 prompts 条目；删分组前须先处理组内条目（移组或一并删除，需与用户确认）
 - **排序与分组**：用户粘贴「复制变更指令」文本 → 先按「分组调整」节改各条 `group`（把「X」从「A」移到「B」），再按「各组顺序」节每组列表顺序重写 `order`；指令含「未保存」提示时，说明用户拖拽后未复制最新指令，以指令内容为准
+- **分组顺序**：用户页面拖拽分组条 → 重排 groups 数组顺序（分组展示顺序 = 数组顺序，无独立 order 字段）；未授权目录时页面复制「请把锦囊分组顺序调整为：A、B、C」指令，AI 按新顺序整体重写 groups 数组即可
 - **新建分组**：id 按雪花规则生成数字主键，name 中文，icon 一个 emoji
 - **写回格式**：UTF-8、2 空格缩进、末尾换行；不压缩不重排无关字段
 - **双写者纪律**：页面（授权目录时）与 AI 都会写本文件——任何一方写回前必须重读最新内容再合并修改，严禁基于旧内容整体覆盖