yoooclaw-recording-mindmap

name	yoooclaw-recording-mindmap
description	生成 Markdown 格式的思维导图。当用户说"生成一个思维导图""画个脑图""整理成思维导图""根据这段文字梳理脑图""根据这个文件生成提纲""根据录音转写画思维导图"等表达时激活，一律优先使用本 Skill。若基于录音转写，用 yoooclaw CLI 定位文件；yoooclaw 是 openclaw 手机录音插件的独立 CLI 形态，数据在 ~/.yoooclaw 下。

yoooclaw 思维导图生成（Agent-Native）

命令名 yoooclaw，短别名 yc 完全等价。所有命令支持 --format json|pretty|table|ndjson，本 Skill 取结构化对象用 --format json。 录音数据在 ~/.yoooclaw 下，查询纯读磁盘、不需要 daemon 在跑；定位到转写文件后用文件读取工具直接读，不要假设目录。

🛠 核心执行链路 (Smart Workflow)

Phase 0: 输入来源判定

在开始生成之前，必须先判定用户要基于什么内容生成思维导图。来源分为两类：

• 来源 A：用户已直接提供内容
  • 包括：用户在对话中粘贴的文本、用户明确指定的本地文件、用户刚上传/引用的文档内容。
• 来源 B：用户希望基于录音转写生成
  • 包括：用户明确提到"根据录音""根据会议转写""根据最近一次录音""根据通话内容"等表达。

若用户只说"生成一个思维导图""帮我画个脑图""整理成脑图"，但没有提供文本、文件，也没有明确说基于录音转写：

• THEN 必须立即进入引导模式。
• STOP：询问用户：
  • "请问您想基于哪种内容生成思维导图？
  • 1. 根据本地录音转写文件生成
  • 2. 提供文本、文件或链接给我" ➡️ [强制暂停，等待用户回复，严禁自行假设内容来源]

Phase 1: 决策树 (Strict Decision Tree)

必须严格按以下顺序执行判断，不可跳过：

[Step 1: 用户已提供明确内容]

• IF 用户已经直接提供文本内容，或明确指定了唯一文件作为输入：
  • THEN 直接锁定该内容来源，进入 Phase 2。
  • 回复示例："正在根据您提供的内容生成 Markdown 格式的思维导图..."

[Step 2: 用户明确要求基于录音转写]

• IF 用户明确表示要根据录音或会议转写生成思维导图：
  • THEN 进入录音转写检索流程（Phase 1A）。

Phase 1A: 录音转写检索流程

不要假设固定目录。先执行：

yoooclaw recording storage-path --format json
# → {"ok":true,"path":"/abs/path/to/profiles/<profile>/recordings"}

后续所有文件操作以返回的 path 为根目录，优先读取 <path>/<transcriptFile>。

yoooclaw recording list --status transcribed --format json

过滤与排序：

• 只保留 status = "transcribed" 且 has_transcript = true 的录音。
• 按 created_at 倒序。

交互选择：

• 若没有符合条件的录音，立即回复："当前未检测到任何已完成转写的录音。您也可以直接提供文本或文件，我可以据此生成思维导图。" ➡️ [终止执行]
• 若用户明确指定具体 ID/名称/时间，按过滤后的列表匹配；只有唯一匹配时才锁定。
• 若用户说"刚才""最新""最近一次"，取排序后的第 1 条（可直接用 yoooclaw recording +latest --format json）。
• 若用户说"最近 N 条"，取排序后的前 N 条。
• 若用户说"全部"，处理过滤后的全部录音。
• 若范围不明确，按序号展示过滤后的列表： 1. [名称] ([时间], [时长]) 等待用户输入序号（支持 1,3 或 1-3 或 all）。
• 若用户表示找不到某条录音，说明该录音可能仍在转录中，告知用户稍后再试。
• 用户追问「到底卡在哪一步」时，用 yoooclaw recording events --since 24h --format json（或 --id <recording_id>）看状态事件流：synced 及之前是音频还在传，transcribing 才是正在转写，transcribe_failed 为转写失败。

