# discussion-notes

边讨论边把可复用结论写进项目里的 Markdown 笔记。笔记是活的：理解变了就改，不另存聊天稿。

## 什么时候使用

- 要进入讨论模式、沉淀到文档、整理笔记、单开文档。
- 适合学习概念、做技术选型、把讨论变成可回顾的结论。
- 不适合：一次性问答、必须进 skill 记忆库的沉淀（用 `memory-distill`）、也不要用来当会议逐字稿。

说「结束讨论」或「不用记了」就退出；之后不再自动改笔记。

## 安装

```bash
pouch add discussion-notes          # 当前项目
pouch add discussion-notes -g       # 全局
```

## 使用前准备

- 指定笔记路径，或接受默认 `000inbox/<topic>.md`（按 Obsidian 收件箱习惯）。
- 有明确话题名更好；没有的话 Agent 会问一次。
- 笔记写在当前项目仓库内。默认不 git commit。

## 使用示例

```text
进入讨论模式，记到 000inbox/podman-vs-docker.md：公司 Debian VM 上容器运行时选 Podman 还是 Docker。
```

```text
讨论 Quadlet 是什么，单开一篇概念笔记，并链到刚才的选型文档。
```

```text
这轮不用记，先只回答。
```

```text
结束讨论。
```

## Agent 会做什么

1. 确认路径：你指定的文件，或默认 `000inbox/<topic>.md`。新话题新建，续聊改已有文件。
2. 按内容选结构：选型/决策，或概念/原理。模板见 [reference.md](reference.md)。
3. 每轮先用中文回答你，再更新笔记里的结论、对比、约束；纠正旧理解时直接改，不留错误版本。
4. 只写可复用知识，不把问答全文抄进文档，不创建 `.raw.md`。
5. 你说结束时，可选加一节「更新」：搞懂了、纠正了、待动手。

## 如何判断完成

- 约定路径上有一份正在维护的 `.md`，结构能看出结论而不是聊天记录。
- 本轮新结论已经写进对应章节；过时说法被改掉，而不是追加在文末。
- 没有出现 `xxx.raw.md`，也没有未经确认的 git commit。
- 退出讨论后，Agent 不再自动改那份笔记。