codewave-openclaw-installer 1.0.2 → 2.1.1

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

@@ -0,0 +1,67 @@
+# PRD 模板
+
+大模型在聚合多次会议记录后，按此结构生成 PRD markdown。
+
+## 结构
+
+```markdown
+# 产品需求文档：{产品/功能名称}
+
+## 文档信息
+| 项目 | 内容 |
+|------|------|
+| 版本 | v{X.Y} |
+| 更新日期 | YYYY-MM-DD |
+| 基于会议 | #001, #002, ... |
+| 状态 | 草稿 |
+
+## 1. 概述
+### 1.1 背景与问题
+{为什么做} [来源: 会议#NNN, YYYY-MM-DD]
+
+### 1.2 目标
+- 目标1 [来源: 会议#NNN, YYYY-MM-DD]
+
+### 1.3 范围
+**包含：** ... | **不包含：** ...
+
+## 2. 功能需求
+### 2.1 需求总览
+| ID | 功能模块 | 需求名称 | 优先级 | 来源 | 状态 |
+
+### 2.2 {需求名称}
+**问题/动机：** [来源: 会议#NNN, YYYY-MM-DD]
+**方案描述：** [来源: 会议#NNN, YYYY-MM-DD]
+**验收标准：**
+- [ ] {标准} 【推断】
+**约束与依赖：** {如有}
+> **变更记录**（多次讨论同一需求时）:
+> - 会议#001: {原始描述}
+> - 会议#003: {变更内容} [最终决策]
+
+## 3. 行动项与排期
+| # | 任务 | 负责人 | 截止 | 优先级 | 来源 | 状态 |
+
+## 4. 风险与依赖
+| 类型 | 描述 | 等级 | 应对措施 | 来源 | 状态 |
+
+## 5. 已排除需求（如有）
+| 需求 | 排除原因 | 来源 |
+
+## 变更记录
+| 版本 | 日期 | 来源 | 变更概要 |
+
+## 附录
+### 参考资料
+### 术语表（无术语时跳过）
+```
+
+## 强制规则
+
+1. **溯源**：每条需求、决策、行动项必须标注 `[来源: 会议#NNN, YYYY-MM-DD]`
+2. **唯一事实来源**：所有内容只从 meeting-notes.md 提取，不编造
+3. **冲突解决**：同一需求多次讨论，以最后一次会议为准，标注变更记录
+4. **无法溯源的内容**：标记 ⚠️ 或删除
+5. **验收标准**：优先从会议原文中提取明确的验收要求；仅当会议有具体讨论但未明确验收条件时，可补充并标注 `【推断】`；若整条需求的验收标准全部为推断（即会议中完全未讨论验收），则不逐条列举推断，直接写 `**验收标准：** 待需求确认后补充`，避免将方案描述换个说法重复一遍
+6. **无内容章节跳过不生成**
+7. **版本号规则**：v1.0 首次全量 → v1.1/v1.2 增量 → v2.0 全量重聚合

package/skills/pmo-weekly-report/SKILL.md