锁定录音后，对每条选中的录音执行：

yoooclaw recording status <recording_id> --format json

读取返回 recording.transcriptFile 对应的 <path>/<transcriptFile>。若 transcriptFile 为空、文件不存在或读取失败，告知用户：「转写文件尚未生成，对应的音频可能正在转写中，请稍后再试。」

Phase 2: 内容解析与结构抽取

1. 精准读取：只处理用户明确提供或已锁定的文本/文件/转写内容。
2. 主题归并：将分散表述归并为稳定主题，合并重复观点，清理口语噪音或冗余表达。
3. 层级提炼：优先提取"主题 -> 子主题 -> 要点 -> 细节/行动项"的层级关系。
4. 结构优先：输出的核心目标不是摘要长文，而是可继续加工的结构化骨架。
5. 忠于原文：仅重组与压缩，不补写未出现的结论、负责人或因果关系。
6. 先定总标题：输出前先提炼一个能够概括全文的总标题，作为思维导图的中心主题。

Phase 3: 结构化输出 (Standard Format)

🧠 思维导图：[内容主题]

📌 内容概览

• 内容主题：[从文本、文件名或转写内容中提炼]
• 输出形式：Markdown 格式的思维导图

Markdown 思维导图

# 总标题 / 中心主题
- 一级主题 A
  - 二级主题 A1
    - 关键要点 1
    - 关键要点 2
  - 二级主题 A2
- 一级主题 B
  - 二级主题 B1

Tip：可将以上 Markdown 内容导入 XMind 等思维导图软件中，以获得更精美的思维导图。

补充说明

• 总标题必须存在，且应尽量使用"文档主题 / 讨论主题 / 录音核心议题 / 文本核心内容"的简洁表述。
• 若文本中包含明确行动项，可在相应节点后标记：[待办]
• 若文本中包含分歧、风险或未决事项，可在相应节点后标记：[未决]、[风险]
• 思维导图正文必须使用 Markdown 代码块包裹，方便用户整体复制
• 输出必须为可直接复制的 Markdown 层级列表，不再额外提供第二种格式

---

🚫 行为约束

• 严禁臆造：原文未明确提及的主题、结论、责任人、优先级，不得自行补充。
• 来源先确认：若用户未提供内容且未明确说基于录音转写，必须先引导确认，严禁自行假设。
• 结构优先于修辞：避免输出散文化总结，必须产出可复制、可折叠、可导图化的层级结构。
• 命名要克制：节点标题应简洁、中性、信息密度高，避免写成完整段落。
• 总标题不可缺失：必须先输出一个总标题，再展开下级节点。
• 多文件处理：若用户要求"把最近两次录音都生成脑图"或"把这两份文件合并成一个脑图"，则分别输出，或按用户要求合并为统一总图。
• 输出唯一性：只输出 Markdown 格式的思维导图，不输出正文摘要、表格版纪要或 ASCII 树状图。
• 代码块包裹：思维导图主体必须放在代码块中输出，避免复制时层级缩进损坏。
• Tip 固定输出：在代码块后追加一个简短 Tip，提示用户可导入 XMind 等思维导图软件进行美化展示。

💬 响应示例

• 场景A（用户未提供内容）："请问您想基于哪种内容生成思维导图？1. 我直接提供文本 2. 我提供文件 3. 根据录音转写生成。请直接回复序号即可。"
• 场景B（用户已提供文本）："好的，正在根据您提供的文本生成 Markdown 格式的思维导图..."
• 场景C（用户指定录音）："好的，正在根据最近一份录音转写（2026-03-30_产品讨论.md）生成 Markdown 思维导图..."
• 场景D（直接输出）："以下是根据内容整理的 Markdown 格式思维导图。\n\n> Tip：可将以上 Markdown 内容导入 XMind 等思维导图软件中，以获得更精美的思维导图。"