feat: add discussion-notes skill for collaborative note-taking

Add owned skill for discussion mode with continuous Markdown沉淀, templates in reference.md, and registry entry in AGENTS.md. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-03 00:35:25 +08:00
parent ea3621a065
commit 8b5ac01a9d
3 changed files with 259 additions and 25 deletions
@@ -0,0 +1,104 @@
+---
+name: discussion-notes
+description: >-
+  讨论沉淀模式：协作问答并持续更新 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](reference.md)。
+
+---
+
+## 何时使用
+
+- 用户 `@discussion-notes` 或说「进入讨论模式」
+- 用户希望边讨论边沉淀到文档（`沉淀到文档`、`整理笔记`）
+- 学习新概念、做技术选型，需要产出可回顾的笔记
+- 用户说「单开文档」记录某个子话题
+
+**退出**：用户说「结束讨论」「不用记了」→ 可选写收尾「更新」节，之后不再自动改笔记。
+
+---
+
+## 步骤
+
+### 1. 确认笔记目标
+
+| 情况 | 动作 |
+|------|------|
+| 用户指定路径 | 使用该路径（项目仓库内） |
+| 未指定路径 | 默认 `000inbox/<topic>.md` |
+| 无明确话题 | 询问话题名与路径 |
+
+**新开话题** → 新建独立 `.md`。**续聊** → 打开已有笔记继续改。
+
+### 2. 判断文档类型
+
+| 类型 | 何时用 | 结构要点 |
+|------|--------|----------|
+| 选型 / 决策 | 要不要、选哪个 | 背景、对比、结论、落地清单 |
+| 概念 / 原理 | 是什么、怎么工作 | 核心结论、原理、误解、示例 |
+| 混合 | 选型 + 深层概念 | 主文档写选型；概念单开并互相链接 |
+
+### 3. 每轮讨论
+
+```
+1. 理解用户问题（结合对话历史）
+2. 用简体中文回复
+3. 更新笔记：
+   - 新结论 → 写入或修订对应章节
+   - 纠正旧理解 → 直接改，不保留错误版本
+   - 关键约束 → 记入「背景」或结论旁
+4. 只沉淀可复用知识，不抄 Q&A 全文
+```
+
+用户说「这轮不用记」→ 只回复，不改文件。
+
+### 4. 可选收尾
+
+讨论告一段落时，在笔记加：
+
+```markdown
+## 更新
+- 搞懂了：…
+- 纠正了：…
+- 待动手：…
+```
+
+---
+
+## 注意事项
+
+### 必须遵守
+
+- **单文件沉淀**：只维护 `xxx.md`，**禁止** `xxx.raw.md`
+- **笔记是活的**：理解变了就改笔记
+- **不主动 git commit**：除非用户明确要求
+- 对话与笔记均用**简体中文**
+
+### 写什么 / 不写什么
+
+| 写 | 不写 |
+|----|------|
+| 结论、理由、对比表、命令示例 | 逐轮 Q&A 全文 |
+| 待验证 / 待深入行动项 | 寒暄、重复铺垫 |
+| 纠正过的误解 | 无关闲聊 |
+
+### 反模式
+
+- ❌ 创建 `.raw.md`
+- ❌ 只聊天不更新已约定的笔记
+- ❌ 每轮末尾追加「第 N 轮 Q&A」
+- ❌ 未经确认把无关话题塞进同一文件
+- ❌ 笔记写成聊天转录
+
+### 协作约定
+
+- 笔记过长（建议 > 400 行）→ 拆章节或拆文件
+- 项目级默认笔记目录：`000inbox/`（Obsidian 收件箱）
@@ -0,0 +1,127 @@
+# Discussion Notes 参考
+
+## Frontmatter
+
+```yaml
+---
+title: {{主题名}}
+date: "{{YYYY-MM-DD}}THH:MM:00+08:00"
+---
+```
+
+新建时写 `date`；大改时追加文内「更新」节即可。
+
+---
+
+## 笔记结构模板
+
+### 选型 / 决策类
+
+```markdown
+# 标题
+
+> 一句话说明文档用途。讨论过程中持续更新。
+
+## 背景
+## 结论
+## （各专题章节）
+## 落地清单
+## 待验证
+## 待深入
+## 更新（可选）
+```
+
+### 概念 / 原理类
+
+```markdown
+# 标题
+
+> 与 xxx 选型文档无关（若适用）。
+
+## 核心结论
+## 定位（是什么 / 不是什么）
+## 工作原理
+## 与相关概念对比
+## 示例
+## 常见误解
+## 待验证
+```
+
+---
+
+## 示例：选型笔记（节选）
+
+```markdown
+---
+title: Podman vs Docker
+date: "2026-07-02T22:50:00+08:00"
+---
+
+# Podman vs Docker
+
+> 公司内部基础设施容器运行时选型笔记。讨论过程中持续更新。
+
+## 背景
+
+- 默认系统：Debian
+- 部署：一服务一 VM，VM 内跑容器
+
+## 结论
+
+推荐 Podman；compose 用 `podman compose`。概念见 [quadlet](quadlet.md)。
+
+## 待验证
+
+- [ ] Debian VM 上 rootless + compose 冒烟测试
+```
+
+---
+
+## 示例：概念笔记（节选）
+
+```markdown
+---
+title: Quadlet
+date: "2026-07-02T23:30:00+08:00"
+---
+
+# Quadlet
+
+> Podman 与 systemd 的集成机制。
+
+## 核心结论
+
+- Quadlet 不是容器引擎，依赖 Podman
+- `.container` 经 systemd generator 编译为 `.service`
+
+## 常见误解
+
+| 误解 | 事实 |
+|------|------|
+| 不装 Podman 也能跑 | ❌ ExecStart 即 podman run |
+```
+
+---
+
+## 调用方式
+
+```
+@discussion-notes 讨论 xxx，记到 000inbox/xxx.md
+```
+
+---
+
+## 工作流示意
+
+```
+用户提问
+    │
+    ▼
+Agent 回复（中文）
+    │
+    ▼
+更新 000inbox/<topic>.md
+    │
+    ├─ 延续话题 → 改已有文件
+    └─ 新子话题 → 新建 md + 主文档加链接
+```