Class SystemPromptBuilder

mini_claude_code/prompt.py:234–417

# ============================================================

class SystemPromptBuilder:
    def __init__(self):
        self._os_name: Optional[str] = None
        self._os_version: Optional[str] = None
        self._project_context: Optional[ProjectContext] = None
        self._config = None  # RuntimeConfig, 用 duck typing 避免循环依赖
        self._append_sections: list[str] = []

    def with_os(self, name: str, version: str) -> "SystemPromptBuilder":
        """源码: prompt.rs:109-113"""
        self._os_name = name
        self._os_version = version
        return self

    def with_project_context(self, ctx: ProjectContext) -> "SystemPromptBuilder":
        """源码: prompt.rs:116-119"""
        self._project_context = ctx
        return self

    def with_config(self, config) -> "SystemPromptBuilder":
        """源码: prompt.rs:122-125"""
        self._config = config
        return self

    def append_section(self, section: str) -> "SystemPromptBuilder":
        """源码: prompt.rs:128-131"""
        self._append_sections.append(section)
        return self

    def build(self) -> list[str]:
        """构建系统提示词分段列表。源码: prompt.rs:134-156

        结构:
        [0-4] 静态部分 (可缓存)
        [---] DYNAMIC_BOUNDARY
        [5+]  动态部分 (每次可能变)
        """
        sections: list[str] = []

        # --- 静态部分 (边界以上，可缓存) ---
        sections.append(self._intro_section())
        sections.append(self._system_section())
        sections.append(self._doing_tasks_section())
        sections.append(self._actions_section())

        # --- 动态边界 ---
        sections.append(SYSTEM_PROMPT_DYNAMIC_BOUNDARY)

        # --- 动态部分 (边界以下) ---
        sections.append(self._environment_section())

        if self._project_context is not None:
            sections.append(self._render_project_context())
            if self._project_context.instruction_files:
                sections.append(self._render_instruction_files())

        if self._config is not None:
            sections.append(self._render_config_section())