.pouch/skills/discussion-notes/SKILL.md

name, description

name	description
discussion-notes	讨论沉淀模式：协作问答并持续更新 Markdown 笔记。Use when the user invokes discussion-notes, asks to enter 讨论模式, or wants to 沉淀到文档/整理笔记 during learning or decision conversations. Triggers on 讨论模式、讨论沉淀、记笔记、单开文档. No .raw.md—only living curated notes updated each round.

Discussion Notes（讨论沉淀）

与用户讨论的同时，把可复用结论持续写入项目内的 Markdown 笔记。

笔记模板与示例见 reference.md。

---

何时使用

• 用户 @discussion-notes 或说「进入讨论模式」
• 用户希望边讨论边沉淀到文档（沉淀到文档、整理笔记）
• 学习新概念、做技术选型，需要产出可回顾的笔记
• 用户说「单开文档」记录某个子话题

退出：用户说「结束讨论」「不用记了」→ 可选写收尾「更新」节，之后不再自动改笔记。

---

步骤

1. 确认笔记目标

情况	动作
用户指定路径	使用该路径（项目仓库内）
未指定路径	默认 000inbox/<topic>.md
无明确话题	询问话题名与路径

新开话题 → 新建独立 .md。续聊 → 打开已有笔记继续改。

2. 判断文档类型

类型	何时用	结构要点
选型 / 决策	要不要、选哪个	背景、对比、结论、落地清单
概念 / 原理	是什么、怎么工作	核心结论、原理、误解、示例
混合	选型 + 深层概念	主文档写选型；概念单开并互相链接

3. 每轮讨论

1. 理解用户问题（结合对话历史）
2. 用简体中文回复
3. 更新笔记：
   - 新结论 → 写入或修订对应章节
   - 纠正旧理解 → 直接改，不保留错误版本
   - 关键约束 → 记入「背景」或结论旁
4. 只沉淀可复用知识，不抄 Q&A 全文

用户说「这轮不用记」→ 只回复，不改文件。

4. 可选收尾

讨论告一段落时，在笔记加：

## 更新
- 搞懂了：…
- 纠正了：…
- 待动手：…

---

注意事项

必须遵守

• 单文件沉淀：只维护 xxx.md，禁止 xxx.raw.md
• 笔记是活的：理解变了就改笔记
• 不主动 git commit：除非用户明确要求
• 对话与笔记均用简体中文

写什么 / 不写什么

写	不写
结论、理由、对比表、命令示例	逐轮 Q&A 全文
待验证 / 待深入行动项	寒暄、重复铺垫
纠正过的误解	无关闲聊

反模式

• ❌ 创建 .raw.md
• ❌ 只聊天不更新已约定的笔记
• ❌ 每轮末尾追加「第 N 轮 Q&A」
• ❌ 未经确认把无关话题塞进同一文件
• ❌ 笔记写成聊天转录

协作约定

• 笔记过长（建议 > 400 行）→ 拆章节或拆文件
• 项目级默认笔记目录：000inbox/（Obsidian 收件箱）