用途
Codebase Navigator 用于在探索代码、查找文件或理解项目结构时优先使用。它帮助开发者浏览、搜索并理解 Resume Matcher 代码库，支持 ripgrep、ack 或 grep。
主要能力
- 搜索函数、类、组件、类型等符号定义。
- 查找 API 端点与路由处理函数。
- 追踪 API 端到端调用流程。
- 追踪某个数据字段从后端到前端的流动。
- 查找组件层级关系。
- 查找某个符号被哪些位置调用，以及某个文件的依赖。
使用方式
技能提供封装脚本，执行常见搜索：
查找函数/方法：
.agents/skills/codebase-navigator/scripts/search.sh functions <pattern>
查找 React 组件：
.agents/skills/codebase-navigator/scripts/search.sh components <pattern>
查找 API 端点：
.agents/skills/codebase-navigator/scripts/search.sh endpoints
追踪 API 端到端流程：
.agents/skills/codebase-navigator/scripts/trace.sh api-flow
追踪数据字段从后端到 UI：
.agents/skills/codebase-navigator/scripts/trace.sh data-flow <field_name>
查找组件层级：
.agents/skills/codebase-navigator/scripts/trace.sh component-tree
也提供直接的 ripgrep 模式，例如查找任意符号、Python 函数定义、React 组件使用、Pydantic 模型、API 路由处理函数。
常用工作流示例：
- “X 定义在哪里”：search.sh functions / components / classes / types。
- “什么调用了 X”：search.sh usage / deps。
- “功能 X 的数据如何流动”：trace.sh api-flow resumes、trace.sh data-flow personalInfo、trace.sh component-tree ResumeEditor。
文档与项目结构
技能指向以下文档：后端架构、前端架构、API 契约、API 流图，以及完整文档索引 docs/agent/README.md。
项目布局：apps/ 下包含 backend/app/（main.py FastAPI 入口、config.py、database.py TinyDB 封装、llm.py LiteLLM 封装、routers/、services/、schemas/、prompts/）与 frontend/（app/ 页面、components/、lib/、hooks/、messages/ 多语言）。
关键入口：后端启动 apps/backend/app/main.py；前端页面 apps/frontend/app/；API 客户端 apps/frontend/lib/api.ts 或 lib/api-client.ts；设计令牌 apps/frontend/app/globals.css；简历 schema apps/backend/app/schemas/；LLM 提示词 apps/backend/app/prompts/。
参考 references/REFERENCE.md 可获取完整 ripgrep 速查表与高级搜索模式。
限制
本技能面向 Resume Matcher 代码库，其他项目的适用性暂未提供；具体安装步骤与依赖要求暂未提供。