https://www.yzchen.space/tags/system-prompt/ Recent content in System-Prompt on yzchen.space Hugo en-us Tue, 30 Jun 2026 12:00:00 +0800 https://www.yzchen.space/posts/20260630/pi-system-prompt-internals/ Tue, 30 Jun 2026 12:00:00 +0800 https://www.yzchen.space/posts/20260630/pi-system-prompt-internals/ <p>pi 的 system prompt 采用<strong>分层拼装</strong>机制，启动时按固定顺序叠放各层，最终拼接为发送给 LLM 的完整系统提示。</p> <h2 id="拼装顺序">拼装顺序</h2> <pre tabindex="0"><code>┌─────────────────────────────────────────────┐ │ ① 基础系统提示 (pi 内置) │ │ 角色、工具说明、行为准则、文档路径 │ │ ↓ 可被替换 │ │ ② SYSTEM.md (如存在) │ │ 完全替换①，而非追加 │ │ ~/.pi/agent/SYSTEM.md 或 .pi/SYSTEM.md │ │ ↓ │ │ ③ APPEND_SYSTEM.md (如存在) │ │ 追加在②之后 │ │ ↓ │ │ ④ 上下文文件 │ │ AGENTS.md / CLAUDE.md 全部拼接 │ │ 来源：全局 + 沿目录树向上收集 │ │ ↓ │ │ ⑤ 技能列表 (XML) │ │ 仅名称 + 描述，遵循 Agent Skills 规范 │ │ ↓ │ │ ⑥ 最终 System Prompt → 发送给 LLM │ └─────────────────────────────────────────────┘ </code></pre><h3 id="工具-schema-不在-system-prompt-中">工具 Schema 不在 system prompt 中</h3> <p>工具定义（<code>read</code>、<code>write</code>、<code>edit</code>、<code>bash</code> 及扩展注册的自定义工具）作为 API 请求的 <code>tools</code> 参数单独传递，<strong>不进入 system prompt 正文</strong>。system prompt 中只包含工具的简要描述说明。</p>