第 05 章：消息被装进信封——System Prompt 的组装

// API 调用时的参数结构
{
  system: "你是一个编程助手...",     // system prompt（每轮不变）
  messages: [
    { role: "user", content: "..." },    // 用户消息
    { role: "assistant", content: "..." } // 模型回复
  ]
}

// → src/constants/prompts.ts 的 getSystemPrompt() 函数（简化版，上半部分）
export async function getSystemPrompt(
  tools: Tools,
  model: string,
  additionalWorkingDirectories?: string[],
  mcpClients?: MCPServerConnection[],
): Promise<string[]> {
  // --bare 模式：极简 prompt
  if (process.env.CLAUDE_CODE_SIMPLE) {
    return [`You are Claude Code...\nCWD: ${getCwd()}\nDate: ...`]
  }

  // 并行加载：技能命令 + 输出样式 + 环境信息
  const [skillToolCommands, outputStyleConfig, envInfo] = await Promise.all([
    getSkillToolCommands(cwd),
    getOutputStyleConfig(),
    computeSimpleEnvInfo(model, additionalWorkingDirectories),
  ])

// → src/constants/prompts.ts 的 getSystemPrompt() 返回值组装
  return [
    // --- 静态内容（可缓存）---
    getSimpleIntroSection(outputStyleConfig),      // 身份 + 安全指令
    getSimpleSystemSection(),                      // 系统行为规则
    getSimpleDoingTasksSection(),                   // 编码任务指南
    getActionsSection(),                           // 风险评估
    getUsingYourToolsSection(enabledTools),         // 工具使用指引
    getSimpleToneAndStyleSection(),                 // 语气风格
    getOutputEfficiencySection(),                  // 输出效率
    // === 缓存边界标记 ===
    ...(shouldUseGlobalCacheScope() ? [SYSTEM_PROMPT_DYNAMIC_BOUNDARY] : []),
    // --- 动态内容（注册表管理）---
    ...resolvedDynamicSections,
  ].filter(s => s !== null)

// → src/context.ts 的 getSystemContext() 函数（简化版）
export const getSystemContext = memoize(async () => {
  const gitStatus = await getGitStatus()

  return {
    ...(gitStatus && { gitStatus }),
  }
})

// → src/context.ts 的 getGitStatus() 函数
const [branch, mainBranch, status, log, userName] = await Promise.all([
  getBranch(),                          // 当前分支
  getDefaultBranch(),                   // 主分支
  execFileNoThrow(gitExe(), ['status', '--short']),  // 文件状态
  execFileNoThrow(gitExe(), ['log', '--oneline', '-n', '5']),  // 最近 5 条提交
  execFileNoThrow(gitExe(), ['config', 'user.name']),  // git 用户名
])

// → src/context.ts 的 getUserContext() 函数（简化版）
export const getUserContext = memoize(async () => {
  const claudeMd = shouldDisableClaudeMd
    ? null
    : getClaudeMds(filterInjectedMemoryFiles(await getMemoryFiles()))

  return {
    ...(claudeMd && { claudeMd }),
    currentDate: `Today's date is ${getLocalISODate()}.`,
  }
})

// → src/utils/claudemd.ts 的 @include 语法注释
// - Syntax: @path, @./relative/path, @~/home/path, or @/absolute/path
// - Included files are added as separate entries before the including file
// - Circular references are prevented by tracking processed files

// → src/utils/claudemd.ts 的 getClaudeMds() 函数（简化版）
export const getClaudeMds = (memoryFiles: MemoryFileInfo[]): string => {
  const memories: string[] = []

  for (const file of memoryFiles) {
    if (file.content) {
      const description =
        file.type === 'Project'
          ? ' (project instructions, checked into the codebase)'
          : file.type === 'Local'
            ? " (user's private project instructions, not checked in)"
            : file.type === 'AutoMem'
              ? " (user's auto-memory, persists across conversations)"
              : " (user's private global instructions for all projects)"

      memories.push(`Contents of ${file.path}${description}:\n\n${file.content}`)
    }
  }

  if (memories.length === 0) return ''

  return `${MEMORY_INSTRUCTION_PROMPT}\n\n${memories.join('\n\n')}`
}

console.log('[DEBUG] Memory files loaded:', memoryFiles.map(f => ({ type: f.type, path: f.path })))

console.log('[DEBUG] System prompt has', result.length, 'sections')
for (let i = 0; i < result.length; i++) {
  console.log(`  Section ${i}: ${(result[i] ?? '').substring(0, 80)}...`)
}