codewave-openclaw-installer 1.0.1 → 2.1.0

package/index.js

@@ -0,0 +1,21 @@
+/**
+ * CodeWave Toolkit — OpenClaw Extension
+ *
+ * 纯 Skills 插件，不注册 channel 或 tool。
+ * Skills 通过 openclaw.plugin.json 的 "skills" 字段自动加载。
+ */
+
+import { emptyPluginConfigSchema } from 'openclaw/plugin-sdk';
+
+const plugin = {
+  id: 'codewave-toolkit',
+  name: 'CodeWave Toolkit',
+  description: '网易智企 CodeWave 低代码平台 OpenClaw 工具集',
+  configSchema: emptyPluginConfigSchema(),
+  register(_api) {
+    // 纯 skills 插件，无需注册 channel/tool
+    // Skills 由 openclaw.plugin.json 中的 "skills" 字段声明，OpenClaw 自动加载
+  },
+};
+
+export default plugin;

package/openclaw.plugin.json

@@ -0,0 +1,11 @@
+{
+  "id": "codewave-toolkit",
+  "name": "CodeWave Toolkit",
+  "description": "网易智企 CodeWave 低代码平台 OpenClaw 工具集：验收文档、PMO 周报、PoPo 集成、智能客服、音视频转写、腾讯会议",
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -1,13 +1,36 @@
 {
   "name": "codewave-openclaw-installer",
-  "version": "1.0.1",
-  "description": "CodeWave OpenClaw 一键安装器：飞书绑定 + 智能客服 Skill",
+  "version": "2.1.0",
+  "description": "网易智企 CodeWave OpenClaw 扩展：Skills + CLI 依赖一键安装",
+  "type": "module",
+  "main": "index.js",
   "bin": {
-    "codewave-install": "bin/install.mjs"
+    "codewave-install": "bin/install.mjs",
+    "codewave-check": "bin/check.mjs"
   },
   "files": [
+    "index.js",
     "bin/",
-    "skills/"
+    "skills/",
+    "openclaw.plugin.json"
   ],
-  "type": "module"
+  "peerDependencies": {
+    "openclaw": "*"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "codewave",
+    "netease",
+    "acceptance",
+    "pmo",
+    "popo"
+  ],
+  "author": "tolerye <1519947195@qq.com>",
+  "license": "MIT"
 }

package/skills/acceptance-doc-entry/SKILL.md

@@ -0,0 +1,289 @@
+---
+name: acceptance-doc-entry
+description: >
+  项目验收文档生成。基于 razel-py-cli acceptance-toolkit CLI（5 个命令）。
+
+  **当以下情况时使用此 Skill**：
+  (1) 用户提到"验收"、"验收文档"、"验收报告"、"项目验收"、"acceptance"
+  (2) 用户上传验收模板（DOCX），需要解析模板结构
+  (3) 用户上传素材文件，需要自动填充验收文档
+  (4) 需要生成验收草稿、修订草稿、定稿
+---
+
+# Acceptance Doc Entry
+
+## 安装
+
+```bash
+pip install razel-py-cli
+razel-py-cli init    # 首次使用前执行，生成 ~/.razel/config.json
+```
+
+## CLI 入口
+
+```bash
+razel-py-cli acceptance-toolkit <command>
+```
+
+## 命令速查
+
+| 命令 | 必填参数 | 说明 |
+|------|---------|------|
+| `parse-template` | `--template <PATH>` | 解析模板结构，创建任务目录 |
+| `plan` | `--task-dir <DIR> --materials <M1> [M2...]` | 解析素材 + LLM 语义映射 |
+| `build` | `--task-dir <DIR>` | 生成草稿 DOCX |
+| `revise` | `--task-dir <DIR> --add-materials <M1> [M2...]` | 追加素材 → 重新 plan → 重新 build |
+| `finalize` | `--task-dir <DIR> --confirmed` | 生成正式版（清理草稿标记） |
+
+可选参数：`parse-template` 支持 `--task-id <ID>` 指定任务标识。
+
+## 命令详细用法
+
+### 1. parse-template — 解析模板
+
+```bash
+razel-py-cli acceptance-toolkit parse-template --template <TEMPLATE.docx> [--task-id <ID>]
+```
+
+行为：
+- 自动创建任务目录，输出 `task-dir=<path>` 到 stdout
+- 检测纯目录模板（只有 TOC 样式、无正文 heading）→ 自动重建标准模板
+- 保存 `template.original.docx`（原始）和 `template.docx`（生效版）到 `input/`
+- result.json 的 `template_summary.template_mode` 为 `"rebuilt_from_toc"` 或 `"original"`
+
+### 2. plan — 解析素材 + 映射
+
+```bash
+razel-py-cli acceptance-toolkit plan --task-dir <TASK_DIR> --materials <M1.docx> <M2.docx>
+```
+
+行为：
+- 复制素材到 `input/material-001.docx`, `material-002.docx`, ...
+- 解析素材章节结构、提取段落/表格/图片的 ContentBlock
+- 调用 LLM 做语义映射（模板章节 → 素材章节）
+- 输出 5 种映射策略：`direct` / `merge` / `rewrite` / `generate` / `manual`
+- LLM 调用失败时自动重试一次；两次都失败则 `status=needs_llm_fallback`
+
+**strategy 说明**：
+
+| 策略 | 含义 | LLM 参与 |
+|------|------|---------|
+| `direct` | 素材内容可基本原样使用 | 否 |
+| `merge` | 合并多个素材章节 | 是（整合） |
+| `rewrite` | 有相关素材但需改写适配模板风格 | 是（改写） |
+| `generate` | 无直接对应素材，可从全文上下文综合生成（引言/概述/总结类） | 是（生成） |
+| `manual` | 无相关内容且无法推断（签字盖章、真实截图、合同原始数据） | 否 |
+
+### 3. build — 生成草稿
+
+```bash
+razel-py-cli acceptance-toolkit build --task-dir <TASK_DIR>
+```
+
+行为：
+- 基于模板 + 映射计划 + 素材内容，生成草稿 DOCX
+- `direct` 策略：复制素材 ContentBlock（保留段落样式、表格、图片）
+- `merge` / `rewrite` / `generate` 策略：调用 LLM 生成文本
+- `manual` 策略：写入"待人工补充"占位
+- 草稿首行插入"【当前版本：待确认草稿】"标记
+- LLM 调用失败时 fallback：rewrite → 降级为 direct+待确认；merge/generate → 降级为拼接+待确认
+
+### 4. revise — 补充素材重新生成
+
+```bash
+razel-py-cli acceptance-toolkit revise --task-dir <TASK_DIR> --add-materials <M3.docx> [M4.docx...]
+```
+
+行为（三步串联）：
+1. **backup** — 备份当前草稿为 `acceptance-doc.draft.prev.docx`
+2. **plan** — 追加新素材到 input，重新解析全部素材，重新 LLM 映射
+3. **build** — 基于新映射重新生成草稿
+
+⚠️ `--add-materials` 是必填参数（没有新素材则 revise 无意义）。
+
+### 5. finalize — 生成正式版
+
+```bash
+razel-py-cli acceptance-toolkit finalize --task-dir <TASK_DIR> --confirmed
+```
+
+行为：
+- 检查任务状态必须为 `draft_generated`
+- 检查必须传 `--confirmed`
+- 清理所有草稿标记（`【当前版本：待确认草稿】`、`[待确认]`）
+- 输出 `acceptance-doc.final.docx`
+
+## 任务目录结构
+
+```
+{task-dir}/
+├── input/
+│   ├── template.original.docx    ← 用户上传的原始模板
+│   ├── template.docx             ← 生效模板（可能是重建的）
+│   ├── material-001.docx
+│   └── material-002.docx
+├── output/
+│   ├── acceptance-doc.draft.docx
+│   ├── acceptance-doc.draft.prev.docx  ← revise 时的旧草稿备份
+│   └── acceptance-doc.final.docx
+├── result.json                   ← Agent 读这个
+├── task.json                     ← 任务状态 manifest
+└── .internals/
+    ├── parse-result.json         ← 模板+素材解析结果
+    ├── plan-output.json          ← 映射计划
+    ├── plan-prompt.txt           ← LLM plan prompt（fallback 时用）
+    └── fill-log.json             ← 填充记录
+```
+
+默认任务根目录：`~/.openclaw/workspace/acceptance-tasks/`
+可通过环境变量 `ACCEPTANCE_TASKS_ROOT` 覆盖。
+
+## result.json 字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `status` | string | `success` / `needs_llm_fallback` / `partial_failure` / `error` |
+| `stage` | string | 当前完成的阶段：`parse-template` / `plan` / `build` / `finalize` |
+| `state` | string | 任务状态：`template_parsed` / `plan_ready` / `draft_generated` / `finalized` |
+| `next_action` | string | 下一步动作（见下表） |
+| `user_prompt` | string | 可直接转述给用户的提示语 |
+| `template_summary` | object | 模板结构摘要（parse-template 阶段） |
+| `section_mappings` | array | 映射计划列表（plan 阶段） |
+| `gap_summary` | object | 缺口统计（plan 阶段） |
+| `manual_sections` | array | 需人工补充的章节名列表 |
+| `document_path` | string | 生成的文档路径（build/finalize 阶段） |
+| `issues` | array | 需要 review 的章节 |
+| `fallback_prompt` | string | LLM fallback 时的 prompt（Agent 可自行调用 LLM） |
+| `error_message` | string | 错误信息 |
+
+**next_action 值**：
+
+| 值 | 含义 |
+|---|---|
+| `provide_materials` | 等待用户提供素材 |
+| `confirm_plan` | 等待用户确认映射计划 |
+| `confirm_draft` | 等待用户确认草稿 |
+| `add_materials` | 建议用户补充素材 |
+| `finalize` | 可以执行 finalize |
+| `retry` | 出错，可重试 |
+| `done` | 流程完成 |
+
+## Agent 编排工作流
+
+```
+1. 收到模板 → parse-template → 读 result.json → 展示模板结构
+2. 记住 task-dir 路径，后续所有命令都用它
+3. 收到素材 → plan → 读 result.json → 展示映射计划 + 缺口 → 等待用户确认
+4. 用户确认映射计划 → build → 读 result.json → 发送草稿文件
+5. 用户补充素材 → plan（追加新素材，重新映射）→ 读 result.json → 展示更新后的映射 → 等待用户确认
+6. 用户确认映射计划 → build → 读 result.json → 发送新草稿
+7. 用户确认草稿 → finalize → 读 result.json → 发送正式版
+```
+
+**⚠️ 关键原则：补充素材时禁止直接使用 `revise`**
+
+`revise` 命令会自动串联 plan + build，跳过用户确认映射的环节。正确做法：
+
+1. 用户补充素材时，使用 `plan --task-dir <DIR> --materials <全部素材文件>`（包含新旧所有素材）
+2. 展示映射计划，等待用户确认
+3. 用户确认后，再执行 `build`
+
+仅当用户明确表示"不需要确认映射，直接生成"时，才可使用 `revise` 一步到位。
+
+**核心原则**：Agent 只做编排调度，不理解文档内容。读 result.json → 跟着 `next_action` 走 → 向用户展示 `user_prompt` + 结构化数据。每次 plan 完成后必须等用户确认再 build。
+
+### needs_llm_fallback 处理
+
+当 `status=needs_llm_fallback` 时：
+1. 读 `.internals/plan-prompt.txt` 获取 LLM prompt
+2. Agent 自行调用 LLM（用 plan prompt）获取 JSON 映射结果
+3. 写入 `.internals/plan-output.json`
+4. 继续执行 `build`
+
+### 超时处理
+
+CLI 命令（尤其 plan 和 build）可能因 LLM 调用时间较长而超时。如果命令被 SIGTERM 杀掉但实际已完成计算：
+1. 检查 `.internals/plan-output.json` 或 `output/acceptance-doc.draft.docx` 是否存在
+2. 如存在，手动更新 `task.json` 的 state，然后继续下一步
+3. 如不存在，重跑该命令
+
+## 阶段门禁
+
+| 命令 | 前置条件 |
+|------|---------|
+| `plan` | state ∈ {template_parsed, plan_ready, draft_generated} |
+| `build` | state ∈ {plan_ready, draft_generated} |
+| `revise` | 需传 --add-materials |
+| `finalize` | state = draft_generated + --confirmed |
+
+## 用户交互模板
+
+### 模板解析后
+
+```
+📋 模板结构（{template_mode}）
+
+共 N 个章节，M 个占位符。
+
+| 章节 | 层级 | 已有内容 |
+|------|------|----------|
+| ... | ... | ✅/❌ |
+
+请发送素材文件继续。
+```
+
+如果 `template_mode=rebuilt_from_toc`，告知用户"检测到纯目录模板，已自动生成标准模板"。
+
+### 映射计划
+
+展示映射表时，必须包含素材文件名信息，让用户清楚每个模板章节对应的是哪份素材的哪个章节。
+
+**获取素材文件名**：
+- 从 `.internals/parse-result.json` 的 `material_file_map` 读取内部素材文件名到原始文件名的映射，例如 `material-001.docx -> 投标方案.docx`
+- 从 `result.json.section_mappings[].source_files` 直接读取每个模板章节对应的原始素材文件名列表
+- `result.json.section_mappings[].sources` 对应素材章节名，`source_files` 对应原始素材文件名，两者按顺序一一对应
+
+**展示格式**：
+
+```
+📋 映射计划（共 N 个章节）
+
+素材文件清单：
+- 📄 素材1：<原始文件名>.docx
+- 📄 素材2：<原始文件名>.docx
+
+| 模板章节 | 素材来源（文件 → 章节） | 处理方式 | 置信度 |
+|----------|------------------------|----------|--------|
+| 引言 | - | 综合生成 | 0.6 |
+| 项目概述 | 素材1 → 系统概述 | 改写 | 0.7 |
+| 接口性能 | 素材1 → 接口管理 + 素材2 → 数据交换 | 合并 | 0.8 |
+| 售后服务 | - | 待人工补充 | 0.0 |
+
+统计：
+- ✅ 直接使用：X 章
+- 🔄 合并/改写：Y 章
+- 🤖 综合生成：Z 章
+- ❌ 待人工补充：W 章
+
+回复"确认"开始生成草稿，或继续补充素材。
+```
+
+**⚠️ 映射表过长时**：仅展示非 generate 策略的章节（即有明确素材对应的章节），generate 策略的章节折叠为统计数字。
+
+strategy 中文显示映射：direct→直接使用、merge→合并、rewrite→改写、generate→综合生成、manual→待人工补充。
+
+## DOCX 约束
+
+- 禁止 Markdown 语法进入 Word（表格用 doc.add_table、列表用 Word 样式）
+- 中文字体必须设 eastAsia（`rFonts.set(qn('w:eastAsia'), '仿宋')`）
+- draft 模式标记"待确认"章节
+- finalize 自动清理所有草稿标记（`【当前版本：待确认草稿】` + `[待确认]`）
+
+## LLM 配置
+
+CLI 按以下优先级查找 LLM 配置：
+1. 环境变量 `ACCEPTANCE_LLM_BASE_URL` + `ACCEPTANCE_LLM_API_KEY` + `ACCEPTANCE_LLM_MODEL`
+2. OpenClaw 配置文件（`~/.openclaw/openclaw.json` → `models.providers`）
+3. 环境变量 `OPENAI_API_KEY`
+
+指定 provider：`ACCEPTANCE_LLM_PROVIDER=<provider_name>`

package/skills/meeting-to-prd/SKILL.md

@@ -0,0 +1,210 @@
+---
+name: meeting-to-prd
+description: "会议聚合PRD：根据需求讨论类会议纪要、逐字稿、POPO链接或腾讯会议链接，按项目隔离管理多次会议记录，增量聚合生成结构化PRD。触发方式：'/m2p' 或自然语言描述会议聚合需求。"
+version: 2.2.1
+metadata:
+  openclaw:
+    emoji: "📋"
+---
+
+# Meeting-to-PRD
+
+需求讨论会议 → 结构化记录 → 增量聚合 PRD。**数据与索引**由 **`razel-cli m2p`**（stdout JSON，无 LLM）；**纪要 / PRD 正文 / 带样式 DOCX** 由 **`razel-py-cli meeting-prd`**（需配置 LLM；`export-docx` 另需本机 **Pandoc**）。Agent 编排两套 CLI 的路径与参数即可。
+
+**依赖**：`pip install razel-py-cli`；LLM 与 `acceptance-toolkit` 相同（`ACCEPTANCE_LLM_*` 或 `~/.openclaw/openclaw.json` → `models.providers` 或 `OPENAI_API_KEY`）。
+
+---
+
+## 关键步骤与产物（务必对齐）
+
+| 产物 | 生成方式 | 关键说明 |
+|------|----------|----------|
+| **`sessionDir/meeting-notes.md`** | `razel-py-cli meeting-prd notes --raw <sessionDir>/raw.md --template <本目录>/references/meeting-notes-template.md --out <sessionDir>/meeting-notes.md` | **唯一素材**：`raw.md`。退出码 **2** = 无需求（内部 C），**不写** `meeting-notes.md`，走 `session-complete --grade C`。退出码 **0** 后再回读校验，再 `session-complete --grade A\|B`（`m2p` 要求 A/B 时目录内须有非空纪要）。 |
+| **`prdDir/<version>_<date>.md`** | `razel-py-cli meeting-prd prd`：多个 `--inputs` 均为各场 **`raw.md` 绝对路径**，顺序 = **时间线**（后覆盖前）；`--template` = [prd-template.md](references/prd-template.md)；`--out` = 目标 md | **禁止**用 `prd-prepare` 的 `meetingNotesText` 在对话里现写 PRD（避免事实分叉）。编排时从 `m2p prd-prepare` JSON 的 **`rawPaths[].path`** 按 `seq` 顺序拼 `--inputs`。 |
+| **`.docx`** | **带版式/样式**：`razel-py-cli meeting-prd export-docx --md <prd.md> --reference <本目录>/references/prd-reference.docx --out <同基名>.docx` | 使用 Pandoc `--reference-doc`。**快速无参考样式**：`razel-cli m2p prd-export --project --version`（同目录 `pandoc` 转 `.docx`，无 reference）。 |
+
+---
+
+## 命令速查
+
+### `razel-cli m2p <子命令> [flags]` → stdout **JSON**
+
+| 命令 | 用途 | 关键参数 |
+|------|------|----------|
+| `project-create` | 新建项目 | `--name` |
+| `project-list` | 列出项目 | — |
+| `project-get` | 项目详情 | `--project` |
+| `project-delete` | 删除项目 | `--project` |
+| `session-create` | 新建 session | `--project` `--title` [`--source` `--url`] → JSON 含 `sessionDir` |
+| `session-complete` | 写入 grade、执行 enforcer | `--project` `--seq` `--grade` `A\|B\|C` [`--notes-file`] |
+| `session-get` | session 详情 | `--project` `--seq` → 含 `sessionDir`、`hasRaw`、`hasNotes` |
+| `session-delete` | 删除 session 目录 | `--project` `--seq` |
+| `prd-prepare` | 可聚合的 A/B session | `--project` → `suggestedVersion`、`prdDir`、`eligibleSessions`、**`rawPaths`**（各场 `raw.md` 路径）、`meetingNotesText`（**仅供浏览/旧习惯，生成 PRD 请用 `rawPaths` + `meeting-prd prd`**） |
+| `prd-save` | 登记版本并落盘 md | `--project` `--version` `--file`（溯源校验会议 `#seq`） |
+| `prd-list` / `prd-get` / `prd-delete` | 版本列表 / 读内容 / 删 md+同基名 docx | `--project`；get/delete 加 `--version` |
+| `prd-export` | md → docx（无 reference） | `--project` `--version`；需 **pandoc** |
+| `verify` | 数据一致性 | — |
+| `prd-analyze-spec` | PRD 文件 → Spec（HTTP 集成） | `--file` `--system-name` [`--language` `--base-url` `--out`] |
+| `spec-design-doc` | Spec → 技术文档（HTTP 集成） | `--spec-text` **或** `--spec-file` [`--language` `--base-url` `--out`] |
+
+集成 URL：`M2P_INTEGRATION_BASE_URL`、`M2P_ANALYZE_SPEC_URL`、`M2P_DESIGN_FROM_SPEC_URL`（见 `razel-cli` 源码 `cmd-integration.ts`）。
+
+### `razel-py-cli meeting-prd <子命令>` → 写文件 + stderr 提示；**非** JSON
+
+| 子命令 | 用途 | 必填参数 |
+|--------|------|----------|
+| `notes` | `raw.md` → 纪要 md | `--raw` `--template` `--out` |
+| `prd` | 多场 `raw.md` → PRD md | 至少一个 `--inputs`，`--template`，`--out` |
+| `export-docx` | md + 参考 docx → Word | `--md` `--reference` `--out` |
+
+---
+
+## 流程
+
+### 来源识别（所有会议的前置步骤）
+
+| 来源 | 识别方式 | 获取元信息 | 下载落盘 |
+|------|----------|-----------|---------|
+| POPO 文档 | URL 含 `docs.popo.netease.com` | `razel-cli popo doc info --url <url> --format json` | `razel-cli popo doc download -u <url> -o <sessionDir> -n raw --json` |
+| 腾讯会议 | URL 含 `meeting.tencent.com` | `razel-cli tencent-meeting sniff -u <url>`（默认 summary，仅获取元信息，不落盘） | `razel-cli tencent-meeting download -u <url> --pick doc -o <sessionDir> -n raw -f md` |
+| 纯文本 | 无 URL | 直接用内容推断项目名 | 直接 write 到 `sessionDir/raw.md` |
+
+拿到元信息后**自动推断项目名**，同时 `project-list` 获取已有项目列表，**两步并行**。
+
+**项目名推断注意事项**：
+- 注意识别可能的字词错误（如"投后"应为"投资"、"管理系"应为"管理系统"）
+- 结合文档内容整体语义进行纠正确认
+- 优先使用行业通用术语
+
+然后根据文档名/内容与已有项目做语义匹配：高匹配 → 简化确认后追加；多候选 → 列出让用户选；无匹配 → 建议新建。
+
+> **⚠️ 元信息用途边界**：sniff / popo doc info 返回的 summary、timeline 等内容**仅用于推断项目名和会议标题**。后续 meeting-notes 与 PRD 的生成**必须且只能**基于落盘的 **`raw.md`**，禁止使用 sniff 的 summary/transcript 作为生成素材。
+
+### 新会议录入
+
+1. **信息收集（⛔ 不创建任何资源）**：
+   - 来源识别 + 获取元信息（sniff / popo doc info）
+   - **并行** `project-list` 获取已有项目列表
+   - 推断项目名 + 会议标题 + 语义匹配已有项目
+
+2. **🔴 用户确认（此步完成前禁止执行 project-create / session-create / download）**：
+   - 向用户展示：推断的项目名、会议标题、匹配到的已有项目（如有）
+   - **等待用户明确回复后再继续**
+   - 用户纠正项目名 → 以用户给出的名称为准
+   - 用户指定已有项目 → 跳过 project-create
+
+3. 新项目：`project-create --name <用户确认的名称>`；已有项目：跳过
+4. `session-create --project <id> --title <title> [--source --url]` → 拿到 `sessionDir`
+5. **下载/写入 raw.md 到 sessionDir**（按来源类型选择）：
+   - **纯文本**：直接 write 到 `sessionDir/raw.md`
+   - **POPO AI纪要**：`razel-cli popo doc download -u <url> -o <sessionDir> -n raw --json`（直接落盘为 `sessionDir/raw.{ext}`；若产物非 .md，用 `markdown-converter` 转为 raw.md）
+   - **POPO 视频**：下载音视频到 sessionDir → `speed-to-text` 转写 → raw.md
+   - **腾讯会议**：`razel-cli tencent-meeting download -u <url> --pick doc -o <sessionDir> -n raw -f md`（直接落盘为 `sessionDir/raw.md`）；若无 doc 则 `download`（默认 video）下载视频 → `speed-to-text` 转写 → raw.md
+6. **分析 raw.md 并生成 meeting-notes**（必须严格按 6a → 6b → 6c → 6d 顺序执行）：
+
+   > **⛔ 硬性约束**：纪要内容的**唯一输入源**是 `sessionDir/raw.md`。
+
+   **6a. 读取 raw.md**：使用 `read` 工具读取 `sessionDir/raw.md` 全文。
+
+   **6b. 生成 meeting-notes.md**：执行 **`meeting-prd notes`**（见上文「关键步骤与产物」表），模板用 [meeting-notes-template.md](references/meeting-notes-template.md)。**禁止**仅在对话中自由撰写代替该命令。
+
+   **6c. 回读 meeting-notes 并判定等级**（仅当 6b 退出码为 0）：使用 `read` 读取 `meeting-notes.md`，检查需求清单：
+   - 需求清单有 ≥1 条明确需求，且讨论要点围绕需求展开 → **完整需求讨论**（内部 A）
+   - 需求清单有 ≥1 条需求，但主内容非需求讨论 → **部分需求内容**（内部 B；可删无关议题后重跑 `notes`）
+   - 需求清单为空 → **非需求讨论**（内部 C，删除 `meeting-notes.md`）
+
+   **6d. 提交等级**：
+   - A/B：`session-complete --grade X`
+   - C：`session-complete --grade C`（若 6b 已返回退出码 2，通常尚无 `meeting-notes.md`，与此一致）
+
+7. 展示结果摘要 → 询问是否聚合 PRD
+
+### 超长会议处理
+
+当 raw.md > 50KB 时，`meeting-prd notes` 可能需要 3-8 分钟。Agent 应：
+
+1. **后台执行**：使用 `exec` 并设置 `timeout: 600`（10 分钟）
+2. **通过 `process log` 监控进度**：每 60 秒 poll 一次 stderr
+   - 看到 `⏳ [N/4]` 进度输出 → 正常推进，继续等待
+   - 连续 3 分钟无任何新输出 → kill 进程并走降级方案
+3. **降级方案**：若命令失败或超时，Agent 自行基于 raw.md 按 [meeting-notes-template.md](references/meeting-notes-template.md) 生成纪要
+   - 在 meeting-notes.md 头部追加注释 `<!-- generated-by: agent-fallback -->`
+   - 正常执行后续 `session-complete --grade A|B`
+
+### PRD 聚合
+
+1. `prd-prepare --project <id>` → 取 `suggestedVersion`、`prdDir`、**`rawPaths`**（勿用 `meetingNotesText` 生成 PRD）。
+2. `razel-py-cli meeting-prd prd --inputs <raw1> --inputs <raw2> ... --template <本目录>/references/prd-template.md --out <prdDir>/<version>_<date>.md`（`rawPaths` 顺序即 `--inputs` 顺序）。
+3. `prd-save --project <id> --version <v> --file <上一步 out>`。
+4. 导出 Word：优先 **`meeting-prd export-docx`** + [prd-reference.docx](references/prd-reference.docx)；或 **`m2p prd-export`**（无样式参考）。
+
+### 重新分析
+
+重跑 **`meeting-prd notes`**（覆盖 `meeting-notes.md`）→ 再 `session-complete`。
+
+### 删除
+
+展示待删信息 → 🔴 用户确认 → `session-delete` / `project-delete`。
+删除 A/B 级 session 后提示是否重新聚合 PRD。
+
+## 等级规则
+
+| 等级 | 含义 | 判定 | 产出 |
+|------|------|------|------|
+| A | 需求讨论 | 核心讨论「要做什么」（新需求/方案选型/验收约定） | meeting-notes.md（完整 4 区块） |
+| B | 混合型 | 主内容非需求但夹带需求变更/决策 | meeting-notes.md（仅需求部分；需求清单为空 → 降为 C） |
+| C | 非需求 | 进展汇报/周会/复盘/无需求信息 | 仅保留 raw.md，不生成 meeting-notes |
+
+**关键约束**：先 **`raw.md` → `meeting-prd notes` → 回读纪要** 再定级；禁止仅凭标题或 sniff 预判。
+
+**强制规则（`m2p` enforcer）**：C 级目录无 `meeting-notes.md`；A/B 须有非空纪要。
+
+## 交互规则
+
+### 确认级别
+- 🔴 必须确认：项目名（新建）、删除操作
+- 🟡 建议确认：目标项目（高匹配时简化）、是否聚合 PRD
+- 🟢 自动处理：文件夹命名、编号、索引更新、等级判断
+
+### 非需求文档（C 级）处理
+
+`meeting-prd notes` 退出码 **2** 或回读后无需求时：归档 `session-complete --grade C` / 重跑 `notes` / `session-delete`。
+
+### 输出规范
+- 完成时给有价值的摘要（需求数、行动项、模块分组）
+- 不暴露内部术语（A/B/C、session 编号、脚本路径）
+- 耗时操作给进度反馈（⏳ 下载中… / 📥 就绪，分析中… / 📊 生成 PRD…）
+- 发送文件后不赘述
+
+#### 等级表述转换（内部→外部）
+| 内部等级 | 用户可见表述 |
+|----------|--------------|
+| A | "本次讨论聚焦需求，已提取完整记录" |
+| B | "本次讨论包含部分需求，已提取相关内容" |
+| C | "本次非需求讨论，仅归档备查" |
+
+**禁止直接向用户输出"A级"、"B级"、"C级"等内部标识。**
+
+## 数据目录
+
+```
+~/.openclaw/meeting-records/
+├── index.json
+├── project_001_{name}/
+│   ├── project.json
+│   ├── sessions/
+│   │   ├── 001_{date}_{time}_{title}/
+│   │   │   ├── raw.md          ← 唯一事实源（纪要 + PRD 生成均以此为准）
+│   │   │   └── meeting-notes.md ← A/B 级产出
+│   │   └── ...
+│   └── prd/
+│       └── v1.0_{date}.md
+```
+
+## 参考文档
+
+| 文档 | 用途 |
+|------|------|
+| [meeting-notes-template.md](references/meeting-notes-template.md) | 纪要结构；作 `meeting-prd notes --template` |
+| [prd-template.md](references/prd-template.md) | PRD 结构；作 `meeting-prd prd --template` |
+| [prd-reference.docx](references/prd-reference.docx) | Word 样式；作 `meeting-prd export-docx --reference` |

package/skills/meeting-to-prd/references/meeting-notes-template.md

@@ -0,0 +1,50 @@
+# 会议记录模板
+
+大模型在分析 raw.md 后，按此结构生成 meeting-notes.md。
+
+## 结构
+
+```markdown
+# 会议记录：{会议主题}
+> 项目 {项目名称} | 序号 #{NNN} | 日期 {YYYY-MM-DD} | 参会 {人员/待补充} | 来源 {链接/文本}
+
+## 讨论要点
+### {议题名称}
+- 要点1
+- 要点2
+> 决策：{内容} — {决策人} [原文: 「XXX」]
+> 遗留：{问题}
+
+## 需求清单
+| ID | 需求名称 | 优先级 | 提出人 | 描述 | 状态 |
+|----|----------|--------|--------|------|------|
+| R1 | xxx      | P0/P1/P2 | 姓名/待确认 | 描述 | 新增/变更 |
+
+## 行动项
+| # | 类型 | 描述 | 负责人 | 截止 | 优先级 |
+|---|------|------|--------|------|--------|
+| 1 | 📌任务/⚠️风险/❓待确认 | 描述 | 姓名/待分配 | 日期/待确认 | P0/P1/P2 |
+
+## 参考资料
+- {如有}
+```
+
+## 等级与提取规则
+
+### A 级（需求讨论）
+- 完整提取全部 4 个区块
+- 每条需求、每条行动项必须标注原文出处：`[原文: 「XXX」]`
+
+### B 级（混合型，夹带需求）
+- 仅提取需求相关议题
+- 需求清单为空 → 降级为 C，不生成 meeting-notes
+- 同样要求原文出处标注
+
+### C 级（非需求）
+- **不生成 meeting-notes.md**
+
+### 通用规则
+- 负责人不确定时标「待分配」
+- 截止日不明确时标「待确认」
+- 可推断处标 `【推断】`
+- 关键信息标注原文出处