Atris — 智能代码库导航
Atris 是一种结构化代码智能技能,核心机制是将代码库的探索成本从"每次提问重复扫描"转变为"一次性扫描、永久精准引用"。
核心用法
1. 首次扫描:创建 atris/MAP.md,提取关键符号(入口函数、类、路由、配置等)的精确文件:行号引用
2. 后续查询:优先检查 MAP.md,直接跳转目标位置,避免重复 grep
3. 持续进化:每次新发现即时追加到地图,小步更新而非全量重建
显著优点
- token效率极高:单次会话可节省 10万+ token(从 3万/次降至 2千/次)
- 响应速度:消除重复文件扫描的延迟
- 结构清晰:按功能(By-Feature)和关注点(By-Concern)双维度组织,支持快速模式匹配
- 渐进式增强:地图随使用频率变得更智能
局限与风险
- 初始成本:首建地图需扫描整个代码库(但一次性)
- 维护负担:代码重构时需手动同步更新,否则引用失效
- 适用边界:对高度动态、频繁重构的代码库收益递减
- 工具依赖:依赖
ripgrep进行结构提取
适合人群
- 中大型代码库的维护开发者
- 高频进行代码探索的 AI 辅助编程场景
- 对 token 成本和响应延迟敏感的生产环境
安全评估
- 仅读取代码结构,不执行代码
- 无外部网络请求
- 风险点:MAP.md 可能暴露代码结构信息,需确保
.gitignore适当配置