Built 26/04/16 13:13commit cc1e88d
How Claude Code Builds a System Prompt
中文 | English
摘要
这个来源是 Daniel Breunig 对 Claude Code 如何组装 system prompt 的分析。它对本知识库的主要价值在于：它解释的是现代 coding agent prompt 栈背后的组装逻辑，因此非常适合和 Piebald-AI/claude-code-system-prompts 这类 prompt 清单型来源配套阅读。
来源
- Raw file: raw/dbreunig/how-claude-code-builds-a-system-prompt.md
- Translated raw file: raw/dbreunig/how-claude-code-builds-a-system-prompt.zh.md
- Original URL: https://www.dbreunig.com/2026/04/04/how-claude-code-builds-a-system-prompt.html
- Ingest date: 2026-04-16
关键贡献
- 说明 Claude Code 的 system prompt 不是一条固定隐藏字符串，而是一个动态组装过程。
- 梳理了大量条件性 prompt 组件，包括 tool policy、编码规范、沟通风格、subagent 指南、skills 行为、memory 逻辑、MCP 指令、scratchpad 规则、git 上下文和可配置后缀。
- 说明最终 agent context 不止 system prompt 本身，还包括 tool definitions、user content、conversation history、attachments 与 skills。
- 相比 prompt dump 型仓库，它给出的是更偏架构层的视角，重点在于这些片段如何按运行时条件被选择、裁剪或变体化。
- 进一步强化了一个更大的判断：harness 行为不仅由基础模型决定，也深受 context engineering 与 orchestration logic 影响。
实际启发
- Prompt 清单和 prompt 组装分析应该一起读：前者展示零件，后者解释这些零件如何变成真实运行时上下文。
- Agent 行为高度依赖条件化 harness 逻辑，而不只是某个会话里最后可见的那条 system prompt 字符串。
- Skills、MCP 指令、memory 系统、tool definitions 以及 git/runtime 元数据，都应该放进同一个分析框架里理解。
- 逆向分析或泄露源码带来的研究，有时能暴露出被产品文档抽象掉的关键运维事实。