CSF

CSF Lite — 新项目初始化指南

版本: v1.0 | 最后修订: 2026-07-06 | 项目: csf-core 首次使用 CSF Lite 时阅读。正常会话时不需要读本文件。 © 2025 zhanghui. CC BY-NC 4.0. https://github.com/huidev2025/CSF

一、CSF 是什么

CSF（Collaboration Specification Framework）是一套人机协作框架，让 AI 参谋长在没有跨会话记忆的情况下，依然能可靠地推进复杂项目。

核心机制：文件 = 外部大脑。所有状态、结论、计划都写在文件里；每次会话 AI 从零读取，从不依赖记忆。会话和会话之间的连续性，完全由文件保证。

三角团队：

角色	是什么	做什么
Owner	持有业务真相的人	输入需求、做最终决策、确认方向
参谋长	AI 一侧的主体	理解业务、规划、设计、维护 CSF
开发者	可选（软件项目）	按任务书实现代码、调试、验证

二、Owner — 5 分钟初始化

Step 1：填写项目信息

打开 cos-context.md，找到 §A > 项目与团队，填写：

**项目**：[项目名] — [一句话：这是什么 / 要达到什么目标]

Step 2：决定角色配置

场景	操作
只有 Owner + 参谋长	删除或忽略 `dev-context.md`
有开发者（人工 AI 均可）	保留 `dev-context.md`，开发者读它
软件开发项目	`protocols/FLDD-开发执行.md` 全程挂载（已内置）
非软件项目	`protocols/FLDD-开发执行.md` 可跳过

Step 3：决定 session 笔记存放位置

参谋长每次会话会建立 coslog-NNN.md。建议在项目根目录下新建一个 sessions/ 文件夹，或在项目内指定一个路径——在活跃三元组文件的「资源」段中写明路径，让参谋长知道往哪写。

Step 4：启动

在会话中告诉参谋长：「阅读 cos-context」

参谋长会读取 cos-context.md 并进入初始化流程（见下节 §三）。

三、参谋长 — 首次开局流程

当你读到 cos-context.md §A 的项目描述还是占位符（），且 §B/§C/§D 没有真实项目数据时，执行本节。正常会话（项目信息已填写）不走本节，走 §A 开局协议。

3.1 识别新项目

判断标准：§A 项目描述为占位符，§B 全景图无具体项目信息 → 进入初始化模式。

不要假装项目已存在然后产出空洞的开局 brief——那是有害的合规表演。

3.2 本次会话目标

建立第一个三元组文件 + 填写 §B 全景图和三元组指针，让下次会话能正常走开局协议。

次要目标：建立 coslog-001.md，正常收尾。

3.3 信息收集

向 Owner 提以下问题（可一次提出，也可边聊边问）：

P1 — 项目目的（必问）

「这个项目要做什么？完成后世界有什么不同？」

P2 — 项目性质（必问）

「是软件开发类（需要写代码）吗？还是策划/研究/设计类？」

P3 — 当前起点（必问）

「现在进展到哪了？完全从零开始，还是已有部分资料/代码？」

P4 — 阶段划分（可选，不知道没关系）

「你能大致描述这个项目的几个主要阶段吗？」

P5 — 团队配置（可选）

「除了你（Owner）和我（参谋长），是否还有开发者参与？」

3.4 场景适配（可选）

在产出 §B 之前，向 Owner 提议：

「在正式建立项目之前，是否需要执行场景适配？如果你的工作不涉及写代码，我可以帮你精简掉开发相关的规则，让后续会话更轻量。」

Owner 同意 → 执行 protocols/场景适配协议.md
Owner 拒绝或说”我是做开发的” → 跳过，默认开发场景（最大用户群）

3.5 产出初始三元组 + §B

收集信息后，执行以下操作：

① 建立第一个三元组文件（triplets/ 目录下）：

文件名自解释（如 项目开发.md）
内容：目的（具体）+ 方法（初步）+ 资源（目前已知的）+ 空进度表 + 空会话索引 + 活跃防御（可只放通用红线）+ 备忘

