Prompts模块的架构与设计思想解读
面向工程师与架构师的系统提示构建与历史压缩设计
architecture 模块职责概览
settings_suggest getCoreSystemPrompt
按”运行环境 + 工具生态 + 安全准则 + 工作流范式”拼装系统提示，支持从本地文件覆盖与追加用户记忆
compress getCompressionPrompt
提供”历史压缩/状态快照”专用提示模板，要求模型先在私有scratchpad思考，再输出结构化XML
在线行为治理
长期记忆治理
分别对应”如何工作”与”如何记住”
lightbulb 设计目标与核心理念
- 提示即策略：将产品/安全/工程规范显式编码到系统提示，使智能体保持一致行为
- 环境自适应：提示文本根据运行时环境自动注入相应注意事项与最佳实践
- 可配置与可外置：支持通过环境变量读写本地Markdown作为系统提示的覆盖/落盘来源
- 安全与可控：强调路径绝对化、解释关键命令、避免交互式死锁以及尊重用户确认
- 可观测性与可复现：以”文字化规范 + 示例策略 + Git约束提示”构建可复现的操作轨迹
build_circle 核心功能详解
settings_suggest 系统提示构建
- 外置化与覆盖策略：通过GEMINI_SYSTEM_MD控制从文件覆盖默认系统提示，通过GEMINI_WRITE_SYSTEM_MD将内置默认提示写回文件
- 结构化”行为准则”：包含Core Mandates、Primary Workflows、Operational Guidelines、Security and Safety、Tool Usage等段落
- 环境自适应注入：依据SANDBOX环境变量动态注入差异化的能力边界描述，在Git仓库下自动注入提交规范
- 用户记忆拼接：以分隔线形式追加用户记忆到系统提示尾部
compress 历史压缩提示
- 可迁移的记忆：压缩后的XML是唯一可供后续续航的状态来源，促使模型保留一切关键上下文
- 强结构化：用固定schema保证信息密度与可解析性，便于后续自动化与可视化
security 安全与工程治理
- Fail Fast：外置系统提示开启时，缺失文件立即抛错；对路径做~展开与绝对化解析
- 工具优先与解释义务：在执行关键命令前，系统提示要求”先解释再执行”
- 并行化与非交互约束：搜索类任务并行化；对交互式命令持谨慎姿态
- Git风格与审核友好：强化变更前的自检，强调提交信息质量与”为何修改”
psychology 设计哲学小结
- 策略下沉到提示：将”如何安全、如何工程化、如何与工具协作”的原则固化到系统提示中
- 环境驱动的自适应：提示文本根据运行环境动态变化，提升准确性与可解释性
- 可配置、可外置、可落盘：通过环境变量即插即用地覆盖/写入，服务于企业规模化治理
- 强结构化的长时记忆：以XML快照管理历史，确保信息密度、可移植性与可编排性