---
title: "Codebase Onboarding Engineer"
type: source
tags: []
date: 2026-05-02
---

## Source File
- [[Agent/agency-agents/engineering/engineering-codebase-onboarding-engineer.md]]

## Summary（用中文描述）
- 核心主题：AI Agent 角色定义，帮助新开发者快速理解陌生代码库的专业引导者
- 问题域：开发者 onboarding 效率、代码库结构理解、代码路径追踪
- 方法/机制：通过读取源码、追踪执行路径、仅陈述有代码依据的事实来构建准确的心智模型
- 结论/价值：让新开发者 5 分钟内找到主入口点，缩短 onboarding 时间

## Key Claims（用中文描述）
- Agent 必须在代码中能找到证据时才陈述模块拥有某行为
- 永远只陈述有源码支撑的事实，不推理、不假设、不猜测
- 解释必须分三个层次：一句话概述 → 五分钟高层解释 → 深度代码流分析
- 严格保持只读模式，绝不修改文件或生成补丁

## Key Quotes
> "Never state that a module owns behavior unless you can point to the file(s) that implement or route it." — 证据优先原则
> "If something is not visible in the code you inspected, do not state it." — 诚实告知检查范围
> "State only facts grounded in the code that was actually inspected." — 事实唯一准则

## Key Concepts
- [[CodebaseOnboarding]]：帮助新开发者快速理解陌生代码库的方法论和实践
- [[ExecutionTracing]]：追踪请求、事件、命令在系统中的完整执行路径
- [[EvidenceFirstReasoning]]：只陈述代码中可验证的事实，不进行推理或假设
- [[MentalModel]]：为开发者构建准确、可理解的项目结构心智模型
- [[ThreeTierExplanation]]：一/五/深的分层解释结构

## Key Entities
- （本文档为纯 Agent 角色定义，未涉及具体人物或公司实体）

## Connections
- [[EngineeringMinimalChangeEngineer]] ← related_to ← [[CodebaseOnboardingEngineer]]
- [[EngineeringSeniorDeveloper]] ← related_to ← [[CodebaseOnboardingEngineer]]
- [[EngineeringCodeReviewer]] ← related_to ← [[CodebaseOnboardingEngineer]]

## Contradictions
- 与 [[EngineeringMinimalChangeEngineer]] 侧重点不同：
  - Codebase Onboarding Engineer 专注快速理解代码库结构
  - Minimal Change Engineer 专注最小改动实现目标
  - 两者互补：一个帮助理解，一个指导改动