skill-forge-hub 1.0.3 → 1.0.5

package/meeting-minutes/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: meeting-minutes
+description: 生成会议纪要（默认会议信息/会议结论/议题讨论/决议与行动项/下次会议五段结构，中文顿号序号），适配各行业各类型会议（内置 12 类会议类型词典：周例会/项目评审/复盘会/客户会议等）。行动项带负责人与截止时间，是汇报链的源头——日报/周报/月报/季报可直接引用会议行动项。数据来源灵活：直接口述、给一段文字、发文件（Word/PDF/Excel/PPT 等）或图片，都能整理成纪要；也可从会议录音/速记草稿整理。支持自定义模板（可永久或临时指定）。支持自然语言指定会议（今天的会/昨天的会/上周的周例会等）。当用户请求写会议纪要、会议记录、整理会议内容、记会议、做会议总结、/meeting-minutes，或询问会议纪要用法（会议纪要怎么用/会议纪要使用说明）时使用。
+allowed-tools: Bash, Read, Write
+disable-model-invocation: false
+---
+
+# 会议纪要生成
+
+整理本次会话口述 + 提供的文字/文件/图片/录音材料，生成五段式会议纪要（会议信息/会议结论/议题讨论/决议与行动项/下次会议），对话输出 md 正文 + 落盘 md/txt/html/content-png 并自动打开 html。
+
+## 生成流程
+
+0. **读用户配置**（DISK/FORMATS/DIR/SERIES_GROUP/OPEN_HTML/TEMPLATE/ROLE/CONFIRM、自定义模板）→ 先 Read 同目录 `user-config.md`
+1. **提取会议要素**（会议主题/日期/类型/地点/主持人/参会人）→ 读 `resources/content-rules.md` 的「会议要素提取」节
+2. **收集会议内容**（会话口述 + 文字/文件/图片/录音材料，合并去重）→ 读 `resources/content-rules.md` 的「素材来源」节
+3. **内容归类与润色**（五段式结构 / 行动项三要素 / 纯文字模式 / 输出格式 / 写作风格）→ 读 `resources/content-rules.md`
+4. **会议类型词条**（话术含会议类型词时按词典取要素侧重与行动项模板）→ 读 `resources/meeting-type-dictionary.md`
+5. **落盘与截图**（md/txt/html/content-png + 自动打开 html）→ 读 `resources/disk-and-html.md`
+6. **使用咨询**（用户只问「会议纪要怎么用」等用法、未要求生成）→ 读 `resources/usage-guide.md`，将其内容原样输出（首行标题改为「会议纪要生成器使用指南」），不收集材料、不生成纪要、不落盘、不开浏览器
+
+## ⚙️ 配置与自定义模板
+
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（DISK/FORMATS/DIR/SERIES_GROUP/OPEN_HTML/TEMPLATE/ROLE/CONFIRM）与自定义模板都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留。
+
+## 配置版本机制（升级保护）
+
+本 skill 当前配置版本为 `2`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明不一致：
+
+1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
+2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
+3. 更新 CONFIG_VERSION 为当前版本
+4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」
+
+配置升级规则（v1→v2）：新增 `SERIES_GROUP: auto`（纪要系列分组，见 user-config.md 注释）；其余字段不变。
+
+**无法迁移项处理**：值域失效（旧值不在新值域）/ 语义漂移（同名键含义变化）/ 数据不兼容，停下问、不猜值；旧值永远在 .bak-时间戳备份里，报告必附回滚一句话。
+
+## 产物升级（回炉）
+
+生成 HTML 时头部写版本戳 `<meta name="sf-template" content="meeting-minutes@3">`（模板升级时递增 @N 并同步 reference.html 与本文档）。用户说「升级旧产物/回炉旧页面/旧纪要换新样式」时：扫落盘目录下本技能命名的 html，读版本戳筛出旧版（无版本戳或缺少 `<meta name="minutes-id">` 稳定 ID 的产物视为 v0 最旧版，一并进清单） → 列清单（文件/旧版本/手改状态——旧 html 正文与同目录 md 正文对比，不一致视为可能手改过）→ AskUserQuestion 选全部或部分 → 逐份升级：浅升级（仅 CSS/JS 变化）对旧页替换 `<style>` 块与交互脚本、正文内容原样保留；深升级（DOM 结构变化）从同目录 md 底稿按当前 reference.html 重建，先备份旧版 `.bak-时间戳` → 报告三段式：✅ 已升级清单 / ⚠️ 手改保留说明 / 🟡 失败项原因。模板改动分级：业务改动（板块/段落/标题体系）、数据格式改动（字段/存储结构）、页面改动（样式/布局/交互）任一发生即模板升级，版本戳 +1 并同步 reference.html 与本文档；纯措辞润色不 bump。每次生成 HTML 时顺扫落盘目录读版本戳：发现旧版产物主动告知「技能模板已升级至 vN，检测到 X 份旧版纪要（vN-1 或无版本戳的历史产物），说『把我旧纪要都升级成新样式』即可一键升级」，不让用户背触发语。
+
+## 规则速览
+
+- 五段式骨架行业无关：会议信息（主题/日期/地点/主持人/参会人）/ 会议结论（一句话 TL;DR + 核心决策 2-5 项）/ 议题讨论（议题名 + 结论 + 讨论要点）/ 决议与行动项（事项 + 负责人 + 截止时间，每项三要素齐全）/ 下次会议（主题/时间，没有则写「待定」）
+- **行动项是汇报链源头**：每条行动项必须带负责人与截止时间；日报/周报/月报/季报生成时可直接引用本纪要的行动项作为任务来源
+- 中文顿号序号（1、2、3）；段内无内容写「暂无」；去口语化，保留事实与数字
+- **系列分组落盘**：SERIES_GROUP=auto 时从会议主题提取稳定系列名（去日期词/序号词，如「11月12日产品周例会」→「产品周例会」），落盘确认时报系列名给用户可改口；提取到 → `meetings/{系列名}/`（系列名目录名清洗：非法字符 / \ : * ? " < > | 替换为 -）；未提取到 → 回退月份平铺 `meetings/YYYY-MM/`。说「把我旧纪要按系列整理」→ 扫 meetings/ 下全部 meeting-minutes-* 文件，从文件名 slug 或 md 头部主题提取系列名建目录归置（md/txt/html/png 全套移动），报告三段式：✅ 已整理清单 / ⚠️ 无法归类留在原地的清单 / 🟡 失败项原因；整理前先列移动计划让用户确认，移动后不删空月份目录（留给用户自行处置）
+- **THEME**：html 页面主题，tech 深蓝科技（默认）/ biz 浅色商务 / mono IDEA 黑亮 / light IDEA 白亮 / warm 温暖渐变；生成时写 `<html data-theme="THEME值">` 定默认，页面右下角换肤坞随点随换（localStorage 记忆（键按页内嵌唯一 ID 隔离、多份产物互不串台、改名/移动目录记忆不丢（生成时头部写 `<meta name="minutes-id" content="<UUID>">`，每次 crypto.randomUUID() 生成标准 UUID v4（8-4-4-4-12 十六进制，禁止手写变体、禁止沿用占位与旧值）；落盘写文件前顺扫落盘目录下本技能命名的 html，读各文件 id meta 查重，撞号重掷至不重复））、?shot 截图模式与打印隐藏）
+- 会议类型按 `resources/meeting-type-dictionary.md` 词典取要素侧重与行动项模板（未提类型按 ROLE 画像推断，推断不出用通用模板）
+- 完整规则（要素提取 / 素材来源 / 写作风格约束 / 使用提示）见 `resources/content-rules.md`

