CSF

案例:帮找 v3 开发日志节选(session 373–375)

简体中文 | English

这是 CSF(Collaboration Specification Framework)在一个真实项目中连续运作的原始记录。 三段日志,展示了 CSF 在处理系统性设计缺口时的实际运转方式。


项目背景

帮找 v3 是一个微信小程序 + H5 的任务转发平台,核心业务是任务的发布、转发、传播树追踪与数据统计。项目在第 373 次 AI 协作会话时仍在进行中。

这三段日志展示的不是”功能开发”,而是一个复杂问题的发现、归因和修正过程——用 375 次会话积累的上下文,发现了一个跨越 4 个设计层次的系统性遗漏。


三段日志做了什么

文件 会话 核心事件
dlog-373-发现严重问题.md session-373 在集成测试中发现「转发概况栏」从未实现;追问根因,发现是一个时序 + 信息孤岛导致的四层设计漏洞
dlog-374-回头梳理转发事件树的问题并定新修改方案.md session-374 进一步发现问题不是孤立缺口,而是整个节点级统计层从未设计;立项 tp-374,确立完整方案(选项 A:先做设计再开发)
dlog-375-修改问题.md session-375 执行 arch 文档修订(数据模型 + 云函数清单),并反向在历史 STB 上打备注,确保修正正确传递到此后所有开发任务

这里展示了哪些 CSF 机制

1. 会话启动(Session Opening)
每次会话以「阅读 context」开始,AI 在 60 秒内从 context.md 重建完整项目状态,不需要人工重新交代背景。373 次之后仍然如此。

2. 目的驱动(Purpose-First)
每个会话有明确的「当前任务窗口」和「红点位置」。当新问题出现时,先问”这是阻塞还是非阻塞”,再决定是否打断当前目的。

3. 即时记笔记(Real-time Notes)
session-373 中,Owner 提醒「即时记笔记」。AI 立刻暂停分析,写入 session-373.md,然后继续。这不是礼貌性动作,是确保跨会话连续性的操作纪律。

4. 设计选择的显式化(Decision Visibility)
「方案 A vs 方案 B」「IT-3 先对付出来 vs 完整设计再开发」——每个选择都被明确写出来,带上取舍理由,Owner 拍板之后记录在案。


CSF 的差异化优势:四个具体证据

以下四个行为,不是一般提示词工程能做到的,是 CSF 机制支撑下的结果。


1. AI 拒绝 Owner 的原定决定,给出理由,建议更好的路径

Owner 的既定计划是继续推进 IT-3(直接实现转发概况栏)。AI 在精读数据之后,主动判断原定计划有根本性缺陷,拒绝按原路走,并给出完整理由:

“我的判断是选项 A 更合适,原因:节点级统计缓存是 statsTrigger 的核心职责延伸,如果先上占位 UI,后续再改数据层,还要回头改 CF 和 WXML——这正是 Owner 说的’对付一个出来,后面还要改’。”

dlog-374,第 318 行

这不是”AI 照做”,而是 AI 读懂了更大的目的(不留技术债),在此基础上反驳了眼前的任务指令。Owner 在听完理由后,确认”我的选择是 A”。


2. AI 能够在请示 Owner 的前提下自主决策和行动

Owner 指令是”执行 D 计划,具体执行之前要向我 brief”(dlog-375,第 79 行)。AI 随后独立完成精读、分析、制定执行路径,向 Owner 输出 L3 Brief(dlog-375,第 131 行),经 Owner 确认后才开始动文件。

不是「做什么告诉我」,也不是「每步问我」,而是「独立想清楚,brief 之后再动手」。Owner 不需要参与过程,只需要在关键节点确认方向。


3. AI 自主安排复杂计划,不是等 Owner 给任务书

面对「转发概况栏缺失」这个单点问题,AI 主动追查根因,发现这是系统性设计缺口。在 Owner 问”是否可以做系统检查”之前dlog-373,第 349 行),AI 已经开始分析检查范围,并在 Owner 提问后输出了完整计划:

两件事分开做:事一(流程改进,轻量,即时生效)……事二(专项回溯,中量,需要计划)……”

dlog-373,第 427 行

最终立项了两个新的任务(tp-373 主题包切片交叉扫描 + tp-374 节点统计层)。Owner 只拍了”制定计划”四个字(dlog-373,第 448 行),具体的任务拆解、立项文件、进度表更新,全部由 AI 完成。


4. 快速回顾问题根因,依赖保存语义的日志,不依赖 RAG,也不读全库

在 dlog-373 中,AI 追查「为什么主题包会漏掉」,直接给出:

TD-02 创建:2026-05-19(第 138 次);主-5「转发关系呈现主线」立项:2026-05-21(第 168 次)。TD-02 定稿时,主-5 根本还不存在。

dlog-373,第 287 行

这个精确到会话序号和日期的时序判断,来自 AI 读了 TD-02 的 package.md 和主-5 的计划文件——这两个文件是 CSF 要求每次立项时写入「创建时间 + 会话序号」的。不需要读 370+ 条原始日志,不需要向量检索,AI 读了 2 个设计文档就定位了跨 30 次会话的时序冲突。

这是 CSF 的核心主张之一:日志要保存语义,不保存流水账。有了携带语义的结构化记录,AI 可以在一个会话内从 375 次协作积累中精准提取任何一个决策节点,就像人类翻阅有目录的笔记,而不是搜索无结构的聊天历史。


怎么读这些日志

这三个文件是完整的原始对话记录,包含 AI 的工具调用轨迹(搜索、读文件等)。读法建议:

文件中的本地路径链接(file:///d%3A/huiDev/...)在你的机器上不可访问,这是正常的——这是当时真实情况的原始记录,不是可复现的演示。


关于 CSF

这三段日志所展示的,是 CSF 的核心主张之一:把 AI 的工作记忆外化到文件系统,让每次会话都能在正确的上下文中开始,让每次决策都有痕迹可追。

不需要 RAG,不需要 agent orchestration,只需要一套协作纪律和一个持续维护的 context.md。

返回 CSF 仓库根目录