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>
This commit is contained in:
@@ -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 收件箱)
|
||||
Reference in New Issue
Block a user