用途：为任意代码仓库建立仓库内持久化上下文系统（atlas），让工程师与 LLM 智能体以最少搜索理解代码库。约束：不改变产品/运行时行为；不使用付费或托管工具，全部内容随仓库存放；零依赖或最少依赖（仅 Python 3 标准库）；生成内容必须反映真实仓库细节而非通用填充。
主要能力：生成目录树、入口点与文件统计（docs/atlas/repo-map.md），按分类生成近期提交变更日志（docs/atlas/08_CHANGELOG_LAST_14_DAYS.md，回溯窗口可调，默认 14 天）；支持配置忽略目录、目录注解、入口点文件名、路径模式、内容标记与提交约定。
使用方式：将技能自带的 scripts/generate_atlas.py 复制到目标仓库 scripts/atlas/generate_atlas.py，按仓库调整顶部配置段（IGNORE_NAMES、TREE_ANNOTATIONS、ENTRYPOINT_NAMES、ENTRYPOINT_PATH_PATTERNS、ENTRYPOINT_CONTENT_MARKERS、CONVENTIONAL_COMMITS、CHANGELOG_DAYS），运行 python3 scripts/atlas/generate_atlas.py --write 生成骨架。随后手工增强 repo-map.md，补充“Where to Look for X”路由表与 Danger Zones；按模板编写 docs/atlas/ 下 00_README 至 07_TEST_MATRIX 各文档（每篇 50-150 行，含真实路径与陷阱）；在 CLAUDE.md 增加 atlas 章节与双智能体工作流；在 Makefile 或 package.json 中加入 atlas-generate 与 atlas-check 目标；最后验证生成无错、atlas-check 退出 0、文档含真实路径且未改动运行时代码。
适用场景：新成员或 LLM 智能体快速上手大型或陌生代码库；需要文档化架构、领域模型、关键流程与测试矩阵的团队。限制：需人工完成文档撰写与配置定制，质量取决于仓库真实信息；具体收费、价格与托管平台暂未提供。