wiki-quick-chat-capture

Wiki 快速聊天记录

从当前对话中提取可复用的技术发现，并暂存到 _raw/，以便之后整理发布。目标是零阻力地记录那些可能随着会话结束而丢失的发现。

**速度要求：**仅在当前上下文中处理。不使用子 Agent。不使用 QMD。不写入清单。目标：<60 秒。

何时使用此技能

适用场景：

• 用户刚刚遇到一个不易察觉的 Bug，或在会话中确认了某个框架的注意事项
• 有值得保留的具体发现，但完整运行 /wiki-ingest 会造成太多干扰
• 用户想立即记录知识，并将整理发布推迟到当天晚些时候

这不能替代 wiki-capture（直接整理并发布为最终 Wiki 页面），也不能替代 wiki-ingest（完整的文档导入，包含交叉链接和清单跟踪）。

开始之前

1. 解析配置 — 遵循 llm-wiki/SKILL.md 中的配置解析协议（从当前工作目录向上查找 .env → ~/.obsidian-wiki/config → 提示用户设置）。提取：
   • OBSIDIAN_VAULT_PATH
   • OBSIDIAN_RAW_DIR（默认值：$OBSIDIAN_VAULT_PATH/_raw）
2. 确保 $OBSIDIAN_RAW_DIR 存在。若不存在，则创建它。

步骤 0：门槛评估 — 保留还是跳过？

在提取任何内容之前，快速判断本次会话是否有记录价值。此门槛可确保技能能安全地自动调用（例如通过 Stop 钩子），不会因例行或无结论的会话而将杂项塞满 _raw/。

跳过 — 如果以下条件全部成立，立即退出并回复“本次会话没有值得记录的内容。”：

• 对话纯属交流（规划、问答、解释），没有任何实现内容
• 没有可见的错误消息、调试步骤或问题解决过程
• 没有遇到意外或未记录的行为
• 所有发现都能从官方文档中直接看出

保留 — 如果以下任一条件成立，则继续执行步骤 1：

• 已应用修复，或通过调查发现了变通方法
• 讨论并确认了不易察觉的库/API/框架行为（例如边缘情况、未记录的限制，或耗时排查的问题）
• 调试过程得出了明确结论
• 总结出了基于经验或调试得出的可复用模式或技巧

通过 Stop 钩子自动调用时，倾向于跳过——只有证据明确时才保留。由用户手动调用时，倾向于保留——用户调用它自有原因。

步骤 1：扫描对话并提取发现

提取可复用的技术知识——也就是即使 3 个月后已不记得本次会话，也仍值得保留的内容。

记录：

• 不易察觉的 Bug 及其根本原因
• 框架或库的注意事项（未记录的行为、边缘情况）
• 令用户意外的 API 行为
• 需要调查才能找到的变通方法或修复方案
• 环境或工具链的特殊情况
• 调试或测试过程中总结出的模式

跳过：

• 项目管理更新、路线图变更、已在 CLAUDE.md 中记录的配置
• 未得出结论的探索性来回讨论
• 文档中已有的内容，或开发者初次阅读就能看出的样板信息
• 客套话、元对话、状态更新

如果没有重要发现，请告知用户并停止。

步骤 2：按主题归类

将相关发现分组——每个主题组使用一个原始文件，而不是为每条发现单独建文件。

示例：“Swift 6 并发注意事项”“Next.js 水合边缘情况”“Postgres 咨询锁”。

为每个主题组命名，使用 kebab-case 格式的标识符：swift-actor-reentrancy、nextjs-hydration-mismatch。

步骤 3：推断项目上下文

从对话中查找线索——仓库名称、文件路径、框架名称、错误消息。 使用你能可靠推断出的最具体的项目名称。如果无法确定，使用 null。

第 4 步：写入原始文件

为每个集群写入 $OBSIDIAN_RAW_DIR/<ISO-date>-<slug>.md。

阅读 references/RAW-FORMAT.md，了解完整的 frontmatter 规范、正文结构（发现内容块格式）以及来源/置信度校准表。

各集群中会变化的 frontmatter 字段速查：

• title — 描述性集群标题
• tags — 2–4 个与知识库分类体系相匹配的领域标签
• summary — 1–2 句话，≤200 个字符
• project — 推断出的项目名称或 null
• base_confidence — 0.6（已讨论，未确认）→ 0.75（已应用修复）→ 0.9（测试已确认）
• provenance.extracted / provenance.inferred — 两者之和必须为 1.0
• lifecycle_changed — 今天的 ISO 日期
• sources — "<project> session (<YYYY-MM-DD>)"

第 5 步：向用户确认

Staged to _raw/:
  _raw/2026-05-27-swift-actor-reentrancy.md   — "Actor reentrancy causes deadlock in async forEach"
  _raw/2026-05-27-xcode-derived-data-cache.md — "Stale derived data silently breaks incremental builds"

Run /wiki-ingest (or /data-ingest) to promote these to full wiki pages.

如果没有捕获到任何内容："本次会话中没有发现值得捕获的内容。"

此技能不会做什么

• 不写入清单 — _raw/ 文件不会记录在 .manifest.json 中
• 不更新 index.md、log.md 或 hot.md — 这些会在提升内容时更新
• 不刷新 QMD — 原始文件是草稿，不是已编入索引的内容
• 不使用子 Agent — 所有操作都在当前上下文窗口中内联运行

这些限制是有意设定的。重点在于速度。用户准备好后，通过 /wiki-ingest 提升内容即可处理以上所有事项。