skill-forge-hub 1.1.0 → 1.3.0

package/data-prepper/SKILL.md

@@ -20,13 +20,13 @@ disable-model-invocation: false
 
 ## ⚙️ 配置与自定义
 
-**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（OUT_FORMAT/CLEAN_PRESET/DIR/REPORT/ID_FIELDS）都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（OUT_FORMAT/CLEAN_PRESET/DIR/REPORT/ID_FIELDS）都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.upstream.md` 对照文件，可按需手动合并新配置点。
 
 ## 配置版本机制（升级保护）
 
 本 skill 当前配置版本为 `1`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明不一致：
 
-1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
+1. 先将旧 user-config.md 备份为 `user-config.bak-<时间戳>.md`（同目录，绝不删除旧值）
 2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
 3. 更新 CONFIG_VERSION 为当前版本
 4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」

package/data-prepper/resources/skillforge-guide.html

@@ -361,6 +361,7 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
       <tr><td>查全部命令</td><td><span class="cmd-in">skill-forge --help</span></td></tr>
       <tr><td>问单个技能用法</td><td>直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出</td></tr>
       <tr><td>问 SkillForge 本身</td><td>问「skillforge 怎么用」，AI 朗读本指引并打开排版页</td></tr>
+      <tr><td>查技能双语简介 / 实操文章</td><td><span class="cmd-in">SKILLS_CATALOG.md</span>（21 技能逐条中英简介）/ <span class="cmd-in">docs/articles/</span>（实操文章）/ <span class="cmd-in">docs/directory-submission.md</span>（目录收录素材）</td></tr>
     </table>
     <div class="faq">
       <div class="faq-title">常见问题</div>

package/data-prepper/resources/skillforge-guide.txt

@@ -122,6 +122,7 @@ skill-forge init --skills daily-report,weekly-report --yes
 | 查全部命令 | skill-forge --help |
 | 问单个技能用法 | 直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出 |
 | 问 SkillForge 本身 | 问「skillforge 怎么用」，AI 朗读本指引并打开排版页 |
+| 查技能双语简介 / 实操文章 | SKILLS_CATALOG.md（21 技能逐条中英简介）/ docs/articles/（实操文章）/ docs/directory-submission.md（目录收录素材） |
 
 ## 六、常见问题
 

package/data-prepper/user-config.md

@@ -1,5 +1,5 @@
 # user-config.md（本文件不会被 skill 升级覆盖，你的修改永久保留）
-# 官方配置更新时，另存 user-config.md.upstream 对照文件，可手动合并新配置点
+# 官方配置更新时，另存 user-config.upstream.md 对照文件，可手动合并新配置点
 
 ```yaml
 CONFIG_VERSION: 1  # 配置结构版本，skill 升级迁移依据

package/decision-log/SKILL.md

@@ -19,13 +19,13 @@ disable-model-invocation: false
 
 ## ⚙️ 配置与自定义
 
-**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（DIR/TEMPLATE/ASK_CONFIRM）都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（DIR/TEMPLATE/ASK_CONFIRM）都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.upstream.md` 对照文件，可按需手动合并新配置点。
 
 ## 配置版本机制（升级保护）
 
 本 skill 当前配置版本为 `1`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明不一致：
 
-1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
+1. 先将旧 user-config.md 备份为 `user-config.bak-<时间戳>.md`（同目录，绝不删除旧值）
 2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
 3. 更新 CONFIG_VERSION 为当前版本
 4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」

package/decision-log/resources/skillforge-guide.html

@@ -361,6 +361,7 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
       <tr><td>查全部命令</td><td><span class="cmd-in">skill-forge --help</span></td></tr>
       <tr><td>问单个技能用法</td><td>直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出</td></tr>
       <tr><td>问 SkillForge 本身</td><td>问「skillforge 怎么用」，AI 朗读本指引并打开排版页</td></tr>
+      <tr><td>查技能双语简介 / 实操文章</td><td><span class="cmd-in">SKILLS_CATALOG.md</span>（21 技能逐条中英简介）/ <span class="cmd-in">docs/articles/</span>（实操文章）/ <span class="cmd-in">docs/directory-submission.md</span>（目录收录素材）</td></tr>
     </table>
     <div class="faq">
       <div class="faq-title">常见问题</div>

package/decision-log/resources/skillforge-guide.txt

@@ -122,6 +122,7 @@ skill-forge init --skills daily-report,weekly-report --yes
 | 查全部命令 | skill-forge --help |
 | 问单个技能用法 | 直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出 |
 | 问 SkillForge 本身 | 问「skillforge 怎么用」，AI 朗读本指引并打开排版页 |
+| 查技能双语简介 / 实操文章 | SKILLS_CATALOG.md（21 技能逐条中英简介）/ docs/articles/（实操文章）/ docs/directory-submission.md（目录收录素材） |
 
 ## 六、常见问题
 

package/decision-log/user-config.md

@@ -1,5 +1,5 @@
 # user-config.md（本文件不会被 skill 升级覆盖，你的修改永久保留）
-# 官方配置更新时，另存 user-config.md.upstream 对照文件，可手动合并新配置点
+# 官方配置更新时，另存 user-config.upstream.md 对照文件，可手动合并新配置点
 
 ```yaml
 CONFIG_VERSION: 1  # 配置结构版本，skill 升级迁移依据

package/deck-stage/SKILL.md

@@ -1,13 +1,6 @@
 ---
 name: deck-stage