package/meeting-minutes/resources/content-rules.md

@@ -0,0 +1,57 @@
+# 内容规则（五段式）
+
+五段式骨架行业无关（任何行业、任何类型会议通用），要素侧重与行动项模板由会议类型词典适配。
+
+## 会议要素提取
+
+- 会议日期：优先用户口述（今天的会/昨天的会/上周三的会 → 按当前系统日期换算）；口述未明确时从材料（文件名/文件头/图片中的日期）提取；都无则问用户一句「会议是哪天开的」再生成
+- 会议主题：用户口述或材料标题；无主题时按议题概括（如「XX 项目进度协调会」）
+- 系列名提取（SERIES_GROUP=auto/series 时）：从会议主题中提取稳定系列名——去掉日期词/序号词/单次会议限定词（「11月12日产品周例会」→「产品周例会」；「第3次技术评审」→「技术评审」）；类型词典词（周例会/评审会/复盘会等）可作系列名主体；提取结果落盘确认时报给用户可改口；提取不到 → 无系列名，按 SERIES_GROUP 回退
+- 会议类型：话术含类型词（周例会/评审/复盘/客户会等）→ 按类型词典取要素侧重；未提 → 按 ROLE 画像推断最可能类型；推断不出 → 通用模板
+- 地点/主持人/参会人：口述或材料中有则写全，缺失项写「未提及」；参会人按材料中的姓名如实列，不编造
+- 文件名/目录用会议日期：见 `resources/disk-and-html.md`
+
+## 段结构
+
+**段一 会议信息**
+- 主题 + 日期（精确到日）+ 时间（有则写）+ 地点（有则写）+ 主持人（有则写）+ 参会人（有则列）
+
+**段二 会议结论**
+- 一句话 TL;DR：这次会议拍板的核心结论（如「双周聚合发布节奏正式确认，单批 ≤6 版本，11-25 前完成验证前置改造」）
+- 核心决策 2-5 项：会上明确的决定（定方案/定时间/定指标/定分工），每条一句话
+
+**段三 议题讨论**
+- 按议题逐个写：议题名 + 结论（该议题达成的共识或决定，未决则写「未决」+ 待办去向）+ 讨论要点 2-4 条（各方观点与关键事实，去口语、留数字）
+- 议题 3-8 个为宜；口头闲聊/寒暄不写
+
+**段四 决议与行动项**
+- 每项三要素：事项（做什么，动词开头）+ 负责人（@某人或「待定」）+ 截止时间（YYYY-MM-DD 或「待定」）
+- 负责人/截止时间缺失时写「待定」并在对话末尾提示用户补充，不编造
+- 按截止时间先后排序；本段是汇报链源头——日报/周报/月报/季报生成时直接引用本纪要行动项
+
+**段五 下次会议**
+- 时间（如 2026-11-18 周三 14:00）+ 主题 + 地点（有则写）；均未知写「待定」
+
+## 写作风格
+
+- 中文顿号序号（1、2、3），段内条目数按上述区间；不足处写「暂无」
+- 去口语化：删除「嗯/那个/然后」等口头词，保留事实、数字与结论；发言要点改第三人称陈述句
+- 结论先行：每个议题先给结论再给讨论过程；数字与时间原样保留
+- 客观中立：纪要不是总结，不掺入生成者评价；不同意见并列呈现，不偏袒
+- 五问自检：①议题是否逐条有结论？②行动项是否三要素齐全？③数字与时间是否如实？④口语是否去净？⑤不同意见是否都记了？任一不过，改写后再输出
+- md/txt 正文含生成时间行（精确到时分秒，如 2026-11-12 19:10:38）
+
+## 素材来源
+
+- 会话口述：用户直接口述会议过程（「会上说了三件事…」）逐条记录
+- 文字材料：用户贴的会议文字/聊天记录，按五段归类
+- 文件：md/txt 直接 Read 文本；docx/pdf 优先尝试 pandoc 转文本（无 pandoc 则请用户粘贴文字）；录音/视频文件不能直接解析——提示用户提供转写文本，或引导用户口述要点
+- 图片：逐张 Read 识别（会议白板/聊天截图/议程照片），提取会议要素与议题；图片模糊/内容读不清时：先把已提取部分展示给用户确认或补充，不瞎编没读到的内容
+- DATA_SOURCES 清单中 type: file 的文件 Read 全文、目录逐个 Read 文本文件提取要点（二进制跳过、路径无效静默跳过）；未知 type 忽略该项并在生成时提示
+- 素材不足的段写「暂无」并提示用户可补充素材
+
+## 纯文字模式与汇报链联动
+
+- 纯文字/图片/文件整理模式：用户提供什么用什么，按五段结构归类
+- 汇报链联动：本纪要的行动项是日报/周报/月报/季报的任务素材源头——生成日报等报表时，若 DATA_SOURCES 或用户素材中含会议纪要文件，其行动项可直接列为任务/进度来源；反之，生成纪要时可引用已有报表中的进度数据作为议题事实依据
+- 同一会议重复生成默认覆盖；说「保留之前的/另存」→ 文件名追加时间戳

