laily
c2d6a5a0d7
Redeploy locally with docker compose when the node is 127.0.0.1 and the image already exists. Make list/sync/remote/deb importable under python3 -I -S. Add human README.md for every builtin skill, slim ack's user-facing docs, and drop unused OpenSpec config.
58 lines
2.1 KiB
Markdown
58 lines
2.1 KiB
Markdown
# 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 不再自动改那份笔记。
|