-description: >
-  登台 deck-stage：把日报/周报/月报/季报/年报（md/HTML/口述大纲）或散装素材（目录/文件/随手文字）转成专业 .pptx 演示文稿。
-  三问交互——先问素材（指定目录/指定文件/贴文字/口述主题）、再报页结构大纲表确认、后选成片方式（一键成片/逐页确认）。
-  混合模式——常规页原生生成（文本/数据卡/时间线/柱图/饼图/折线，全部可编辑），封面与结尾页用 HTML 截图贴图（视觉保真）。
-  视觉与报告深蓝面板体系同源：tech 深蓝科技（默认）/biz 浅色商务/mono IDEA 黑亮/light IDEA 白亮/warm 温暖渐变五主题，
-  五段节色（蓝/绿/紫/玫红/橙）。每页可带演讲备注（notes），bullets 页可配图。
-  数据经结构化 data.json 交给 resources/pptx-builder.js（PptxGenJS，本目录 node_modules 离线可用）产出 16:9 pptx。
-  当用户请求把报告/日报/周报/月报/季报/年报转成 PPT、做成 PPT、导出 pptx、生成演示文稿、登台，或询问本 skill 用法时使用。用户要 HTML 网页幻灯（网页放映/分享）时不用本 skill（交给 magic-deck）；「做 PPT/演示文稿」未言明产出形态时先 AskUserQuestion 二选一（.pptx 可编辑文件 → 本 skill；HTML 网页幻灯 → magic-deck），不擅自默认。
+description: 登台 deck-stage：把日报/周报/月报/季报/年报（md/HTML/口述大纲）或散装素材（目录/文件/随手文字）转成专业 .pptx 演示文稿。 三问交互——先问素材（指定目录/指定文件/贴文字/口述主题）、再报页结构大纲表确认、后选成片方式（一键成片/逐页确认）。 混合模式——常规页原生生成（文本/数据卡/时间线/柱图/饼图/折线，全部可编辑），封面与结尾页用 HTML 截图贴图（视觉保真）。 视觉与报告深蓝面板体系同源：tech 深蓝科技（默认）/biz 浅色商务/mono IDEA 黑亮/light IDEA 白亮/warm 温暖渐变五主题， 五段节色（蓝/绿/紫/玫红/橙）。每页可带演讲备注（notes），bullets 页可配图。 数据经结构化 data.json 交给 resources/pptx-builder.js（PptxGenJS，本目录 node_modules 离线可用）产出 16:9 pptx。 当用户请求把报告/日报/周报/月报/季报/年报转成 PPT、做成 PPT、导出 pptx、生成演示文稿、登台，或询问本 skill 用法时使用。用户要 HTML 网页幻灯（网页放映/分享）时不用本 skill（交给 magic-deck）；「做 PPT/演示文稿」未言明产出形态时先 AskUserQuestion 二选一（.pptx 可编辑文件 → 本 skill；HTML 网页幻灯 → magic-deck），不擅自默认。
 allowed-tools: ["Bash", "Read", "Write", "Edit"]
 disable-model-invocation: false
 ---
@@ -76,7 +69,7 @@ DIR（落盘根目录，DIR_MAC/DIR_WIN 双键）、THEME（tech/biz/mono/light/
 
 `user-config.md` 头部有 `CONFIG_VERSION` 字段，声明配置结构版本。本 skill 当前要求版本为 2。每次执行前先读 user-config.md：
 
-1. 若 CONFIG_VERSION 缺失或小于当前要求版本：先将旧 `user-config.md` 备份为 `user-config.md.bak-<时间戳>`
+1. 若 CONFIG_VERSION 缺失或小于当前要求版本：先将旧 `user-config.md` 备份为 `user-config.bak-<时间戳>.md`
 2. 按版本迁移规则迁移字段（新增字段补默认值、改名字段按映射改名、删除字段保留在备份并在对话中提示用户）
 3. 更新 `CONFIG_VERSION` 为当前版本
 4. 对话告知用户「配置已升级到 vN：新增 X、改名 Y」
@@ -85,7 +78,7 @@ DIR（落盘根目录，DIR_MAC/DIR_WIN 双键）、THEME（tech/biz/mono/light/
 
 **无法迁移项处理**（值域失效 / 语义漂移）：三绝不——绝不静默（无法迁移项停下问，不猜值）、绝不丢失（旧值永远在 .bak-时间戳）、一次说清（升级报告三段式：⚠️ 版本与备份路径 → ✅ 已自动迁移 → 🟡 无法迁移项逐条附原因+影响+建议替代）；随后 AskUserQuestion 三选项（A 用建议值 / B 用户给新值 / C 保持旧配置——不更新 CONFIG_VERSION，每次执行再提醒）；报告必附回滚一句话。
 
-升级技能时 user-config.md 不会被覆盖（官方更新另存 `user-config.md.upstream` 对照文件）。
+升级技能时 user-config.md 不会被覆盖（官方更新另存 `user-config.upstream.md` 对照文件）。
 
 ## 规则速览
 

package/deck-stage/resources/skillforge-guide.html

@@ -361,6 +361,7 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
       <tr><td>查全部命令</td><td><span class="cmd-in">skill-forge --help</span></td></tr>
       <tr><td>问单个技能用法</td><td>直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出</td></tr>
       <tr><td>问 SkillForge 本身</td><td>问「skillforge 怎么用」，AI 朗读本指引并打开排版页</td></tr>
+      <tr><td>查技能双语简介 / 实操文章</td><td><span class="cmd-in">SKILLS_CATALOG.md</span>（21 技能逐条中英简介）/ <span class="cmd-in">docs/articles/</span>（实操文章）/ <span class="cmd-in">docs/directory-submission.md</span>（目录收录素材）</td></tr>
     </table>
     <div class="faq">
       <div class="faq-title">常见问题</div>

package/deck-stage/resources/skillforge-guide.txt

@@ -122,6 +122,7 @@ skill-forge init --skills daily-report,weekly-report --yes
 | 查全部命令 | skill-forge --help |
 | 问单个技能用法 | 直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出 |
 | 问 SkillForge 本身 | 问「skillforge 怎么用」，AI 朗读本指引并打开排版页 |
+| 查技能双语简介 / 实操文章 | SKILLS_CATALOG.md（21 技能逐条中英简介）/ docs/articles/（实操文章）/ docs/directory-submission.md（目录收录素材） |
 
 ## 六、常见问题
 

package/docs/articles/ai-daily-report-correct-pose.md

