stacklit
一键为代码仓库生成AI智能体可读的索引，大幅降低Agent理解成本。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：stacklit。 它的用途是：一键为代码仓库生成AI智能体可读的索引，大幅降低Agent理解成本。 完整的 Skill 内容见：https://321skill.com/skills/stacklit/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
当你需要让AI智能体帮你在一个陌生的开源项目（如FastAPI）中添加新功能时，可以
对AI说：“请参考本项目根目录下的 stacklit.json 文件来理解代码结构，然后在 src/api/ 目录下创建一个新的用户信息查询接口。” AI智能体会先读取这个轻量级索引，瞬间了解模块划分和依赖关系，从而直接开始编写业务代码，省去了大量前期文件扫描的时间。
介绍
Stacklit 解决了AI编码智能体在理解大型代码库时消耗大量上下文窗口和时间的痛点。传统上，智能体需要扫描数十万行代码来构建项目结构认知，而Stacklit通过一个命令（如 npx stacklit init）即可自动扫描代码库，并生成一个轻量级的、结构化的索引文件（stacklit.json）。这个文件包含了模块划分、依赖关系、关键函数签名和项目提示等信息，使AI智能体能瞬间掌握项目全貌。
使用极其简单，只需在项目根目录运行初始化命令，它会生成三个文件：核心索引文件stacklit.json、依赖关系图DEPENDENCIES.md以及一个可交互的可视化地图（stacklit.html）。用户只需将前两个文件提交到代码仓库即可。此外，它还提供GitHub Action，可在CI/CD中自动更新索引，确保索引与代码同步。
这个工具非常适合任何需要让AI智能体（如Claude Code、Cursor、Aider等）高效协作或理解其代码库的开发者，尤其是全栈开发、后端开发和智能体开发者。对于开源项目维护者或大型团队项目，引入AI辅助时，它能显著提升协作效率。
建议将stacklit.json视为项目文档的一部分进行版本管理。对于频繁变更的项目，强烈建议集成其GitHub Action以实现索引的自动更新，避免索引过时。注意，它生成的是静态索引，对于实时变化的代码（如开发中未提交的更改），需要重新运行命令来更新。
核心特点
与同类代码索引工具相比，Stacklit的核心区别在于其极致的轻量化和针对性：它生成的索引文件极小（约4000个Token），专为优化AI智能体的Token消耗而设计，而非提供复杂的代码搜索或分析功能；同时，它提供“一键式”的完整工作流，从生成索引、可视化到CI集成和主流AI开发工具（Claude Code, Cursor, Aider）的自动配置，开箱即用。
注意事项
不适合需要深度、实时代码语义分析或复杂重构建议的场景，它主要提供结构概览而非细节逻辑分析。
常见问题
Stacklit 会扫描并上传我的代码吗？
不会。所有处理都在本地完成，生成的索引文件（stacklit.json）也保存在你的本地项目中，你可以选择是否将其提交到你的代码仓库。
生成的 stacklit.json 文件应该提交到 Git 吗？
是的，建议提交。这样，任何访问该仓库的AI智能体（或其他开发者）都可以直接使用这个索引来快速理解项目结构。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/stacklit/raw/index.md 读取 stacklit 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/stacklit/raw/index.md（查看排版版本）