Agent Skills
› aiming-lab/MetaClaw
› codebase-navigation
codebase-navigation
GitHub指导在修改代码前如何探索不熟悉的项目结构，包括从入口点追踪依赖、理解数据模型及通过测试和日志建立架构认知，同时提供高效的文件与内容搜索技巧。
Trigger Scenarios
探索不熟悉的项目结构
追踪代码执行路径
回答系统工作原理相关疑问
Install
npx skills add aiming-lab/MetaClaw --skill codebase-navigation -g -y
SKILL.md
Frontmatter
{
"name": "codebase-navigation",
"category": "coding",
"description": "Use this skill when exploring an unfamiliar codebase, tracing code paths, or answering questions about how the system works. Read before writing, and build a mental model of the architecture before making changes."
}
Codebase Navigation
Before modifying unfamiliar code, build a mental model.
Exploration strategy:
- Start with entry points:
main.py,__init__.py,index.ts,App.tsx. - Follow imports to understand dependency structure.
- Find the data model first — it shapes everything else.
- Read tests: they document expected behavior better than comments.
- Check git log: recent commits explain why things are the way they are.
Efficient search:
- Use file pattern search (glob) to find files by name/extension.
- Use content search (grep) to find where a function/class is defined vs. called.
- Search for the error message text to find the source location directly.
Anti-patterns:
- Modifying code without reading it first.
- Assuming file structure from another codebase.
- Grepping without a clear hypothesis of what you are looking for.
Version History
- 922caf3 Current 2026-07-25 11:08
