48 lines
2.3 KiB
Markdown
48 lines
2.3 KiB
Markdown
---
|
||
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 专注最小改动实现目标
|
||
- 两者互补：一个帮助理解，一个指导改动
|