Class SystemPromptBuilder

tutorials/16_prompt_building_and_compaction.py:213–373

系统提示词构建器 — 源码 prompt.rs:84-185 这是一个 Builder 模式。最终 build() 返回 Vec ， 不是一个大字符串。每个 section 是一个独立的字符串。 为什么分成多个 section？ 因为 Anthropic API 的 system 参数支持数组。 当使用 prompt caching 时，只有变化的 section 会重新计算， 不变的 section 可以命中缓存。 关键: SYSTEM_PROMPT_DYNAMIC_BOUNDARY 标记分隔了 "静态部分"

class SystemPromptBuilder:
    """系统提示词构建器 — 源码 prompt.rs:84-185

    这是一个 Builder 模式。最终 build() 返回 Vec<String>，
    不是一个大字符串。每个 section 是一个独立的字符串。

    为什么分成多个 section？
    因为 Anthropic API 的 system 参数支持数组。
    当使用 prompt caching 时，只有变化的 section 会重新计算，
    不变的 section 可以命中缓存。

    关键: SYSTEM_PROMPT_DYNAMIC_BOUNDARY 标记分隔了
    "静态部分"（不变的通用指令）和"动态部分"（每次可能不同的上下文）。
    """

    def __init__(self):
        self._output_style_name: Optional[str] = None
        self._output_style_prompt: Optional[str] = None
        self._os_name: Optional[str] = None
        self._os_version: Optional[str] = None
        self._project_context: Optional[ProjectContext] = None
        self._append_sections: List[str] = []

    def with_output_style(self, name: str, prompt: str) -> "SystemPromptBuilder":
        self._output_style_name = name
        self._output_style_prompt = prompt
        return self

    def with_os(self, os_name: str, os_version: str) -> "SystemPromptBuilder":
        self._os_name = os_name
        self._os_version = os_version
        return self

    def with_project_context(self, ctx: ProjectContext) -> "SystemPromptBuilder":
        self._project_context = ctx
        return self

    def append_section(self, section: str) -> "SystemPromptBuilder":
        self._append_sections.append(section)
        return self

    def build(self) -> List[str]:
        """构建最终的 system prompt sections — 源码 prompt.rs:134-156

        返回的 sections 列表结构:

        [0] 介绍（你是什么）
        [1] 输出风格（可选）
        [2] 系统规则
        [3] 任务指南
        [4] 行动准则
        ─── DYNAMIC BOUNDARY ───  ← 缓存边界
        [5] 环境信息（日期、CWD、平台）
        [6] 项目上下文（git status、git diff）
        [7] 指令文件（CLAUDE.md 内容）
        [8+] 追加的自定义 section
        """
        sections = []