Agent Skills
› viralcode/openwhale
› agentlens
agentlens
GitHub提供代码库层级导航能力，通过索引和模块文档快速定位符号、理解结构及发现待办事项。适用于探索新项目、分析大型文件依赖及避免直接阅读源码的低效操作。
触发场景
探索新项目的整体架构
在大型代码库中查找特定模块或函数
分析文件间的依赖关系
查找代码中的TODO或警告
安装
npx skills add viralcode/openwhale --skill agentlens -g -y
SKILL.md
Frontmatter
{
"name": "agentlens",
"metadata": {
"author": "agentlens",
"version": "1.0",
"short-description": "Codebase navigation with agentlens"
},
"description": "Navigate and understand codebases using agentlens hierarchical documentation. Use when exploring new projects, finding modules, locating symbols in large files, finding TODOs\/warnings, or understanding code structure."
}
AgentLens - Codebase Navigation
Before Working on Any Codebase
Always start by reading .agentlens/INDEX.md for the project map.
Navigation Hierarchy
| Level | File | Purpose |
|---|---|---|
| L0 | INDEX.md |
Project overview, all modules listed |
| L1 | modules/{slug}/MODULE.md |
Module details, file list |
| L1 | modules/{slug}/outline.md |
Symbols in large files |
| L1 | modules/{slug}/memory.md |
TODOs, warnings, business rules |
| L1 | modules/{slug}/imports.md |
File dependencies |
| L2 | files/{slug}.md |
Deep docs for complex files |
Navigation Flow
INDEX.md → Find module → MODULE.md → outline.md/memory.md → Source file
When To Read What
| You Need | Read This |
|---|---|
| Project overview | .agentlens/INDEX.md |
| Find a module | INDEX.md, search module name |
| Understand a module | modules/{slug}/MODULE.md |
| Find function/class in large file | modules/{slug}/outline.md |
| Find TODOs, warnings, rules | modules/{slug}/memory.md |
| Understand file dependencies | modules/{slug}/imports.md |
Best Practices
- Don't read source files directly for large codebases - use outline.md first
- Check memory.md before modifying code to see warnings and TODOs
- Use outline.md to locate symbols, then read only the needed source sections
- Regenerate docs with
agentlenscommand if they seem stale
For detailed navigation patterns, see references/navigation.md For structure explanation, see references/structure.md
版本历史
- 238a4b1 当前 2026-08-20 08:20