@@ -0,0 +1,39 @@
+# AI 写日报的正确姿势：从一句口述到三件套成品
+
+> 关键词：AI 写日报 / 工作日报 / Agent Skills / 技能化工作流
+> 仓库：[SkillForge](https://github.com/windfallsheng/SkillForge) · 技能简介：[SKILLS_CATALOG.md#daily-report](../../SKILLS_CATALOG.md)
+
+把「帮我写今天的日报」直接丢给 AI，大概率得到三种翻车：一是流水账——把今天的事平铺一遍，没有主次；二是流水线味——满篇「赋能」「抓手」，不像你写的；三是失忆——明天再让它写，昨天的格式又变了。
+
+问题不在 AI 不够聪明，而在每次对话都是零上下文起跑：它不知道你的工种、你的口径、你昨天怎么写的。正确姿势是把「怎么写日报」固化成技能——固定工序、行业词条、个人模板，一次配置，次次复用。
+
+## 第一步：安装（一分钟）
+
+```bash
+npm i -g skill-forge-hub
+skill-forge init        # 交互勾选 daily-report
+```
+
+## 第二步：口述，而不是写作
+
+不用组织语言，一段大白话即可：
+
+> 今天上午调通了支付回调的异常重试，下午排查了订单对账差异，明天准备联调退款流程。风险是第三方接口文档不全。
+
+技能按固定三段结构产出：**任务进度 / 明日计划 / 风险阻塞点**。内置 12 个行业的职业词典，按你的角色取词——开发写「联调、回归」，产品写「验收、迭代」，话术不跑偏。
+
+## 第三步：收三件套成品
+
+一次生成三形态：对话里直接给 md 正文（贴群聊）；落盘 HTML 页面（发邮件、存文档）；导出 PNG 截图（一键贴图）。同一份内容，去哪都有合适的模样。
+
+## 第四步：把调教沉淀成模板
+
+觉得默认结构不够贴切？把常用写法写进 `user-config.md` 的自定义模板，之后每次生成自动套用；连日期都不必多说——「昨天的日报」「上周三的日报」自然语言直接定位。配置抽离在技能目录之外，升级技能不覆盖你的模板。
+
+## 进阶：同一套口述，打通整条汇报链
+
+同源的周报、月报、季报、年报共用这套口述习惯——本周结论先行、月度问题改进、季度环比同比、年度五段复盘。团队场景还有日报收集台：成员各自口述，汇总成按日期分组的团队报告。
+
+## 结语
+
+AI 写日报的正确姿势，不是憋出更长的提示词，而是把一次调教变成永久工艺。技能化之后，日报的稳定产出从「看运气」变成「按工序」——而这套工序，换哪个 AI 助手都走得通。

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

@@ -0,0 +1,37 @@
+# 用 AI 技能包管提示词：把散落的灵光收进一只锦囊
+
+> 关键词：提示词管理 / Agent Skills / AI 技能包 / 锦囊 prompt-pouch
+> 仓库：[SkillForge](https://github.com/windfallsheng/SkillForge) · 技能简介：[SKILLS_CATALOG.md#prompt-pouch](../../SKILLS_CATALOG.md)
+
+好提示词是资产。但大多数人的提示词过着流浪生活——散落在聊天记录、备忘录、收藏夹、转发消息里。当时灵光一闪写下的那段精妙引导，三个月后想再用，翻遍历史找不到，只能凭记忆重写，还得从头调教。
+
+「锦囊」（prompt-pouch）就是为这件事造的 AI 技能：一个本地 HTML 管理台，把提示词按分组收纳、全文搜索、一键复制，还能给提示词留 {变量} 插值位——同一段模板，填入不同对象就能反复复用。下面是一套十分钟上手流程。
+
+## 第一步：安装（一分钟）
+
+```bash
+npm i -g skill-forge-hub
+skill-forge init        # 交互勾选 prompt-pouch
+```
+
+也可以不从 CLI 装：直接把仓库里的 `prompt-pouch/` 目录复制进你 AI 助手的技能目录，效果相同。技能就是一份薄薄的 SKILL.md 加资源文件，与宿主无关。
+
+## 第二步：初始化（一句话）
+
+对 AI 说「建一个锦囊」。它会在你指定的目录生成两个东西：管理页面 `prompt-pouch.html` 和真相源 `data/prompts.json`。页面负责展示，数据负责记忆，两者严格分离——这是后面一切安全的根。
+
+## 第三步：开始收藏（口述即可）
+
+不用打开编辑器。对 AI 说「把这段话加进锦囊」——比如把某次对话里验证过的那段「角色设定 + 输出格式」整段收进去，它替你写进 JSON；刷新页面即见。当然也可以直接在页面表单里手动录入。
+
+## 第四步：用起来
+
+管理台该有的都有：分组侧栏（带计数徽章）、关键词搜索（命中高亮）、收藏星标、标签点击过滤、四种排序（手动拖拽可用）、JSON 导入导出备份、使用频率统计。挑提示词时看频率，就知道哪些真正好用。
+
+## 为什么做成「技能」而不是「应用」
+
+关键差别在宿主中立。锦囊今天在 Qoder 里用，明天换 Claude Code、Cursor，复制过去同样能唤起，数据 JSON 原样带走。提示词是你的，不是某个工具的。
+
+## 结语
+
+提示词管理的正确姿势，不是「记住更好的提示词」，而是让每条好提示词都有一个回得来的家。锦囊的每一张卡片，都是一次被验证过的对话起点。

package/docs/articles/csdn-skillforge-21-skills.md

@@ -0,0 +1,89 @@
+# 还在每次从头教 AI？我把 21 种重复劳动锻造成了开箱即用的技能包
+
+> 项目：SkillForge（技能锻造坊） · 开源协议：MIT · 仓库：https://github.com/windfallsheng/SkillForge
+> 一句话安装：`npm i -g skill-forge-hub && skill-forge init`
+
+## 一、一个熟悉的场景
+
+你一定经历过：让 AI 写日报，它这次三段、下次五段；让它做 PPT，封面风格全靠运气；上个月调教好的「完美提示词」，这个月翻遍聊天记录也找不回来。
+
+问题不在 AI 不够聪明，而在**每次对话都是零上下文起跑**。AI 记得住你上一句话，记不住你上个月的偏好。
+
+于是有了 SkillForge——一个「AI 手艺」的锻造坊：把日复一日的重复劳作，锻造成一句指令就能完成的顺手工具。每个技能都是一份写给 AI 的手艺说明：入口薄薄一张 SKILL.md，重内容按阶段拆成资源分册，AI 执行到哪一步才读哪一册，上下文占用极小。
+
+## 二、21 个技能，七个车间
+
+目前工坊里锻造了 21 件技能，按「最终产出什么」分七类。
+
+### 1. 报表汇演（6 件）——从一句话到五件套汇报
+
+日报、周报、月报、季报、年报五件套 + 团队日报收集台。共同的本事：
+
+- **多源成稿**：一段口述、一份文件、一张图片、几句补充，什么材料都能整理成稿；
+- **12 行业职业词典**：开发写「联调、回归」，产品写「验收、迭代」，话术不跑偏；
+- **自然语言日期**：「昨天的日报」「上周三的日报」直接定位，连续多日还能批量；
+- **三件套落盘**：对话给 md 正文 + 落盘 HTML 页面 + PNG 截图，贴群聊、发邮件各有形态。
+
+季报带环比同比双基准，年报五段式含新年规划，团队收集台能把成员的日报收拢成按日期分组的汇总。**同一套口述习惯，打通整条汇报链。**
+
+### 2. 演示汇演（2 件）——PPT 的两副面孔
+
+- **magic-deck**：内容 → 单文件 HTML 幻灯。16:9 舞台、十六套版式模板、十七套主题、21 套领域模板，自动播放、键盘热键、全屏纯净放映；
+- **deck-stage**：报告 → 原生可编辑的 .pptx。常规页用 PptxGenJS 生成（数据卡、时间线、柱图、饼图可二次编辑），封面结尾页 HTML 截图保真，每页带演讲备注。
+
+一个适合演示效果，一个适合交付修改，说「做个 PPT」它自会问你要哪种。
+
+### 3. 文档装裱（3 件）——让文档体面地走出去
+
+- **article-to-html**：Word / Markdown / 纯文本 → 精美独立 HTML（思源黑体 + Roboto 商用免费字体），图表用 HTML/CSS 矢量重绘，再逐章截出 Retina 2x 高清图；
+- **twin-docs**：中文文档翻译并同步为英文版（或反向），术语表对齐、标题层级逐项对应、双向同步检查；
+- **one-pager**：一句话想法 → 一页纸 HTML 海报。**32 套布局模板（含水墨、红金宫廷、青绿山水等国风）× 25 套配色主题 = 800 种版式**，主题坞悬停即显主题名，?shot 参数一键截 PNG。
+
+### 4. 沟通协作（3 件）——把碎片收进体系
+
+- **meeting-minutes**：口述材料 → 五段式会议纪要，行动项带负责人与截止时间——汇报链的源头，可被日报周报引用；
+- **prompt-pouch**：本地提示词管理台。分组、搜索、收藏、标签、{变量} 插值、导入导出备份，好提示词从此有了回得来的家；
+- **decision-log**：重要决策四元组日志（结论 / 取舍 / 被否方案 / 适用条件），随时检索复盘。
+
+### 5. 工程提效（3 件）——文档与代码之间
+
+- **spec-doc2spec**：Word/Markdown 需求文档 → 结构化需求切片（Pandoc 机械转换 + AI 校对防错）；
+- **spec-spec2doc**：Markdown 规格 → Word/PDF 交付文档；
+- **release-notes**：git 两个版本标签之间的提交 → 中英双语发版说明 + CHANGELOG 条目。
+
+### 6. 数据整备（2 件）——把散装数据收拾利落
+
+- **data-prepper**：Excel/CSV/JSON 清洗结构化，清洗项明示、每步留痕、不猜不编，附数据概览报告；
+- **commit-heatmap**：git 近一年提交 → GitHub 风格热力图（53 周 × 7 天格子 + 统计卡），离线零依赖。
+
+### 7. 技能自造（2 件）——工坊的自我复制
+
+- **meta-forge**：从需求出发锻造新技能的元技能，自动植入配置保护、版本钥匙、双轨文档等八大机制；
+- **skill-doctor**：给技能目录做体检，frontmatter、资源引用、占位符残留逐项静态检查，报告行级定位。
+
+## 三、为什么是「技能」而不是「提示词」
+
+提示词是一次性的对话；技能是**可移植的手艺**：
+
+1. **宿主中立**：换一份薄薄的 frontmatter 信封，同一份技能就能从 Qoder 带去 Claude Code、Cursor——不绑定任何厂商；
+2. **配置保护**：你的个性化配置出站在 user-config.md，升级技能永不覆盖；配置结构变化时先备份再三选一；
+3. **版本感知回炉**：模板升级后说一句「把我旧日报都升级成新样式」，旧产物批量换新，旧版先备份；
+4. **零依赖离线**：全部技能离线可用，不联网、不传数据，产物留在你自己的目录里。
+
+## 四、一分钟上手
+
+```bash
+npm i -g skill-forge-hub   # 全局安装 CLI
+skill-forge ls            # 浏览 21 件技能（只读）
+skill-forge init          # 交互挑选，自动探测 AI 助手技能目录
+```
+
+装完直接对话触发：「写日报」「写周报」「记会议」「做个 PPT」「做张海报」，或者干脆丢给它一个文档。
+
+升级同样轻松：`npm update -g skill-forge-hub` 升 CLI 本体，`skill-forge update` 升技能——升级清单支持 a=全部 / 编号挑选 / q=取消，你的配置全程受保护。
+
+## 五、写在最后
+
+AI 时代最贵的不再是「知道什么」，而是「把会做的事稳定复现」。SkillForge 的每一件技能，都是一次被验证过的调教被固化成了永久工艺——今天调好的手感，明天、下个月、换台机器、换个助手，都还在。
+
+仓库已开源（MIT），21 件技能双语简介见 [SKILLS_CATALOG.md](https://github.com/windfallsheng/SkillForge/blob/main/SKILLS_CATALOG.md)，另有两篇实操文章（《用 AI 技能包管提示词》《AI 写日报的正确姿势》）见 docs/articles/。欢迎 Star、试用、一起锻造。

package/docs/directory-submission.md

@@ -0,0 +1,106 @@
+# 目录收录素材包 · Directory Submission Kit
+
+> 本文件汇总 SkillForge 提交技能目录（skills.sh / awesome-claude-skills）所需的全部素材与操作指引。
+> 当前状态：**素材已就绪**，提交动作（提 PR / 发布 / 改 topics）需账户授权，按下方指引一步到位。
+
+## 三动作执行状态
+
+| 动作 | 状态 | 落点 |
+|:---|:---|:---|
+| ① 提交进 skills.sh 与 awesome-claude-skills | 素材就绪，待授权执行 | 本文件 |
+| ② 每技能独立可引用简介 | ✅ 已完成 | [SKILLS_CATALOG.md](../SKILLS_CATALOG.md) |
+| ③ 实操文章 | ✅ 已完成 | [articles/ai-prompt-management-skill-pouch.md](articles/ai-prompt-management-skill-pouch.md)、[articles/ai-daily-report-correct-pose.md](articles/ai-daily-report-correct-pose.md) |
+
+---
+
+## 通道 A：awesome-claude-skills（PR 制目录）
+
+收录方式：fork 目录仓库 → 按目录格式追加条目 → 提 PR。条目文案直接摘录 [SKILLS_CATALOG.md](../SKILLS_CATALOG.md) 对应锚点（每技能一段，独立成文）。
+
+### A1. 条目素材（英文，可直接整段摘录）
+
+```markdown
+| [SkillForge](https://github.com/windfallsheng/SkillForge) | 21 reusable agent skills (SKILL.md entry, host-agnostic) spanning reporting (daily/weekly/monthly/quarterly/annual + team collector), document beautification (Word→HTML, bilingual twin docs, one-page posters), engineering (Pandoc doc↔spec, release notes), presentations (HTML decks + editable PPTX), data prep (Excel/CSV cleaning, git heatmaps), collaboration (meeting minutes, prompt management console, decision logs) and meta-skills (skill forge + health check). Fully offline, zero external dependencies, user config isolated in user-config.md. One-line install: `npm i -g skill-forge-hub && skill-forge init`. |
+```
+
+> 若目录按单技能分行，则摘录对应锚点，如 `SKILLS_CATALOG.md#daily-report` / `#prompt-pouch` / `#one-pager`（建议先提交旗舰技能 3-5 个，再逐步扩列）。
+
+### A2. PR 标题与描述模板
+
+```
+Title: Add SkillForge — 21-skill craft workshop (reports / docs / decks / data / collaboration)
+
+## Summary
+SkillForge is a workshop of 21 reusable agent skills, each a thin SKILL.md entry
+plus stage-split resources, host-agnostic across Claude Code / Cursor / Qoder / etc.
+
+## Highlights
+- Report family: daily / weekly / monthly / quarterly / annual reports + team daily collector,
+  12-industry glossary, natural-language dates, custom templates
+- prompt-pouch: local HTML prompt management console ({variable} interpolation, groups,
+  search, tags, JSON backup)
+- one-pager: 32 layout templates × 25 themes (800 combos) one-screen HTML posters
+- All offline, zero external dependencies; user config isolated (upgrades never overwrite)
+
+## Links
+- Repo: https://github.com/windfallsheng/SkillForge
+- Per-skill bilingual profiles: https://github.com/windfallsheng/SkillForge/blob/main/SKILLS_CATALOG.md
+```
+
+### A3. 操作步骤（两条路任选）
+
+**路径 1：gh CLI**（先登录，见文末「gh 登录指引」）
+
+```bash
+gh auth login                          # 一次性登录
+gh repo fork ComposioHQ/awesome-claude-skills --clone
+# 编辑 README 追加条目（用 A1 素材）
+gh pr create --title "Add SkillForge — 21-skill craft workshop" --body-file pr-body.md
+```
+
+**路径 2：网页操作**：GitHub 打开目录仓库 → Fork → 在线编辑 README 追加条目 → Create pull request（描述贴 A2 模板）。
+
+---
+
+## 通道 B：skills.sh（自动索引，收录需发布）
+
+### B1. 收录机制（probe 结论）
+
+skills.sh 由 Vercel 运营，**无 PR 提交入口**：它索引每一个通过 open skills CLI（vercel-labs/skills）生态公开发布的技能。SkillForge 当前以 npm 包 `skill-forge-hub` + GitHub 仓库形态存在，要进 skills.sh 索引，需以 open skills 兼容形态发布技能包。
+
+### B2. 发布步骤（⚠️ 发布动作，需拍板后执行）
+
+```bash
+# 1. 为技能补 open skills 元数据（skills.json / 每技能 frontmatter 对齐 open skills 规范）
+# 2. 用 open skills CLI 发布（自动进 skills.sh 索引）
+npx skills publish
+# 3. 验证：skills.sh 搜索 skill-forge / daily-report 可见
+```
+
+> 受「未获用户明确指示不得发版本」纪律约束：此通道在用户明确同意发布前不执行。
+
+---
+
+## 通道 C：零成本加码（无授权门槛，建议随 PR 一起做）
+
+1. **GitHub topics**（提高目录与搜索权重，网页 Settings 或 CLI 一键）：
+
+```bash
+gh repo edit windfallsheng/SkillForge   --add-topic claude-skills --add-topic agent-skills --add-topic claude-code   --add-topic cursor --add-topic ai-agents --add-topic productivity   --add-topic prompt-management --add-topic reporting
+```
+
+2. **文章分发**：将 [docs/articles/](articles/) 两篇转载到掘金 / 知乎 / 博客园，文末带仓库链接（搜索语料 + 引用锚点）。
+
+---
+
+## 附：gh 登录指引
+
+```bash
+gh auth login
+# 交互选择：GitHub.com → HTTPS 或 SSH → Authenticate Git with your GitHub credentials
+#   → Login with a web browser（推荐）→ 复制一次性 code 到浏览器完成授权
+# 验证：
+gh auth status
+```
+
+登录后即可执行通道 A 与通道 C 的全部命令。

package/docs/install.en.md

@@ -86,9 +86,9 @@ skill-forge update --skills daily-report        # upgrade just one
 ```
 
 - **Config structure unchanged**: silent upgrade — skill files update, your `user-config.md` stays untouched
-- **Config structure changed** (official `CONFIG_VERSION` bumped): your config is first backed up as `user-config.md.bak-<timestamp>`, then a three-way choice:
+- **Config structure changed** (official `CONFIG_VERSION` bumped): your config is first backed up as `user-config.bak-<timestamp>.md`, then a three-way choice:
   - `[1] official overwrite`: take the fresh official config (your old one is recoverable from the backup)
-  - `[2] keep mine` (default, safest): your config stays, the official version is saved as `user-config.md.upstream` for you to compare and merge new config points manually
+  - `[2] keep mine` (default, safest): your config stays, the official version is saved as `user-config.upstream.md` for you to compare and merge new config points manually
   - `[3] decide later`: skip this time, no companion file generated
 - **Official files deleted**: cleaned up precisely via the `.installed-manifest` (only files the official version deleted, plus now-empty directories); your self-created files are never touched
 
@@ -116,7 +116,7 @@ Run `npm i -g skill-forge-hub && skill-forge init` in the new environment; to ca
 
 - **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
 - **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) —
-  1. your config is first backed up as `user-config.md.bak-<timestamp>`
+  1. your config is first backed up as `user-config.bak-<timestamp>.md`
   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)
   3. `--yes` or non-interactive environments default to `[2]`, the safest option
 - **Version match**: silent upgrade — only skill files are updated, config stays untouched

package/docs/install.md

@@ -86,9 +86,9 @@ skill-forge update --skills daily-report        # 只升级某一个
 ```
 
 - **配置结构没变**：无感升级——技能文件更新，你的 `user-config.md` 原样保留
-- **配置结构变了**（官方 `CONFIG_VERSION` 升了）：先自动备份 `user-config.md.bak-<时间戳>`，再交互三选一：
+- **配置结构变了**（官方 `CONFIG_VERSION` 升了）：先自动备份 `user-config.bak-<时间戳>.md`，再交互三选一：
   - `[1] 官方覆盖`：换成全新官方配置（旧配置随时可从备份找回）
-  - `[2] 保留我的`（默认，最安全）：你的配置不动，官方新版另存 `user-config.md.upstream` 对照文件，自己对比后按需合并新配置点
+  - `[2] 保留我的`（默认，最安全）：你的配置不动，官方新版另存 `user-config.upstream.md` 对照文件，自己对比后按需合并新配置点
   - `[3] 稍后处理`：本次跳过，不生成对照文件
 - **官方删了文件**：按 `.installed-manifest` 安装清单精准清理官方已删除的文件与空目录；你自建的文件一律不动
 
@@ -116,7 +116,7 @@ skill-forge init --skills daily-report,weekly-report --yes
 
 - **常驻保护**：目标目录已存在的 `user-config.md`（及技能 `.preserve` 清单声明的文件）永不被覆盖，你的本地配置永久保留；官方配置内容有更新时另存 `.upstream` 对照文件，可按需手动合并新配置点
 - **版本感知**：官方 `user-config.md` 首行的 `CONFIG_VERSION` 高于你的本地版本（配置结构增/减/改名）时——
-  1. 先把你的配置备份为 `user-config.md.bak-<时间戳>`
+  1. 先把你的配置备份为 `user-config.bak-<时间戳>.md`
   2. 交互三选一：`[1] 官方覆盖`（旧配置在备份中随时找回）/ `[2] 保留我的` + 官方版另存 `.upstream` 对照（默认）/ `[3] 稍后处理`（本次不生成对照文件）
   3. `--yes` 或非交互环境默认 `[2]`，最安全
 - **版本一致**：无感升级，只更新技能文件，配置原样保留

package/docs/usage-examples.en.md

@@ -11,7 +11,7 @@ Every example follows the same rhythm: **install → first generation → config
 1. **Install**: `skill-forge init --skills daily-report`
 2. **First generation**: just say "write a daily report", describe what you did today (or hand it a paragraph / a file / an image) → produces `daily-report-YYYYMMDD.md` + `.txt` + `.html` (auto-opened), plus a full-page content-png capture
 3. **Config tweaks**: ask the AI to open the skill's `user-config.md` and change `DIR` (save directory), `THEME` (tech/biz/mono/light/warm five themes), `TEMPLATE: custom` for a custom template; ad-hoc verbal requests ("only 3 items today") apply once and never touch config
-4. **After an official upgrade**: `npm update -g skill-forge-hub` (upgrade the CLI itself) → `skill-forge update` (upgrade the skills) → if the official config structure changed, it backs up first then offers a three-way choice; pick `[2] keep mine`, then compare `user-config.md.upstream` and merge new config points manually (e.g. a new DATA_SOURCES list)
+4. **After an official upgrade**: `npm update -g skill-forge-hub` (upgrade the CLI itself) → `skill-forge update` (upgrade the skills) → if the official config structure changed, it backs up first then offers a three-way choice; pick `[2] keep mine`, then compare `user-config.upstream.md` and merge new config points manually (e.g. a new DATA_SOURCES list)
 5. **Output reforge**: when the official template stamp bumped (`sf-template@N`) → the next generation says "found X old daily reports" → say "upgrade all my old daily reports to the new style" → pick all or some → shallow upgrade (style changes) swaps style blocks, deep upgrade (structure changes) rebuilds from the sibling md draft, old version backed up first
 
 ## Example 2: prompt-pouch (local console + user data)

package/docs/usage-examples.md

@@ -11,7 +11,7 @@
 1. **安装**：`skill-forge init --skills daily-report`
 2. **首次生成**：直接说「写日报」，口述今天干了什么（或丢一段文字 / 一个文件 / 一张图）→ 生成 `daily-report-YYYYMMDD.md` + `.txt` + `.html`（自动打开），附整页截图 content-png
 3. **修改配置**：让 AI 打开技能目录的 `user-config.md`，改 `DIR`（落盘目录）、`THEME`（tech/biz/mono/light/warm 五主题）、`TEMPLATE: custom` 换自定义模板；临时口头要求（如「今天只写 3 条」）当次生效、不写配置
-4. **官方升级后**：`npm update -g skill-forge-hub`（升级 CLI 本体）→ `skill-forge update`（升级技能）→ 若官方配置结构变了，先自动备份再交互三选一，选 `[2] 保留我的`，然后对照 `user-config.md.upstream` 手动合并新配置点（如新增的 DATA_SOURCES 数据源清单）
+4. **官方升级后**：`npm update -g skill-forge-hub`（升级 CLI 本体）→ `skill-forge update`（升级技能）→ 若官方配置结构变了，先自动备份再交互三选一，选 `[2] 保留我的`，然后对照 `user-config.upstream.md` 手动合并新配置点（如新增的 DATA_SOURCES 数据源清单）
 5. **旧产物回炉**：官方模板版本戳升了（`sf-template@N`）→ 下次生成时提示「检测到 X 份旧版日报」→ 说「把我旧日报都升级成新样式」→ 选全部或部分 → 浅升级（样式变化）替换样式块、深升级（结构变化）从同目录 md 底稿重建，旧版先备份
 
 ## 示例二：prompt-pouch 锦囊（本地管理台 + 用户数据）

package/magic-deck/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: magic-deck
-description: 把内容做成 HTML 形态、PPT 体验的魔法幻灯（单文件离线打开、零外部依赖）。内置播放引擎（自动播放/循环/间隔可设/从头或当前播放）、键盘热键（翻页/直达/截图/复制/全屏）、十七套内置模板（经典商务/极简留白/杂志画册/黑金发布/时间线叙事/流程步骤/海报宣传/复古报纸/金融报表/蓝图工程/教学板书/高管简报/扁平磁贴/模块网格/暗夜深色/自然清新/统计图表，放映时经「🎨 模板」面板随时切换
-+ 模板面板「💼 领域」Tab 二十二套成套模板（六分类：教育学术——毕业答辩/开题报告/教学课件；职场商务——年终汇报/竞聘述职/商业计划书/求职简历；企业运营——产品发布/科技发布会/营销方案/销售方案/企业培训/年会盛典；专业领域——金融分析/医疗科普/法律合规；党政政务——政务汇报/党建汇报；生活场景——餐饮品牌/旅游攻略/节日庆典/公益慈善，一键生成整套页面——封面+目录+内容页+图表页，两段确认可撤销）+ 图表动画五式（柱状生长/折线描画/饼图扇入/仪表扫弧/数字滚动，图表挂 data-anim-chart 翻页自动播放、翻回重放，保留图表自身动画）——可应用到全部页/仅本页/勾选页，支持「预览本页」先看效果再应用，标题自动映射到模板固定位置）、编辑能力（撤销/重做 Ctrl+Z、右侧页面管理边栏：缩略图跳页/新页/复页/排序/删页）+ 十七套主题面板即点即换（全部页/仅本页自由换肤）、动画库（右侧边栏「⚙ 工具」Tab：翻页风格八套 / 元素入场十二式 / 离场十二式 / 强调八式 / 标题文字动画四式，应用范围全部页面或仅本页，即点即换、选择记忆）、页内连接与外部链接、逐页 PNG 截图（本页/选页批量，选页面板默认全选=一键导出全部页）与本页/选页批量文字复制（均不含任何操作元素）、全屏放映纯净模式（无关元素自动退场）。当用户请求把内容做成幻灯片/PPT/演示文稿、生成 HTML 幻灯、做分享页/汇报页，提到 magic-deck 或 /magic-deck，或询问其用法（怎么用/使用说明/能干什么）时使用。用户要可编辑 .pptx 文件（导出 pptx、转成 PPT 文件）时不用本 skill（交给 deck-stage）；「做 PPT/演示文稿」未言明产出形态时先 AskUserQuestion 二选一（HTML 网页幻灯 → 本 skill；.pptx 可编辑文件 → deck-stage），不擅自默认。
+description: 把内容做成 HTML 形态、PPT 体验的魔法幻灯（单文件离线打开、零外部依赖）。内置播放引擎（自动播放/循环/间隔可设）、键盘热键（翻页/直达/截图/复制/全屏）、十七套内置布局模板与二十二套成套领域模板（六分类：教育学术/职场商务/企业运营/专业领域/党政政务/生活场景，一键生成整套页面）、图表动画五式（柱状生长/折线描画/饼图扇入/仪表扫弧/数字滚动）、编辑能力（撤销重做/页面管理边栏）、十七套主题面板即点即换、动画库（翻页风格八套/元素入场十二式/离场十二式/强调八式/标题动画四式）、页内连接与外部链接、逐页 PNG 截图与批量文字复制、全屏放映纯净模式。当用户请求把内容做成幻灯片/PPT/演示文稿、生成 HTML 幻灯、做分享页/汇报页，提到 magic-deck 或 /magic-deck，或询问其用法（怎么用/使用说明/能干什么）时使用。用户要可编辑 .pptx 文件（导出 pptx、转成 PPT 文件）时不用本 skill（交给 deck-stage）；「做 PPT/演示文稿」未言明产出形态时先 AskUserQuestion 二选一（HTML 网页幻灯 → 本 skill；.pptx 可编辑文件 → deck-stage），不擅自默认。
 allowed-tools: Bash, Read, Write
 disable-model-invocation: false
 ---
@@ -41,7 +40,7 @@ disable-model-invocation: false
 
 ## ⚙️ 配置与自定义
 
-**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（TEMPLATE/THEME/TRANSITION/ANIM/WIDTH/HEIGHT/SEC/FILENAME/DIR 等）与用户模板都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（TEMPLATE/THEME/TRANSITION/ANIM/WIDTH/HEIGHT/SEC/FILENAME/DIR 等）与用户模板都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.upstream.md` 对照文件，可按需手动合并新配置点。
 
 ## 规则速览
 
@@ -64,7 +63,7 @@ disable-model-invocation: false
 
 `user-config.md` 首行有 `CONFIG_VERSION` 字段，声明配置结构版本。本 skill 当前要求版本为 2。每次执行前先读 user-config.md：
 
-1. 若 CONFIG_VERSION 缺失或小于当前要求版本：先将旧 `user-config.md` 备份为 `user-config.md.bak-<时间戳>`
+1. 若 CONFIG_VERSION 缺失或小于当前要求版本：先将旧 `user-config.md` 备份为 `user-config.bak-<时间戳>.md`
 2. 按版本迁移规则迁移字段（新增字段补默认值、改名字段按映射改名、删除字段保留在备份并在对话中提示用户）
 3. 更新 `CONFIG_VERSION` 为当前版本
 4. 对话告知用户「配置已升级到 vN：新增 X、改名 Y」
@@ -73,7 +72,7 @@ disable-model-invocation: false
 
 **无法迁移项处理**（值域失效 / 语义漂移 / 数据不兼容）：三情形——①旧值不在新值域（如旧模板/主题名已移除）②同名键含义变化（单位/枚举变更）③数据文件 schema 不兼容。三绝不：绝不静默（无法迁移项停下问，不猜值）、绝不丢失（旧值永远在 .bak-时间戳）、一次说清（升级报告三段式：⚠️ 版本与备份路径 → ✅ 已自动迁移清单 → 🟡 无法迁移项逐条附原因+影响+建议替代）；随后 AskUserQuestion 三选项（A 用建议值 / B 用户给新值 / C 保持旧配置——不更新 CONFIG_VERSION，每次执行再提醒）；报告必附回滚一句话；数据文件迁移前先复制 .bak-时间戳，能映射则映射、不能则写兼容层或留备份提示手动整理
 
-升级技能时 user-config.md 不会被覆盖（官方更新另存 `user-config.md.upstream` 对照文件）。
+升级技能时 user-config.md 不会被覆盖（官方更新另存 `user-config.upstream.md` 对照文件）。
 
 ## 产物升级（回炉）
 

package/magic-deck/resources/skillforge-guide.html

@@ -361,6 +361,7 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
       <tr><td>查全部命令</td><td><span class="cmd-in">skill-forge --help</span></td></tr>
       <tr><td>问单个技能用法</td><td>直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出</td></tr>
       <tr><td>问 SkillForge 本身</td><td>问「skillforge 怎么用」，AI 朗读本指引并打开排版页</td></tr>
+      <tr><td>查技能双语简介 / 实操文章</td><td><span class="cmd-in">SKILLS_CATALOG.md</span>（21 技能逐条中英简介）/ <span class="cmd-in">docs/articles/</span>（实操文章）/ <span class="cmd-in">docs/directory-submission.md</span>（目录收录素材）</td></tr>
     </table>
     <div class="faq">
       <div class="faq-title">常见问题</div>

package/magic-deck/resources/skillforge-guide.txt

@@ -122,6 +122,7 @@ skill-forge init --skills daily-report,weekly-report --yes
 | 查全部命令 | skill-forge --help |
 | 问单个技能用法 | 直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出 |
 | 问 SkillForge 本身 | 问「skillforge 怎么用」，AI 朗读本指引并打开排版页 |
+| 查技能双语简介 / 实操文章 | SKILLS_CATALOG.md（21 技能逐条中英简介）/ docs/articles/（实操文章）/ docs/directory-submission.md（目录收录素材） |
 
 ## 六、常见问题
 

package/magic-deck/user-config.md

@@ -2,7 +2,7 @@
 
 > 你的个人配置全放在这里。skill-forge 升级技能时官方只更新 SKILL.md 与 resources/，
 > 本文件始终保留你的版本——默认主题、页面尺寸、默认播放间隔、文件名、落盘目录放心改。
-> 官方升级若带来新配置点，会另存 `user-config.md.upstream` 对照文件到同目录，
+> 官方升级若带来新配置点，会另存 `user-config.upstream.md` 对照文件到同目录，
 > 你按需查看并手动合并新配置点到本文件。
 
 

package/meeting-minutes/SKILL.md

@@ -27,7 +27,7 @@ disable-model-invocation: false
 
 本 skill 当前配置版本为 `2`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明不一致：
 
-1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
+1. 先将旧 user-config.md 备份为 `user-config.bak-<时间戳>.md`（同目录，绝不删除旧值）
 2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
 3. 更新 CONFIG_VERSION 为当前版本
 4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」

package/meeting-minutes/resources/skillforge-guide.html

@@ -361,6 +361,7 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
       <tr><td>查全部命令</td><td><span class="cmd-in">skill-forge --help</span></td></tr>
       <tr><td>问单个技能用法</td><td>直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出</td></tr>
       <tr><td>问 SkillForge 本身</td><td>问「skillforge 怎么用」，AI 朗读本指引并打开排版页</td></tr>
+      <tr><td>查技能双语简介 / 实操文章</td><td><span class="cmd-in">SKILLS_CATALOG.md</span>（21 技能逐条中英简介）/ <span class="cmd-in">docs/articles/</span>（实操文章）/ <span class="cmd-in">docs/directory-submission.md</span>（目录收录素材）</td></tr>
     </table>
     <div class="faq">
       <div class="faq-title">常见问题</div>

package/meeting-minutes/resources/skillforge-guide.txt

@@ -122,6 +122,7 @@ skill-forge init --skills daily-report,weekly-report --yes
 | 查全部命令 | skill-forge --help |
 | 问单个技能用法 | 直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出 |
 | 问 SkillForge 本身 | 问「skillforge 怎么用」，AI 朗读本指引并打开排版页 |
+| 查技能双语简介 / 实操文章 | SKILLS_CATALOG.md（21 技能逐条中英简介）/ docs/articles/（实操文章）/ docs/directory-submission.md（目录收录素材） |
 
 ## 六、常见问题
 

package/meeting-minutes/user-config.md

@@ -2,7 +2,7 @@
 
 > 你的个人配置全放在这里。skill-forge 升级技能时官方只更新 SKILL.md 与 resources/，
 > 本文件始终保留你的版本——落盘目录、格式、角色画像、自定义模板放心改。
-> 官方升级若带来新配置点，会另存 `user-config.md.upstream` 对照文件到同目录，
+> 官方升级若带来新配置点，会另存 `user-config.upstream.md` 对照文件到同目录，
 > 你按需查看并手动合并新配置点到本文件。