research-note-wrap
Overview
将 Claude Code 中的调研、排查、方案比较和分析会话，整理成适合 Obsidian 复用的高密度 Markdown 笔记。Obsidian vault 根目录为 E:/DOC，实际默认保存根目录为 E:/DOC/AIKb，并沿用 /archive-chat 的目录分类习惯。
Best Fit
适合这些场景：
- 总结调研
- 输出结论
- 输出笔记
- 分析纪要
- 方案比较结论
- 沉淀成知识笔记
- 整理成项目知识笔记
不适合这些场景：
- 如果用户明确要做整段聊天归档，优先使用 archive-chat
- 如果用户要的是长期、多轮、跨天的专题研究，而不是当前结论整理，先澄清范围
Core Rules
- 默认使用简体中文。
- 先给结论，再给必要说明。
- 不输出 chronological 流水账。
- 多个问题、假设、结论、影响或后续动作并存时，优先使用表格。
- 表格之后必须有简短的
关键结论。 - 只有在真正支撑结论时，才引用代码位点。
- 如果提到文件、函数、方法或代码路径，必须用中文解释：
- 它负责什么
- 它为什么关键
- 它如何支撑当前结论
- 除非用户明确说“不要保存 / 仅预览”，否则默认按 AIKb 规则准备落盘。
- 如果用户明确给出文件路径或目标目录，用户指定路径优先于默认路由。
Scope Decision
默认范围
如果用户说的是：
- 总结调研
- 输出结论
- 总结分析
- 输出笔记
- 调研纪要
- 分析纪要
- 会话结论
则默认总结当前会话。
跨会话范围
如果用户明确说的是：
- 总结今天关于 xx 的分析
- 汇总今天关于 xx 的调研
- 总结今天相关会话中的 xx 问题
则收集当天相关会话并合成一份笔记。
如果用户明确给出其他时间范围，按用户范围执行。否则，近期 默认按当天处理。
续写范围
如果用户说的是：
- 继续补充刚才那份笔记
- 再调研 xx 并写入刚才那份笔记
- 补充分析 xx 并保存回原笔记
则默认复用当前笔记，而不是新建文件。
Output Routing
默认知识库根目录固定为：E:/DOC/AIKb
| 场景 | 默认目录 | 常见触发信号 |
|---|---|---|
| 聊天归档 | E:/DOC/AIKb/聊天归档/YYYY/MM/ |
总结调研、输出结论、输出笔记、会话结论、按默认规则保存、保存到 AIKb |
| 主题知识沉淀 | E:/DOC/AIKb/知识沉淀/主题/ |
知识笔记、专题总结、方法总结、原理总结、沉淀 |
| 项目知识沉淀 | E:/DOC/AIKb/知识沉淀/项目/ |
项目知识笔记、项目总结、某项目的调研结论 |
路由规则：
1. 用户明确给出的文件路径或目标目录优先。
2. 用户只说“按默认规则保存 / 保存到 AIKb”时，默认落到 聊天归档/YYYY/MM/。
3. 只有当用户明确表达“知识沉淀 / 专题总结 / 项目知识笔记”时，才升级到 知识沉淀/主题 或 知识沉淀/项目。
4. 如果主题、范围或分类真的不清楚，最多只补一个聚焦问题，不要为了确定目录反复追问。
Confirmation Workflow
默认流程
默认使用更适合 Claude Code 的轻量流程：
- 先给一份合并预览，至少包含：
- 标题
- 建议保存路径
-问题对比表
-结论对比表
-关键结论 - 然后只问一次：是否按此内容保存。
- 用户确认后，再写文件并回报最终路径。
快速保存
如果用户明确说：
- 直接保存
- 按默认规则保存
- 保存到 AIKb
- 或已经给出精确路径
则：
- 不要再为目录问题追问
- 只有在标题、主题或分类歧义会明显影响落点时，才补一个必要问题
- 否则直接生成最终内容并保存
仅预览
如果用户明确说：
- 不要保存
- 仅预览
- 先看内容
则：
- 只输出预览
- 不创建文件
- 如有必要，可顺带给出建议标题与建议路径，但不要落盘
Output Structure
默认输出结构如下。保持简洁、高密度、可复用。
---
title: <标题>
date: <YYYY-MM-DD>
project: <项目名；无则省略>
topic: <topic-slug>
kb_type: <聊天归档 | 主题知识 | 项目知识>
tags: [ai-kb, research, summary]
source: <current-session | today-topic-synthesis>
---
# <标题>
## 问题对比表
| 问题 | 现象/信号 | 核心判断 | 当前结论 | 影响 |
|---|---|---|---|---|
| ... | ... | ... | ... | ... |
## 结论对比表
| 主题 | 结论 | 依据 | 风险/边界 |
|---|---|---|---|
| ... | ... | ... | ... |
## 关键结论
1. ...
2. ...
3. ...
## 必要实现位点（仅在真的重要时）
| 位点 | 逻辑/作用 | 为什么关键 |
|---|---|---|
| `path:line` / `symbol` | 它负责什么 | 它如何支撑结论 |
## 未决项 / 后续建议
| 项目 | 说明 |
|---|---|
| ... | ... |
File Naming
默认文件名格式：
YYYY-MM-DD-<topic>.md
示例：
- 2026-04-14-session-research.md
- 2026-04-14-mcp-tool-design.md
- 2026-04-14-research-note-wrap-adaptation.md
如果主题不清楚，使用简短中性兜底名，例如：session-research。
Follow-up Research After Initial Output
如果用户说的是：
- 再调研 xx 输出到文件中去
- 补充分析 xx 并写入笔记
- 继续补充刚才那份笔记
则：
1. 默认复用当前笔记。
2. 新内容新增一个分节，例如：
## 追加专题：xx
- 只有用户明确要求单独一篇时，才新建文件。
Writing Guidance
Good
- 先压缩结论，再补充依据。
- 把重复讨论合并成一行或一个结论。
- 优先做对比和综合，而不是过程复盘。
- 预览部分保持短、准、可直接确认。
- 技术引用全部用中文解释清楚。
Avoid
- 长篇过程转录
- 工具调用 chatter
- 重复同一结论
- 只堆文件路径或函数名，不解释含义
- 在路由已确定时还反复追问保存目录
Final Checklist
写文件前确认：
- 范围正确：当前会话或当天相关会话。
- 路由正确：聊天归档 / 知识沉淀/主题 / 知识沉淀/项目。
- 如果用户要求仅预览，则不落盘。
- 标题和建议路径清晰。
- 用户已经确认保存，或明确要求 直接保存 / 按默认规则保存。
- 表格承载了主要比较信息。
- 关键结论 出现在表格之后。
- 代码位点（如果有）都已用中文解释。
- 文件名符合 YYYY-MM-DD-topic.md。
