SuperAPI AI 工具集

atlas

编程与开发

查看项目

更新于 11-06 16:21

技能介绍

Atlas 是一个可选的“项目文件夹定向”工具,在合规的项目文件之上维护一套文件系统原生的 Map/Landmark/Satellite 方向 wiki。底层项目文件始终是权威来源,Atlas 仅作为辅助入口,探索深度应随证据需要而扩展。

用途: 用户可以让 Atlas 完成导航、编写、再平衡、验证或维护 wiki 等工作。当 Atlas 相关工作是用户的全部请求时,结尾应给出一个可选的下一步:一个围栏式、自包含的提示词,写明所需的仓库、issue、PR 或产物;或说明不需要。只有用户回答“yes”才启动,且用户以 /<skill> 命令方式运行 charter、diagnose 或 ticket 步骤。

主要能力与使用方式: 命令形式为 python <skill>/scripts/cli.py --repo-root <root> --format json [--input name=value ...] <command>;doctor 会返回下一条命令。

导航现有 wiki: 从根指引中的 Map 开始。只跟随与线索匹配的链接,每一层的读取合并到一轮:先读 Satellite 的起始目标,仅当任务跨过边界时才读交叉链接。对链接的标题章节或命名符号的定义做有界读取,仅在信息不足时扩大范围。当没有线索匹配、路线竞争或入口点被证明无效时,重新考虑路线或原生搜索;不要翻遍整个 wiki。若工作涉及编辑文件,应修正误导性线索,除非所用 skill 限制 Atlas 维护。在做出声明或决策前,检查当前项目文件。

编写或再平衡: 在更改 wiki 结构之前,先阅读信息架构(角色、线索与链接),以及编写与再平衡(映射与完成度)相关内容。

验证层级: 该校验命令为只读。编辑后运行 run 并修复每一项诊断;报告 map.map_unreadable。计数仅作为复核信号。

保持指针最新: 当工作移动、重命名、删除文件或符号,或改变其含义时,在同一工作中更新 .map/ 搜索到的每个指针;不要遍历 wiki 或重映射无关区域。这不需要新鲜度周期。若要主动进行漂移审计,阅读 freshness 与 maintenance 相关内容。

安装项目文件夹指引: setup-guidance 根据顶层 Landmark 标题和开篇段落,写入 Map 以及根 AGENTS.md 和 CLAUDE.md 中的一个块,并创建任一文件;编写、再平衡及对这些文件的编辑都以其收尾。只有用户才能添加 <!-- OPT-OUT ATLAS -->;remove-guidance 仅在明确请求时运行。

适用场景: 需要在大型或多文件项目中按线索快速定位、维护导航 wiki、校验层级结构,或在文件变动后同步指针的场景。

限制: 底层项目文件为权威来源;Atlas 为可选项。除上述命令和机制外,收费、价格、平台支持等信息暂未提供。