Update nexus wiki content

This commit is contained in:
2026-05-03 05:42:06 +08:00
parent 90f3811b83
commit 111bc65b7b
707 changed files with 32306 additions and 7289 deletions

View File

@@ -0,0 +1,47 @@
---
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 专注最小改动实现目标
- 两者互补:一个帮助理解,一个指导改动