SuperAPI AI 工具集

cartographer

编程与开发

查看项目

更新于 10-16 07:17

技能介绍

用途:为代码仓库生成持久、可审查的项目地图,帮助人和智能体快速理解结构,不臆造架构或行为。主要输出为 Tree.txt(经过整理、确定性的目录树)和 docs/PROJECT_MAP.md(链接关键产物的索引)。该技能只映射已存在的内容,不决定系统应如何工作。

主要能力:生成确定性输出(稳定排序、稳定排除规则);若产物已存在,则以最小差异就地更新。支持可选参数:--tree、--map、--all、--max-depth <n>。

使用方式:从仓库根目录或指定路径执行:python3 scripts/project_ops/cartographer.py --all。使用前需确认仓库根目录、确认仓库本身不是 .codex/,并检查 docs/ 是否存在(仅在需要输出时创建)。

适用场景:仓库显著增长或重构后;新贡献者或智能体加入时;跨领域重构前后;发布或审查治理产物之前。

限制:不得将输出写入 .codex/(仅运行时使用);不得修改应用代码;不得臆造架构、意图或规则。不能替代 ARCHITECTURE.md、系统图或决策记录。未来可选扩展(非必需)包括 docs/diagrams/system/* 与同目录的 *.state-machine.md。