@@ -0,0 +1,536 @@
+---
+name: pmo-weekly-report
+description: PMO 项目看板周报。从各类周报来源（PoPo文档、飞书文档、PDF、聊天记录、网页、原始文本）解析为结构化看板，渲染为按 section 拆分的富文本模块，并按渠道发送（PoPo / 飞书 / 钉钉）或直接输出。
+---
+
+# PMO Weekly Report（项目看板周报）
+
+## Purpose
+
+从各种格式的周报输入中，完成 **输入归一化 → 信息抽取 → 看板建模 → 富文本渲染 → 多渠道发送** 的端到端流程。
+
+## Pre-flight Checks
+
+执行前按 `send_channel` 验证对应依赖，缺失则列出并停止：
+
+```bash
+# 始终需要
+jq --version
+
+# DOCX 解析（至少一个可用）
+pandoc --version || textutil -help || python3 -c "import docx"
+
+# send_channel=popo 或 source_type=popo_doc 时
+razel-cli --version
+
+# send_channel=dingtalk 时
+# dingtalk-cli --version  （待接入，预留）
+```
+
+## Inputs
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `source_type` | string | 否，默认 `auto` | `popo_doc` / `feishu_doc` / `pdf_doc` / `chat_log` / `web_page` / `raw_text` / `auto` |
+| `source_ref` | any | **是** | 来源引用（URL、文档ID、文本内容、聊天记录数组等） |
+| `send_channel` | string | 否，默认 `none` | `popo` / `feishu` / `dingtalk` / `none` |
+| `send_target` | string/object | 当 `send_channel != none` 时必填 | 发送目标（格式见 Phase 4） |
+| `options` | object | 否 | 可选配置 |
+
+### options 字段
+
+| 字段 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `return_json_only` | boolean | false | 若为 true，只输出 kanban_model，跳过渲染和发送 |
+| `include_raw_snippets` | boolean | false | 是否在看板卡片中包含原始文本片段 |
+
+## Outputs
+
+```json
+{
+  "rendered_sections": [ ... ],
+  "section_count": 6,
+  "resolved_source_type": "popo_doc",
+  "data_source_label": "PoPo文档 - 2026年2月交付团队周报",
+  "send_result": {
+    "channel": "popo",
+    "sections_sent": 6,
+    "sections_failed": 0,
+    "success": true,
+    "details": [ ... ],
+    "errors": []
+  },
+  "success": true,
+  "errors": []
+}
+```
+
+当 `send_channel = "none"` 时，`send_result` 为 `null`，只输出 `rendered_sections`。
+
+---
+
+## Phase 1: 输入归一化
+
+### 来源类型自动检测（source_type=auto）
+
+```
+source_ref 是数组？ → chat_log
+source_ref 是字符串？
+  └─ 包含 docs.popo.netease.com → popo_doc
+  └─ 包含 feishu.cn 或 larksuite.com → feishu_doc
+  └─ 以 .pdf 结尾 → pdf_doc
+  └─ 以 http:// 或 https:// 开头 → web_page
+  └─ 其他 → raw_text
+```
+
+### 各来源处理方式
+
+#### popo_doc
+
+```bash
+# 1. 下载（默认输出到 ~/.razel/popo/doc-output/）
+razel-cli popo doc download -u "<URL>" -o /tmp/popo-downloads --json
+
+# 2. DOCX → 文本（按优先级尝试）
+# 优先: pandoc
+pandoc "/tmp/xxx.docx" -t markdown --wrap=none -o /tmp/xxx.md
+
+# macOS fallback: textutil
+textutil -convert txt "/tmp/xxx.docx" -stdout
+
+# Python fallback: python-docx
+python3 -c "
+import docx
+doc = docx.Document('/tmp/xxx.docx')
+for p in doc.paragraphs:
+    print(p.text)
+for t in doc.tables:
+    for row in t.rows:
+        print('\t'.join(c.text for c in row.cells))
+"
+```
+
+#### feishu_doc
+
+使用 `feishu_fetch_doc` 工具获取文档内容。
+
+#### web_page
+
+使用 `web_fetch` 工具获取页面 markdown 内容。
+
+#### chat_log
+
+若为数组，按 timestamp 排序，转换为：
+```
+[{timestamp}] {speaker}: {text}
+```
+
+#### raw_text
+
+直接使用 source_ref 作为文本内容。
+
+#### pdf_doc
+
+使用 `pdf` 工具提取文本。若不可用，返回错误并建议用 `raw_text`。
+
+### 归一化输出
+
+完成后得到：
+- `raw_content`：周报正文文本
+- `resolved_source_type`：实际来源类型
+- `metadata`：`{ document_title, source_label, week_range?, file_path?, source_ref }`
+
+失败处理：
+- 部分内容可读 → 继续，标注 `partial: true`
+- 完全失败 → 记录错误，终止流程
+
+---
+
+## Phase 2: 信息抽取与看板建模
+
+### 识别项目边界
+
+从以下模式识别项目：
+- 标题标识：`## 项目名`、`【项目名】`、`一、项目名`
+- 若无明确项目边界，将整份报告作为单一"团队"项目
+
+### 抽取模块映射
+
+| 关键词/模式 | 映射到 column |
+|-------------|--------------|
+| 完成、已完成、本周进展、关键进展 | done |
+| 进行中、在研、开发中、测试中 | in_progress |
+| 风险、高风险、中风险、告警 | risks |
+| 问题、阻塞、依赖、待确认 | issues |
+| 下周、计划、待办、后续 | next_week |
+
+### 风险等级判定
+
+| 关键词 | risk_level |
+|--------|------------|
+| 高风险、严重、紧急、阻塞 | high |
+| 中风险、关注、需协调 | medium |
+| 低风险、轻微 | low |
+| 无明确标识 | none |
+
+### 项目阶段映射
+
+标准生命周期阶段（按顺序）：
+1. 商机 / 筹备
+2. SOW / 范围确认
+3. 需求 / 方案设计
+4. 开发实施
+5. 联调 / 测试
+6. UAT / 试运行
+7. 上线 / 交付
+8. 验收 / 回款
+
+### Kanban Model 结构
+
+```json
+{
+  "report_meta": {
+    "title": "周报标题",
+    "week_range": "2026-02-10 ~ 2026-02-16",
+    "owner": "团队名",
+    "generated_at": "ISO 时间"
+  },
+  "projects": [
+    {
+      "project_name": "项目A",
+      "owner": "负责人",
+      "overall_status": "on_track | at_risk | delayed | completed",
+      "columns": [
+        {
+          "column_id": "done | in_progress | risks | issues | next_week",
+          "column_title": "列标题",
+          "cards": [
+            {
+              "title": "卡片标题",
+              "owner": "负责人",
+              "risk_level": "none | low | medium | high",
+              "tags": []
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}
+```
+
+---
+
+## Phase 3: 富文本渲染
+
+### Section 顺序（固定）
+
+1. **一、本周重点结论**（1-3 条管理结论）
+2. **二、重点风险**
+3. **三、关键里程碑**
+4. **四、项目阶段分布**
+5. **五、其他关键事项进展**
+6. **六、补充事项**
+
+若某 section 无内容，省略不生成。
+
+### 首尾锚点策略
+
+- **第一个 section**：渲染总标题 + 报告周期
+  ```
+  【项目看板周报 - {团队名}】
+  报告周期：{周期}
+
+  {section 正文}
+  ```
+- **中间 section**：只有 section 标题 + 正文
+- **最后一个 section**：正文末尾追加数据来源脚注
+  ```
+  ——
+  数据来源：{source_label}
+  文档信息：{document_title}
+  [doc]{source_ref}[/doc]
+  ```
+
+### 可读性规则
+
+1. 先结论，后细节：每个 section 开头先给 1 句总结
+2. 一条 bullet 只表达一个重点
+3. 短句优先：单行控制在 30-40 个中文字符
+4. section 标题与正文之间不空行（紧凑排版）
+5. section 内不同卡片/里程碑之间空 1 行
+6. 避免连续堆叠 8 条以上 bullet 而不分组
+7. 一段正文超过 4 行时改写为 bullet 列表
+
+### 颜色与标签规则
+
+**禁止使用 Emoji**，统一使用文字标签。
+
+**着色单位：单行 / 单条 bullet，禁止整个 section 连续同色。**
+
+| 对象 | 颜色 | 触发条件 |
+|------|------|----------|
+| 高风险行 | 红色 | 阻塞、延期、严重问题 |
+| 重点关注行 | 红色 | 需管理层关注、需升级跟进 |
+| 中风险行 | 橙色 | 存在依赖、需跟进但未阻塞 |
+| 进展良好行 | 绿色 | 完成里程碑、阶段推进顺畅 |
+| 普通正文 | 默认色 | 常规说明 |
+
+**约束**：
+- 同一行最多 1 个主标签
+- 同一 section 彩色行不超过总行数 30%
+- 连续 3 行以上同色时，提炼 1 行高亮，其余恢复默认色
+- 模块标题、数据来源脚注不着色
+
+**标签列表**：
+
+| 标签 | 适用场景 |
+|------|----------|
+| 【高风险】 | 阻塞、延期、需升级 |
+| 【中风险】 | 有依赖、需跟进 |
+| 【进展良好】 | 里程碑完成 |
+| 【需拍板】 | 需业务/管理层决策 |
+| 【待协调】 | 需跨团队协同 |
+
+### 各 Section 渲染模板
+
+#### 一、本周重点结论
+
+```
+一、本周重点结论
+
+• {结论1}
+• 【高风险】{需关注的结论}（整行红色）
+• {结论3}
+```
+
+#### 二、重点风险
+
+```
+二、重点风险
+
+【高风险】{项目名}（标题行红色）
+• 风险描述：{描述}
+• 影响：{影响范围}
+• 当前状态：{状态}
+• 建议动作：{建议}
+
+【中风险】{项目名}（标题行橙色）
+• 风险描述：{描述}
+• 影响：{影响范围}
+• 当前状态：{状态}
+• 建议动作：{建议}
+```
+
+#### 三、关键里程碑
+
+```
+三、关键里程碑
+
+【里程碑1】{项目名}
+• 阶段：{当前阶段}
+• 关键节点：{时间点}
+• 状态：{推进状态}（状态行可按语义着色）
+
+【里程碑2】{项目名}
+• 阶段：{当前阶段}
+• 关键节点：{时间点}
+• 状态：{推进状态}
+```
+
+#### 四、项目阶段分布
+
+按阶段分组，组内每行格式：`项目名：当前状态`。
+
+```
+四、项目阶段分布
+
+上线/交付阶段（N个）
+项目A：状态描述
+项目B：状态描述（高风险行红色）
+
+开发实施阶段（N个）
+项目C：状态描述
+项目D：状态描述（中风险行橙色）
+```
+
+阶段输出顺序：上线/交付 → UAT/试运行 → 开发实施 → 联调/测试 → 需求/方案设计 → 商机/筹备。无项目的阶段不输出。
+
+**边界**：`需商务支持`、`需产研支持`、`需拍板` 不属于第 4 模块，归入第 5 模块。
+
+#### 五、其他关键事项进展
+
+承接跨项目协同事项：需商务支持、需产研支持、需管理层拍板、需外部协调等。
+
+#### 六、补充事项
+
+兜底模块，放不归属于以上 section 的内容。
+
+### Section 模块化规则
+
+1. **一个 section = 一条消息**，绝对禁止合并
+2. 单个 section 超过 2500 字符时，在 section 内拆分：
+   - `{section_title}（1/2）`
+   - `{section_title}（2/2）`
+3. 永不在 bullet item 中间断开
+4. 建议控制在 1200-1800 字符，保证单屏可扫读
+
+---
+
+## Phase 4: 多渠道发送
+
+当 `send_channel = "none"` 时跳过本阶段，直接输出 `rendered_sections`。
+
+### 渠道路由
+
+| send_channel | 发送方式 | send_target 格式 |
+|---|---|---|
+| `popo` | `razel-cli popo robot send rich` | 邮箱 `user@corp.netease.com` 或群 `group:12345678` |
+| `feishu` | `message` 工具（飞书机器人） | chat_id `oc_xxx` 或 open_id `ou_xxx` |
+| `dingtalk` | dingtalk CLI（预留） | webhook URL 或会话 ID |
+| `none` | 不发送，只输出 rendered_sections | — |
+
+### PoPo 发送
+
+```bash
+# 逐 section 发送富文本
+razel-cli popo robot send rich "$RECEIVER" "$RICH_TEXT_JSON" --json
+```
+
+razel-cli 自动处理 token 获取与缓存（`~/.razel/popo/config.json`），无需手动管理。
+
+### 飞书发送
+
+使用 `message` 工具（OpenClaw 内置飞书机器人），逐 section 发送：
+
+```
+message(action=send, channel=feishu, target=<chat_id_or_open_id>, message=<section_content>)
+```
+
+### 钉钉发送（预留）
+
+```bash
+# dingtalk-cli send rich <webhook_or_session> <rich_text_json> --json
+# 待 razel-cli 接入 dingtalk 子命令后启用
+```
+
+### Rich Text Conversion（PoPo）
+
+将 section content 转换为 POPO 富文本 JSON 数组。
+
+| 原文 | POPO Rich Text |
+|------|----------------|
+| `**text**` | `{"tag":"text","style":["bold"],"text":"..."}` |
+| `*text*` | `{"tag":"text","style":["italic"],"text":"..."}` |
+| 红色行（含【高风险】） | `{"tag":"text","style":["font_color"],"fontColor":"red","text":"..."}` |
+| 绿色行（含【进展良好】） | `{"tag":"text","style":["font_color"],"fontColor":"green","text":"..."}` |
+| 橙色行（含【中风险】） | `{"tag":"text","style":["font_color"],"fontColor":"orange","text":"..."}` |
+| 普通文本 | `{"tag":"text","text":"..."}` |
+
+**着色粒度：整行**，不是标签本身。
+
+### 发送控制
+
+- 一个 section = 一条消息，绝对禁止合并
+- 每个 section 发送后等待 500ms
+- 模块数 > 10 时，每 10 个额外等待 5s
+- 单条失败重试 1 次，仍失败记录错误继续下一条
+- 遇限流错误（PoPo 60msg/min），等待 30s 后重试
+
+### 发送失败通知
+
+若 Phase 1-3 完全失败（无可用 sections），向 send_target 发送一条失败通知：
+
+```json
+[
+  {"tag":"text","style":["bold"],"text":"【周报看板生成失败】"},
+  {"tag":"text","text":"\n\n本次文档解析失败，需人工检查：\n• 文档是否可访问\n• 文档格式是否正确\n\n请检查后重试。"}
+]
+```
+
+---
+
+## Error Handling
+
+| 场景 | 处理方式 |
+|------|----------|
+| source_ref 为空 | 立即返回错误 |
+| 来源类型无法识别 | 降级为 raw_text |
+| 文档下载/解析部分失败 | 继续处理可用部分，标注 partial |
+| 文档下载/解析完全失败 | 返回 `success: false` |
+| 无法识别任何项目 | 将整体作为单一"团队周报"处理 |
+| 某 section 无内容 | 省略该 section |
+| 抽取结果稀疏 | 尽力输出 |
+| send_target 无效 | 返回 `send_result.success: false` |
+| 单个 section 发送失败 | 重试一次；仍失败记录错误，继续下一条 |
+| 全部发送失败 | `send_result.success: false` |
+
+### POPO 错误码
+
+| errcode | 说明 | 建议 |
+|---------|------|------|
+| 42001 | Token 过期 | 自动重新获取 |
+| 65338 | 消息过长 | 拆分重发 |
+| 65341 | 非 POPO 用户 | 检查 target |
+| 65347 | 无 API 权限 | 检查机器人配置 |
+| 65611 | 接收者不存在 | 检查 target |
+
+---
+
+## Usage Examples
+
+### PoPo 文档 → 生成看板 + 发送到 PoPo
+
+```json
+{
+  "source_type": "popo_doc",
+  "source_ref": "https://docs.popo.netease.com/lingxi/77a575a0d9404cf09b2112e78c5a0341",
+  "send_channel": "popo",
+  "send_target": "wangxue08@corp.netease.com"
+}
+```
+
+### 飞书文档 → 生成看板 + 发送到飞书群
+
+```json
+{
+  "source_type": "feishu_doc",
+  "source_ref": "https://feishu.cn/docx/xyz789",
+  "send_channel": "feishu",
+  "send_target": "oc_xxx"
+}
+```
+
+### 聊天记录 → 仅生成看板（不发送）
+
+```json
+{
+  "source_type": "chat_log",
+  "source_ref": [
+    {"speaker": "张三", "timestamp": "2026-02-10 10:00", "text": "本周完成了A项目联调..."},
+    {"speaker": "李四", "timestamp": "2026-02-11 15:30", "text": "B项目存在接口风险..."}
+  ],
+  "send_channel": "none"
+}
+```
+
+## Dependencies
+
+| 依赖 | 用途 | 位置/安装 |
+|------|------|----------|
+| `razel-cli` | PoPo 文档下载 + 机器人发送 | `npm i -g @lcap-delivery/razel-cli` |
+| `jq` | JSON 处理 | `brew install jq` / `apt install jq` |
+| `pandoc` | DOCX→文本（推荐） | `brew install pandoc` / `apt install pandoc` |
+| `textutil` | DOCX→文本（macOS 自带） | 系统自带 |
+| `python-docx` | DOCX→文本（Python fallback） | `pip install python-docx` |
+| `message` 工具 | 飞书渠道发送 | OpenClaw 内置 |
+
+### 环境变量
+
+| 变量 | 用途 | 何时需要 |
+|------|------|----------|
+| `POPO_APP_KEY` | razel-cli popo robot 认证 | send_channel=popo |
+| `POPO_APP_SECRET` | razel-cli popo robot 认证 | send_channel=popo |
+| `POPO_APP_ID` | razel-cli popo doc 认证 | source_type=popo_doc |
+
+认证优先级：命令行参数 → `~/.razel/config.json` → 环境变量。

