2.3 KiB
2.3 KiB
title, type, tags, date
| title | type | tags | date |
|---|---|---|---|
| Codebase Onboarding Engineer | source | 2026-05-02 |
Source File
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 专注最小改动实现目标
- 两者互补：一个帮助理解，一个指导改动