OA0
OA0 是一个探索 AI 的社区
现在注册
已注册用户请  登录
OA0  ›  技能包  ›  agentlens:使用层级结构导航与理解代码库

agentlens:使用层级结构导航与理解代码库

 
  breeze ·  2026-02-01 21:49:27 · 24 次点击  · 0 条评论  

名称: agentlens
描述: 使用 agentlens 分层文档来导航和理解代码库。适用于探索新项目、查找模块、定位大型文件中的符号、查找 TODO/警告或理解代码结构。
元数据:
short-description: 使用 agentlens 进行代码库导航
author: agentlens
version: "1.0"


AgentLens - 代码库导航

开始处理任何代码库之前

始终先阅读 .agentlens/INDEX.md 以获取项目地图。

导航层级

层级 文件 用途
L0 INDEX.md 项目概览,列出所有模块
L1 modules/{slug}/MODULE.md 模块详情,文件列表
L1 modules/{slug}/outline.md 大型文件中的符号
L1 modules/{slug}/memory.md TODO、警告、业务规则
L1 modules/{slug}/imports.md 文件依赖关系
L2 files/{slug}.md 复杂文件的详细文档

导航流程

INDEX.md → 查找模块 → MODULE.md → outline.md/memory.md → 源代码文件

何时阅读什么

你需要 阅读此文件
项目概览 .agentlens/INDEX.md
查找模块 INDEX.md,搜索模块名称
理解模块 modules/{slug}/MODULE.md
在大型文件中查找函数/类 modules/{slug}/outline.md
查找 TODO、警告、规则 modules/{slug}/memory.md
理解文件依赖关系 modules/{slug}/imports.md

最佳实践

  1. 不要直接阅读源代码文件(对于大型代码库)——先使用 outline.md
  2. 修改代码前检查 memory.md,查看警告和 TODO
  3. 使用 outline.md 定位符号,然后仅阅读所需的源代码部分
  4. 如果文档看起来过时,使用 agentlens 命令重新生成

有关详细导航模式,请参阅 references/navigation.md
有关结构说明,请参阅 references/structure.md

24 次点击  ∙  0 人收藏  
登录后收藏  
0 条回复
关于 ·  帮助 ·  PING ·  隐私 ·  条款   
OA0 - Omni AI 0 一个探索 AI 的社区
沪ICP备2024103595号-2
耗时 45 ms
Developed with Cursor