package/skills/popo-doc/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: popo-doc
+description: "通过 razel-cli popo doc 查询、搜索、下载 POPO 文档。Use when user mentions POPO docs, URLs with docs.popo.netease.com, or needs to download/search/view POPO documents. 触发词：POPO 文档, 下载 POPO, 搜索 POPO, docs.popo.netease.com, 抓取 POPO, 获取 POPO 文档"
+version: 1.0.0
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🍭",
+        "install": [{ "id": "npm", "kind": "npm", "package": "@lcap-delivery/razel-cli", "bins": ["razel-cli"] }]
+      }
+  }
+---
+
+# POPO Doc
+
+通过 `razel-cli popo doc` 查询、搜索、下载 POPO 文档。
+
+## Quick Reference
+
+| 子命令 | 用途 | 关键参数 |
+|--------|------|----------|
+| `info` | 查询文档详情（不下载） | `--url <url>` |
+| `url` | 获取文档访问 URL | `--doc-id <docId>` |
+| `search` | 搜索个人文档 | `--query <关键词>` `[--size <条数>]` `[--page <页码>]` `[--search-id <id>]` |
+| `download` | 下载到本地 | `--url <url>` `[--output <目录>]` |
+
+**URL 格式：**
+- 个人：`https://docs.popo.netease.com/lingxi/{docId}`
+- 团队：`https://docs.popo.netease.com/team/pc/{teamSpaceKey}/pageDetail/{pageId}`
+
+**需程序解析时始终加 `--format json`**
+
+## 命令选择决策树
+
+```
+用户要操作 POPO 文档
+├─ 有 URL，先查元信息 → razel-cli popo doc info --url <url> --format json
+├─ 有 docId，要 URL → razel-cli popo doc url --doc-id <docId> --format json
+├─ 按关键词找文档 → razel-cli popo doc search --query <关键词> --format json
+└─ 有 URL，要下载 → razel-cli popo doc download --url <url> --output <dir> --format json
+```
+
+## 使用示例
+
+```bash
+# 查询文档元信息
+razel-cli popo doc info --url "https://docs.popo.netease.com/lingxi/837e57c42fab4dc4b8efbbc95a780eff" --format json
+
+# 获取文档 URL
+razel-cli popo doc url --doc-id <docId> --format json
+
+# 搜索
+razel-cli popo doc search --query "周报" --size 10 --format json
+
+# 下载
+razel-cli popo doc download --url "https://docs.popo.netease.com/lingxi/12345678" --output ./docs --format json
+
+# 分页搜索
+razel-cli popo doc search --query "设计" --page 1 --size 10 --format json
+razel-cli popo doc search --query "设计" --page 2 --search-id "<上页的searchId>" --format json
+
+# 批量下载（依赖 jq）
+for id in $(razel-cli popo doc search --query "周报" --format json | jq -r '.data.documents[].docId'); do
+  razel-cli popo doc download --url "https://docs.popo.netease.com/lingxi/$id" --output ./docs --format json
+done
+```
+
+## Common Mistakes
+
+| 错误 | 正确做法 |
+|------|----------|
+| 需解析结果但未加 `--format json` | 程序处理时始终加 `--format json` |
+| 报错「权限」相关 | 确认文档访问权限 |
+| 报错「URL」相关 | 检查 URL 格式（个人/团队见 Quick Reference） |
+| 报错「认证」相关 | 检查 `~/.razel/config.json` 或环境变量 `POPO_APP_ID` / `POPO_APP_SECRET` |
+| 不明错误 | `DEBUG=true razel-cli popo doc <子命令>` 查看详情 |