Atris

🗺️ 一次扫描,永久精准导航代码库

通过构建结构化代码地图(MAP.md)实现一次性扫描永久引用,节省80-95%的代码探索token消耗。

收藏
7.6k
安装
2k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

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 适当配置

Atris 内容

手动下载zip · 2.5 kB
SKILL.mdtext/markdown
请选择文件