inkboard/system-atlas

解决的问题

System Atlas 解决了过时且静态的架构图问题。与其手动绘制的图很快变成"谎言"，不如使用单一真实来源（数据文件）来生成交互式等轴图地图和详细的基于文本的文档文件（SYSTEM.md），确保系统视觉描述与文字描述始终保持同步。

如何工作

该工具基于一个简单的构建流程：用户或 AI 代理编辑包含系统结构、流程和决策的 data.mjs 文件。随后，构建脚本（build.mjs）将此数据通过模板处理，生成两个输出：

1. 交互式 HTML 地图：一个自包含的等轴可视化图，用户可悬停查看结构信息，点击查看执行步骤，并观察数据包在组件间移动的过程。
2. 文本孪生文件：包含决策表、流程表和待办问题索引的 SYSTEM.md 文件。

适用人群

专为需要向他人传达复杂系统设计的开发人员和架构师设计，也适用于通过 skills CLI 与 AI 代理协作，能够基于仓库变更自动映射流程或更新架构文档的场景。

主要亮点

• 渐进式披露：将系统划分为“章节”，防止信息过载，逐步揭示结构。
• 简洁直观的视觉表达：为不同角色（大脑、存储、工具堆等）使用特定的等轴形状，无需图例即可清晰理解地图。
• 可检查的数据流：将真实请求可视化为移动的点，点击可查看 JSON 负载内容。
• 稳定的疑问追踪：为开放问题分配稳定 ID（如 Q-<code><n>），可在多个设计轮次中追踪反馈与解决状态。
• AI 代理就绪：以「技能」形式提供，教会 AI 代理特定的设计语言和流程，用于创建和维护地图。