② 更新 triplets/_index.md：在活跃三元组表中新增一行

③ 填写 cos-context.md §B：

项目全景图（哪怕只有 1-2 层也行，后续会迭代）
三元组指针 → 指向刚建立的三元组文件
通用资源（保持默认即可）

三元组文件格式参考 → triplets/_index.md 中的使用规则。

3.6 正常收尾

走标准收尾协议（覆写 §C/§D，建 coslog-NNN.md）。§B 产出后，后续会话进入正常 CSF 循环。

四、全景图构建指引

全景图的目的：读 3 秒内知道「项目在哪里」。

基本结构

GP: [项目名] — [一句话目的]
│
├─ S1 [阶段名] ✅/🟢/⬜
│   ├─ TP-01 [任务名] ✅/🟡/⬜
│   └─ TP-02 [任务名] ⬜
│
├─ S2 [阶段名] ⬜
└─ S3 [阶段名] ⬜

符号约定

符号	含义
✅	完成
🟢	活跃进行中（当前阶段/任务窗口）
🟡	进行中（具体任务）
⬜	未开始
◀	当前红点所在

分层规则

GP（Grand Plan）：项目整体
S（Stage）：大阶段（独立的逻辑阶段，如”调研”/”设计”/”执行”/”上线”）
TP（Topic Plan）：单个主题或功能包（1-4 周量级）
IT（Iteration Task，迭代任务）：TP 内的具体执行步骤（1-3 天量级，软件开发用）

不是每个项目都需要四层。小项目 GP → TP 两层就够。

初次建图要点

不需要完整：阶段划分可以粗，后期迭代补细节
颗粒度不强求：早期只知道大目标，先写 S 级，TP 以后补
红点先行：不确定全景图怎么画，先定「当前在做什么」，这就是红点

五、session 笔记存放

CoS 会话笔记（coslog-NNN.md）是会话存在过的物理证据，也是跨会话的 log 层。推荐存放结构：

[csf根目录]/
├─ cos-context.md
├─ dev-context.md（可选）
├─ QUICKSTART.md（本文件）
├─ protocols/
├─ knowledge/
├─ triplets/
├─ workspace/
│   ├─ DEVNOTES.md
│   ├─ bug-tracker.md
│   └─ owner-inbox.md
├─ scenarios/（可选）
└─ sessions/          ← 推荐：所有 coslog-NNN.md 放这里
    ├─ coslog-001.md
    └─ coslog-NNN.md

在 cos-context.md §B > 通用资源段或三元组文件资源段中写明 session 路径，如：产出位置：sessions/。

六、常见问题

Q: 没有开发者，只有 Owner + 参谋长，还能用 CSF 吗？ A: 完全可以。忽略 dev-context.md 和 protocols/FLDD-开发执行.md 即可。CSF 核心只需要 cos-context.md + protocols/ 按需 + knowledge/ 按需。

Q: 项目很小（1-2 周），值得用全套 CSF 吗？ A: 小项目可以只用轻量模式：cos-context.md + 简单 §B + session 笔记，不需要全套 protocols。CSF 会随项目复杂度自然展开，不需要强制用满。

Q: 触发索引里的 protocols 都要读吗？ A: 不需要预读。只在遇到对应场景时才读。比如要立项才读 protocols/立项协议.md，要修 Bug 才读 protocols/BugFix-修复机制.md。平时不主动加载。

Q: cos-context.md §A 能改吗？ A: §A 是 CSF 引擎核心，不建议随意改。确实需要调整时，走 守则.md §5 CSF 变更纪律（单独会话，不在普通会话顺手改）。

Q: 参谋长不知道项目背景怎么办？ A: 正常现象。首次开局时参谋长会向 Owner 提问（§三）。这是 CSF 的设计——参谋长不猜测，而是主动收集信息，然后产出初始 §B。

Q: 全景图一开始就要完整吗？ A: 不需要。全景图是活的，随项目推进迭代。第一次只需要「知道第一步是什么」，就能启动。

初始化完成后，本文件可保留作参考，也可存档。不影响 CSF 运行。

This site is open source. Improve this page.