CSF

过程记录

版本: v1.1 | 最后修订: 2026-07-07 | 项目: csf-core 🛡️ 规则语义变更须经Owner确认并全程记入日志。 关键词: [过程记录, 过程不失真, 输出模式, log-primary, chat-primary, 双模, 通道切换, 记笔记] 适用场景: 所有会话。开局时必经判断点。会话中途 Owner 可随时触发切换。 上游: 守则.md §3(真知而非印象)、协作规范.md §1(会话物理模型)


§1 定位

解决的问题

对话的文本记录存在一个结构性偏差:每一轮对话记录的是「分歧前沿」(disagreement frontier),而非「共识积累」。 共识 = 零差分信号,在对话通道中不可见。

后果:收尾时记录的”结论”往往是最后焦点的投影,而非全程积累的全部共识。被默认接受的命题、被讨论后否决的方案——这些信息量最高的内容——系统性丢失。

本协议的答案

过程是唯一的事实。 不把”提取结论”作为目标——把”忠实记录过程”作为目标。有忠实的过程记录,结论可以随时按需提取。被否定的提议比被记录的结论更有信息量。假以时日,同一份过程记录可以被重读、重解,产出不同的结论。

在 CSF 中的位置

本协议属于 CSF 最底层的 I/O 基础设施。它不是”遇到某场景才触发”的规程——每次会话开局必然经过本协议的判断点。

守则(元原则)
  ↓
协作规范(角色接口)
  ↓
【本协议:过程记录】← 每次会话必经的 I/O 判断点
  ↓
开局协议 / 中段执行 / 收尾协议

§2 双模定义

CSF 同时支持两种输出模式。模式之间按需切换。

chat-primary(默认)

维度 行为
AI 主输出目标 对话窗口
对话窗口内容 完整分析(含表格、图示、逻辑链)
log 内容 回合摘要(压缩后的会议纪要式记录)
Owner 阅读方式 读 chat → 回应
适用场景 简单问答、状态同步、快速执行、Bug修复(简单)

log-primary

维度 行为
AI 主输出目标 log 文件(coslog-NNN.md)
对话窗口内容 路标式概述(3-5 句关键要点 + log 章节指针 + 待确认问题)
log 内容 完整分析(保留表格/图示/逻辑链/被否决的方案)
Owner 阅读方式 读 chat 概述 → 判断是否值得读 log → 读 log → 回 chat 回应
适用场景 协议/方法论设计、架构/方案设计、需求分析/业务探索、问题诊断/根因分析

两种记录方式(log-primary 下)

Mode A:草稿修改复写。 AI 判断当前话题会产生一个确定的产出物(协议草案、设计文档、方案描述)。直接在 log 中建草稿,每个回合在草稿上迭代修改,修改思路记入修改记录。会话收敛时,草稿即产出物——直接迁移为正式文件。

Mode B:递进分析记录。 讨论在不断升维、递进,每次都有新的逻辑层面被打开。每次递进的分析全部在 log 中展开为一个独立章节。chat 只做路标。会话收敛时,回顾所有章节提炼总结。


§3 切换机制

双轨并行。人工优先级 > 自动。

3.1 自动切换(AI 开局判断)

AI 在开局后,基于以下信号判断本会话是否建议 log-primary:

维度 log-primary 信号 chat-primary 信号
任务复杂度 多步骤分析,需表格/图示/对比 单步操作,线性问答
产出物性质 会产生持久文档(协议、设计、方案、spec) 临时查询、状态确认
逻辑深度 推理链 > 2 层,多因素权衡 直接因果
跨会话价值 分析在后续会话中需被回溯引用 一次性消耗
上下文预算 当前上下文已用 > 60% 上下文充裕

安全阀(以下情况不得自动切换):

判断时机:开局 L1 brief 中一并提议输出模式。也可在会话中途话题切换时重新判断。

3.2 人工切换(Owner 命令触发)

Owner 可在任何时刻说出触发词,强制切换。AI 必须立即响应,不得拖延到下个回合。

触发词 效果
“log模式” / “写到log” / “详细记录” → log-primary
“建议你先记笔记,然后再与我讨论” / “先记笔记” → log-primary(Owner 已感知信息丢失风险)
“chat模式” / “就在这说” / “简要说” → chat-primary

“建议先记笔记”的特殊性:此触发词表示 Owner 已经担心信息在 chat 中丢失。AI 收到此触发词后,不仅切换模式,还应将当前话题已讨论但尚未写入 log 的内容回溯记录到 log 中,再在 chat 中回应 Owner。

人工切换的持续性:人工切换后,AI 不得自行切回——除非 Owner 再次命令,或进入新会话(重置为 chat-primary)。

3.3 类型映射参考

以下为常见会话类型的默认模式建议,供 AI 开局判断时参考:

