关于system prompt的疑问

[BailanCaptain]

1、在第二课的课后作业中写到”在system prompt中强调不确定时说不知道”,猫猫你的system prompt是在哪里改的呢，Claude code, codex, Gemini cli都去修改了system prompt，把不确定时说不知道这条加入了system prompt吗
2、system prompt和各个CLI的上下文配置文件有什么区别呢，比如CLAUDE.md,AGENG.md,GEMINI.md这些，我把规则加入到三个CLI的项目配置文件中和我去修改system prompt有什么差异

[zts212653]

好问题！这两个问题正好对应我们开发中一个很重要的架构决策。

问题 1：system prompt 在哪里改的？

第二课里说的"在 SystemPromptBuilder 中增加了诚实规则"，指的是 Cat Café 服务端自己的代码，不是直接修改某个 CLI 的配置文件。

Cat Café 的架构是：每次调用猫猫前，服务端会动态组装一段 system prompt，包含身份信息、协作规则、队友名册、工作流触发点等。这段 system prompt 通过不同方式注入到各 CLI 中：

CLI	注入方式
Claude CLI	--append-system-prompt "..." 参数
Gemini CLI	拼接到 prompt 文本开头（Gemini CLI 没有独立的 system prompt 参数）
Codex CLI	类似方式注入

所以"在 system prompt 中强调不确定时说不知道"这条规则，写一次代码，三只猫都生效——因为 SystemPromptBuilder 是统一的构建器，对所有 provider 生成同样的内容，只是注入方式不同。

如果你是单猫场景（比如只用 Claude CLI），直接把规则写在 CLAUDE.md 里就行，不需要我们这套服务端组装。

问题 2：system prompt vs 配置文件（CLAUDE.md / GEMINI.md）的区别

这是一个很关键的区别，虽然效果看起来类似，但底层机制完全不同：

CLAUDE.md / GEMINI.md / AGENTS.md（配置文件）

• 由 CLI 自动发现和加载——放在项目根目录就行，不需要代码注入
• 作用域是项目级——所有在这个项目目录里启动的会话都会读取
• 对 CLI 内部的 Agent 行为生效——影响 CLI 自己的工具使用决策、文件访问策略等
• 会被 CLI 放进上下文窗口——占用 token，但 CLI 可能在上下文压缩时做特殊处理（比如 Claude CLI 会保留 CLAUDE.md 的关键内容）

system prompt（代码注入）

• 由你的代码控制——每次调用可以动态变化（不同猫、不同模式、不同上下文，注入不同内容）
• 作用域是调用级——可以针对每次调用定制
• Claude CLI 有特殊优势：--append-system-prompt 注入的内容独立于对话历史，上下文压缩时不会被丢掉
• Gemini CLI 没有这个特权：只能拼到 prompt 前面，压缩时可能丢失

该用哪个？

场景	推荐方式
规则适用于整个项目，所有会话通用	配置文件（CLAUDE.md / GEMINI.md）
规则需要动态变化（比如不同角色的猫有不同规则）	代码注入 system prompt
两种都用	✅ 可以叠加——配置文件设通用规则，system prompt 设个性化规则

Cat Café 的实际做法是两层叠加：

• CLAUDE.md：放项目级的通用规则（比如"这个项目的技术栈是 TypeScript + Next.js"）
• SystemPromptBuilder 动态注入：放猫猫身份、队友名册、当前 SOP 阶段、协作纪律等每次调用都可能不同的内容

简单回答你的情况

如果你只用一个 CLI（比如只用 Claude CLI），把所有规则写在 CLAUDE.md 里是最简单有效的做法。"不确定时说不知道"这条规则直接加到 CLAUDE.md 就行。

只有当你需要多猫协作（不同猫有不同规则）或动态调整规则（根据上下文变化）时，才需要像我们一样在代码里用 SystemPromptBuilder 动态组装。

一个关键点：压缩存活性不同

这里多说一句实战经验——Claude CLI 的 --append-system-prompt 和 CLAUDE.md 在上下文压缩时的存活性不同：

• --append-system-prompt：不会被压缩丢掉（它独立于对话历史）
• CLAUDE.md：CLI 会努力保留，但在极端 token 压力下可能被裁剪

所以如果有些规则是绝对不能丢的（比如身份信息、安全约束），建议用 --append-system-prompt；项目级的通用规则用 CLAUDE.md 就好。

推荐阅读

• 第三课：驯化 AI 的元规则 — 讲的是怎么写让 AI 真正遵守的规则，包括"铁律 vs 建议"的区别
• 第九课：Context Engineering — 上下文工程的四层解法，包含 system prompt 设计的更深入讨论