package/meeting-minutes/resources/disk-and-html.md

@@ -0,0 +1,26 @@
+# 落盘与 HTML（会议纪要版式）
+
+> ⛔ **Reference 铁律（最高优先）**：本目录 `reference.html` 是定稿样式源码。生成 HTML 时必须先 Read `resources/reference.html` 与本文件两份，以 reference.html 为骨架模板逐处替换数据（标题/日期/五段条目/TL;DR 摘要/决策列表/议题卡/行动项表格行/下次会议卡），本文件的描述是参数解释、变体规则与禁止项；两者冲突时**以 reference.html 为准**。修改本 skill 的 HTML 效果时，必须同步更新 `resources/reference.html` 与本文档的对应描述，禁止只改一处。
+
+> HTML 视觉体系与日报/周报/月报/季报/年报同源（深蓝面板 + 五主题令牌 + 发光特效 + 复制按钮 + 换肤坞 + 截图模式），生成时以 reference.html 为唯一样式真相源，本文件只列会议纪要版式差异与要点。
+
+## 落盘
+
+- FORMATS 默认 [md, txt, html, content-png]：md/txt/html 文件名 `meeting-minutes-YYYY-MM-DD-{主题slug}.<格式>`（主题 slug 用简洁英文或拼音，如 spec-release；无主题时省略 slug 段：`meeting-minutes-YYYY-MM-DD.html`）、截图 `meeting-minutes-YYYY-MM-DD-{主题slug}-content.png`；txt 为纯文本版；DISK: false 时全部不落盘
+- 目录：按 SERIES_GROUP 规则（auto/series/off，见 user-config.md）——auto（默认）从会议主题提取稳定系列名（去日期词/序号词：产品周例会/技术评审/客户会议），提取到则 `{DIR}/meetings/{系列名}/`；未提取到回退 `{DIR}/meetings/YYYY-MM/` 月份平铺（DIR 按系统取 DIR_MAC/DIR_WIN，不存在回退用户主目录下 reports）；目录已存在直接复用，只覆盖本清单内同名文件；目录内存在非本 skill 命名的其它文件时对话中提示用户「该目录内已有其它文件，本次会议纪要已与它们并列存放，未做任何改动」
+- 系列名落盘确认时报给用户（「本次归入系列目录『产品周例会/』」），用户可改口：说「这个系列叫 XX」→ 当次用新名建目录；说「以后这个系列叫 XX」→ 永久记住该系列名（写入 user-config.md 的 SERIES_GROUP 注释旁，后续同主题会议沿用）；系列目录名清洗：非法字符 / \ : * ? " < > | 替换为 -，首尾空格去掉
+- 一次性整理指令：用户说「把我旧纪要按系列整理」→ 扫 `{DIR}/meetings/` 下全部 `meeting-minutes-*` 文件（含月份平铺目录内与已建系列目录内的）→ 从文件名 slug 或读 md 头部主题提取系列名 → 列移动计划（从哪 → 到哪，md/txt/html/png 全套）AskUserQuestion 确认 → 移动归置 → 报告三段式：✅ 已整理清单 / ⚠️ 无法归类留在原地的清单 / 🟡 失败项原因；移动后不删空月份目录（留给用户自行处置）；整理只移动不改内容
+- 对话中照常输出 md 正文（不受 FORMATS 影响）；OPEN_HTML: true 且落盘了 html 时自动打开浏览器（macOS：open <html文件>；Windows PowerShell：Start-Process <html文件>）
+- FORMATS 含 content-png 时生成内容区截图：只截五张分节卡片整体（会议信息/会议结论/议题讨论/决议与行动项/下次会议，不含头部标题区/复制按钮/页脚，四周保留对称合适的外边距约 40px 留白）；html 内置 `?shot=content` 参数（页面 JS 检测后隐藏 header-card/footer、body 四周 padding 统一 40px，正常浏览不受影响）；用 Chrome headless 访问带参 URL 截图（路径按系统选：macOS=`/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`；Windows 按序探测 `C:\Program Files\Google\Chrome\Application\chrome.exe` → `C:\Program Files (x86)\Google\Chrome\Application\chrome.exe` → `%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`，经 node child_process 执行 `--headless --disable-gpu --no-sandbox --hide-scrollbars --user-data-dir=<临时目录> --screenshot=<png路径> --window-size=760,<估算高度> --virtual-time-budget=4000 "file:///<html路径>?shot=content"`（Windows 下 URL 写作 file:///C:/...，用 node url.pathToFileURL 生成），跑完删除临时目录；禁止用 `--headless=new`（单例模式会静默失败生成占位图）；若 Chrome 不存在则换 Edge，都找不到时跳过截图并在对话注明）；高度估算基准（760 宽窄窗实测：信息头 6 行 → 议题 3 卡 → 行动项 5 行表 → 下次会议卡 → 内容区约 1650px，图高 = 内容区 + 上下留白各 40px）：每增减 1 个议题卡 ±~90、1 行行动项 ±~46、1 项决策 ±~34、信息头每多一行 ±~26；实测高度显著高于按 65~70px/条的旧估算，禁止低估导致截断，截图后用 Read 校验：五张卡片整体完整在图内、无头部/按钮/页脚残留、四周留白对称合适、不截断；底部留白过大减高度、截断加高度重截
+
+## HTML 会议纪要版式要点（基于 reference.html）
+
+- 头部卡片：标题「{主题}会议纪要」（主题缺失则「{日期} 会议纪要」）+ 副标题（日期 + 周几 + 起止时间 + 地点，未知项省略）+ 类型徽章（周例会/项目评审/复盘会等，按会议类型词典取词）
+- 信息头节（sec-info）：两列网格（.info-grid：左列 11px muted 标签 时间/地点/主持人/参会人，右列 13px 正文；参会人用 12px chips 胶囊横排，其余值纯文本）；无内容行省略
+- 复制按钮（.copy-wrap）：位于头部卡片内（标题/副标题/类型徽章之后），与日报/周报/月报/季报/年报同款「卡片内一键复制」，青色渐变胶囊居中
+- 结论节（sec-sum）：一句话 TL;DR 引言行（同报表族 .tldr-line）+ 核心决策 2-5 条（.decision-row：青色小圆点 + 决策文案 14.5px）
+- 议题节（sec-top）：议题卡 3-8 张（.topic-card：议题名 15px 加粗 accent 色 + 结论行「结论：」badge 样式（已决：淡青底青字；未决：淡橙底橙字）+ 讨论要点 12.5px muted 每行以青点引导）
+- 行动项节（sec-act）：三列表格（.act-table：表头 事项/负责人/截止时间/状态 11px muted；行动项行 13.5px；负责人 .owner 胶囊（「待定」橙色胶囊）；截止时间 12.5px 等宽；状态徽章 .st：已完成 --green 绿底、进行中 --accent 青底、待办 muted 灰底）；行数 3-10，超 10 行拆两组或合并
+- 下次会议节（sec-next）：信息行（时间 + 主题 + 地点，用 .next-line 与 muted 标签列）；均未知写「待定」
+- 页脚 10px muted 文字，署名固定 GENERATED BY AI TEAM · <日期>
+- 五段分节列表，条目保持中文顿号序号；md/txt 版同条目依次写，文本格式不变