会话类型 默认模式 理由
协议/方法论设计 log-primary(Mode A) 产出持久文档,需保留完整设计推理和否决的替代方案
架构/方案设计 log-primary(Mode A) 多因素权衡,被否定的方案比选定方案更有信息量
需求分析/业务探索 log-primary(Mode B) 逻辑逐层递进,每次跃迁的因果关系是核心价值
问题诊断/根因分析 log-primary(Mode B) 排查路径和排除的假设需完整保留
Bug 修复(简单) chat-primary 线性执行,结论即修复
Bug 修复(复杂/架构级) log-primary(Mode B) 需排查分析
快速立项 chat-primary Owner 意图即轻量
日常状态同步 chat-primary 信息增量小
代码实现(按 STB) chat-primary 执行型,开发者已有 devlog
收尾 chat-primary 操作型,按协议逐项执行

灰色地带:分类不明确时 → 默认 chat-primary → AI 在首个需要深入分析的话题时提议切换。


§4 切换提醒

每次切换发生后,AI 必须立即发出以下格式的提醒:

---
⚙️ 已切换到【log-primary 模式】

我把完整分析记录在 `coslog-NNN.md` → 「{章节标题}」。
这里仅做概述:

{3-5 句关键要点——不是压缩,是路标}

建议移步 log 查看完整分析后回应。需要我展开哪一点,直接说。
---

设计约束


§5 质量标准

5.1 Self-Checklist(AI 每次 log 写入前自检)

# 检查项 不合格信号
1 结构保留 表格/图示在 log 中变成了纯文字描述
2 因果可见 逻辑跃迁的”因为……所以……”不可追溯,只有结论堆砌
3 否定可见 被讨论后否决的方案/假设未在 log 中记录
4 可重读 下次会话的 AI 读完后,无法重建与本次 AI 同等的理解
5 有路标 chat 中的概述未让 Owner 判断出”是否值得去读”

第 4 项是最终检验——下个会话的 AI 从零加载 context + 读本 log 后,认知不应残缺。

5.2 过程中检查

时机 动作 执行者
每次 log 写入前 过 self-checklist(5 项) AI
Owner 读 log 后 反馈”不清楚/缺了X” Owner → AI 修正
话题收敛时 回顾该话题全部 log 记录,确认因果链不断 AI
收尾时 回顾全部 log,确认无”写了但忘了总结”的话题 AI
下次会话开局 新 AI 读 log → 能否理解?→ 能 = 合格 AI(间接检验)

5.3 纠错

AI 可能犯两类错误,纠错成本均极低:

设计原则:宁可 AI 多提议切换让 Owner 否决,也不要该切不切导致过程信息丢失。


§6 输出闸门:强制回顾

以下两个时刻,AI 必须回顾真读原 log——不是凭印象,不是看摘要,是对着 log 文件逐段确认。此项为硬性要求,不可跳过。

闸门 1:话题结束,准备正式输出文档时

触发:AI 判断某一话题讨论已收敛,准备将结论输出为正式文件(协议、设计文档、方案、spec 等)。

强制动作

  1. 打开 coslog-NNN.md,回顾本话题的全部记录(含回合记录 + 完整分析章节)
  2. 逐项核对:log 中讨论过的每个要点是否在输出文档中有对应位置?
  3. 逐项核对:log 中被否决的方案是否被正确排除(而非遗漏)?
  4. 核对通过后,再执行写入

禁止:凭”我记得讨论过”直接输出。必须先读后写。守则 §3(真知而非印象)在此处适用——写前必读原 log。

闸门 2:收尾写 §C 结论时

触发:执行收尾协议,准备覆写 cos-context.md §C(上次会话结论)。

强制动作

  1. 回顾 coslog-NNN.md 全文(含所有话题的完整分析章节)
  2. 确认 §C 的每一条结论都能在 log 中找到直接来源
  3. 确认没有任何已达成但未被记录的共识遗漏
  4. 核对通过后,再写入 §C

禁止:从”最后讨论的焦点”反推结论。§C 必须是 log 全文的诚实投影,不是最后焦点的投影。


§7 与现有机制的关系

机制 本协议带来的变化 冲突?
回合记录段(coslog 回合记录) log-primary 模式下,回合记录段退化为轻量索引(回合号 + log 章节指针)。Owner 原话逐字记录(含新语义内容→完整记,纯流程指令→可精简),嵌入在完整分析语境中。chat-primary 模式下保持不变 无——两种模式下形态不同
会话日志段 话题结束时从 log 前置内容中自然提取总结。不是独立的二次压缩 定义微调:会话日志 = log 内容的自然收束
§C/§D 收尾覆写 §C 引用 log 中的总结。收尾协议增加:回顾 log 全文确认无遗漏 无冲突
开局协议 加载步骤中增加「判断输出模式」(在”加载”和”建 log”之间) 增加一个判断点
中段执行 log-primary 下,笔记伴随 = 直接在 log 中写完整分析(非压缩摘要) 无冲突

§8 责任归属

事项
开局判断输出模式 AI 提议,Owner 确认
会话中途切换 Owner 命令,AI 立即执行
执行写入(log / chat) AI
log 质量自检 AI(self-checklist)
log 质量抽查 Owner(读后反馈)
协议自身修订 走 CSF 变更纪律(守则 §5),不在普通会话内顺手改

§9 版本历史

版本 会话 变更
v1.1 coslog-002 增加 §6 输出闸门(两处强制回顾)+ §3.3 类型映射参考表
v1.0 coslog-002 初建。双模定义、切换机制(自动+人工)、Mode A/B、Self-Checklist 5 项、与现有机制关系