Discussion Notes — AI skill for Claude Code

Discussion Notes · 讨论笔记

[简体中文](README.md) | [English](README.en.md)

Turn long, scattered AI discussions into readable, traceable Markdown notes—with optional Obsidian filing and HTML companions.

把冗长、零散的研究对话整理成便于保存、阅读和回溯的笔记。保留重要结论、依据、推断与关键修正，合并重复内容；根据讨论选择结构，不强制套用模板。

为什么做这个技能

和 AI 聊完一个问题后，不必每次重复交代：“保留关键信息，不要太简略，也不要过于啰嗦，去掉重复，方便以后回溯。”

笔记的详略标准是：过一段时间再读，仍然能理解讨论了什么，以及为什么得出这些认识。它保留对话中公开表达的分析，不声称还原模型未公开的内部思考。

使用方式

主要方式：AI 主动判断，用户确认后记录

你只需要像平常一样与 AI 讨论问题，不必记住口令，也不必每次主动要求总结。

AI 根据可访问的对话上下文判断是否形成了值得保留的认识：例如重要结论、分析角度、依据、取舍或关键修正。如果以后只看最终答案会丢掉有价值的思考内容，这段讨论就可能值得记录。

当讨论自然收束、没有新的问题正在展开时，AI 应主动询问一次：

这次讨论形成了一些值得保留的认识，需要我整理成方便回溯的笔记，并保存到 Obsidian 吗？

你确认后，AI 才生成笔记并保存；忽略或拒绝后，不在同一阶段反复提醒。它会区分“值得记录”和“现在适合提醒”，避免打断正在深入的讨论或操作任务。普通单问单答和常规任务完成不自动触发。

补充方式：用户主动提出

你也可以随时表达整理意图，无需准确措辞：

用户表达	行为
“讨论笔记”“讨论总结”“讨论纪要”等意图尚不明确的表达	询问是否整理，确认后执行
“帮我做个讨论总结”“生成讨论纪要”等明确请求	直接整理，默认保存 Markdown 并归档 Obsidian
仅说“这个讨论就到这里吧”	有值得沉淀的讨论内容时，询问是否整理

需要显式调用时，可在 Codex 中使用 `$discussion-notes`，在 Claude Code 中使用 `/discussion-notes`。解释这些词、引用示例或讨论技能规则本身，不会仅因关键词出现而触发。

判断由宿主 Agent 自身的 AI 能力完成，不需要另接一个模型。**主动判断与邀请是主要使用方式**；实际触发仍依赖宿主加载技能并识别上下文，不保证每次提醒，用户主动调用作为补充。

保存与阅读

• Markdown 为基础：自主组织主题，保留理解所需的背景、依据、条件和未决问题；不补造来源，不把猜测变成定论。
• 自动归档 Obsidian：发现本地库，参考目录和相关笔记选择位置。确有多个无法区分的目标库时才询问。
• 没有 Obsidian 也可使用：交付 Markdown 文件；无文件能力时提供完整正文。写权限受限时先完成笔记，再请求必要权限，拒绝后保留可用成果。
• HTML 为可选补充：交叉关系或多层分支确实适合交互阅读时，先询问，确认后额外生成本地 HTML。Markdown 仍保留完整内容。
• 不覆盖旧笔记：先检查重复；默认新建续篇，明确要求更新时才修改原文。

安装

推荐下载 [discussion-notes.zip](discussion-notes.zip) 并解压，得到可安装的 `discussion-notes/` 文件夹，包含 `SKILL.md`、`references/` 和 `agents/`。仓库根目录同时提供可阅读的技能正文与归档规则；根目录版本使用同级 `obsidian.md` 引用，内容与安装包一致。

Codex

将 `discussion-notes/` 复制到用户技能目录 `~/.agents/skills/`。部分桌面环境也识别 `~/.codex/skills/`，使用宿主已有的技能目录即可；不要同时放入两个位置造成重复。

安装后在技能列表检查 `discussion-notes`；未显示时开启新会话或重启应用。

Workbuddy

下载仓库中的 [discussion-notes.zip](discussion-notes.zip)，在 **技能 → 添加技能 → 上传技能** 中导入，并确认启用。此 ZIP 仅含技能，不含仓库说明文档。

Cla