package/meeting-minutes/resources/meeting-type-dictionary.md

@@ -0,0 +1,24 @@
+# 会议类型词典
+
+五段式骨架对所有会议通用，只有「要素侧重 / 议题侧重 / 行动项模板」随会议类型切换。用户话术中声明会议类型即按词典取侧（如「整理昨天项目评审会的纪要」→ 项目评审词条）；未提类型按 ROLE 画像推断，推断不出用通用模板。
+
+| 类型 | 信息头侧重 | 议题侧重 | 行动项模板 |
+|---|---|---|---|
+| 周例会 | 主持人 + 参会人 + 上周回顾 | 各人上周进度/本周计划/风险阻塞 | 「XX 跟进 YY 修复，负责人：张三，截止 2026-11-14」 |
+| 项目评审 | 评审人 + 被评审人 + 里程碑节点 | 方案取舍/风险识别/评审结论（通过/有条件通过/不通过）| 「XX 按评审意见修订方案，负责人：张三，截止 …」 |
+| 需求评审 | 产品 + 研发 + 测试三方 | 需求范围确认/边界与例外/优先级 | 「XX 需求补充验收标准，负责人：张三，截止 …」 |
+| 技术方案评审 | 方案主讲人 + 评审组 | 架构选型/技术债/性能与安全 | 「XX 方案补充压测数据，负责人：张三，截止 …」 |
+| 复盘会 | 复盘对象（项目/事故/活动）| 目标回顾/结果对比/根因分析/改进措施 | 「XX 输出复盘文档并同步全组，负责人：张三，截止 …」 |
+| 客户会议 | 客户方 + 我方参会人 | 客户诉求/交付承诺/合同与回款 | 「XX 客户诉求 48 小时内书面回复，负责人：张三，截止 …」 |
+| 跨部门协调会 | 各部门代表 | 职责边界/接口约定/时间对齐 | 「XX 部门确认接口字段，负责人：张三，截止 …」 |
+| OKR 对齐会 | 各团队负责人 | 目标对齐/关键结果/依赖排期 | 「XX 团队输出 OKR 拆解表，负责人：张三，截止 …」 |
+| 全员会 | 主讲人 + 发布事项 | 公司动态/政策宣贯/表彰 | 「XX 同步宣讲材料到全员群，负责人：张三，截止 …」 |
+| 设计评审 | 设计师 + 产品 + 研发 | 视觉规范/交互流程/走查问题 | 「XX 按意见修改设计稿 V2，负责人：张三，截止 …」 |
+| 合同谈判 | 双方谈判人 | 条款分歧/让步底线/签约时间 | 「XX 修订合同第 N 条并发对方确认，负责人：张三，截止 …」 |
+| 面试复盘 | 面试官 + HR | 候选人评价/录用建议/薪资范围 | 「XX 推进背调与 Offer 流程，负责人：张三，截止 …」 |
+
+- 通用模板（类型不明）：要素侧重 = 主题/日期/参会人；议题侧重 = 议程顺序；行动项模板 = 「XX 事项，负责人：张三，截止 YYYY-MM-DD」
+- 触发：话术含类型词（周例会/例会/评审/复盘/客户会/协调会/对齐会/全员会/谈判/面试等）→ 信息头侧重、议题侧重、行动项话术全部按该词典词条生成
+- 临时指定：说「按项目评审会的格式记」→ 当次按该词条生成，不改配置
+- 兜底：词典外的会议类型（读书会/培训会/家长会等）→ 骨架 + 用户素材现场生成侧重，本次生效；说「记住这类会」→ 固化为新词条
+- 会议类型只换要素侧重与行动项模板，五段骨架/HTML 样式/落盘规范全部不变；优先级：临时指定 > 话术类型词 > ROLE 画像推断 > 通用模板