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
