SuperAPI AI 工具集

system-atlas

前端与建站

查看项目

更新于 10-16 02:33

技能介绍

用途:把架构讨论变成可点击探索的等距地图。适合系统尚新、术语与决策仍在变化、需要多轮反馈的场景,如“make an atlas”“map the system”“让架构可探索”。不适用于一次性静态图、只需 README 的成品系统或单个 PR 配图。

主要能力:一个 data.mjs 数据文件同时渲染两种视图——自包含的交互式等距地图 atlas.html(悬停阅读、点击固定、进入内部看步骤、可检查移动的数据包、按章节逐步揭示系统),以及生成的文本孪生 SYSTEM.md(决策表、每个结构、流程、按 ID 的开放问题)。支持渐进式披露、跨反馈轮次的问题跟踪和可重复的更新循环。

使用方式:需 Node.js(仅用 node:fs、node:path、node:url,无需 npm install)和静态服务器验证(npx serve 或 python3 -m http.server)。命令:mkdir -p <atlas home>/atlas;cp <skill>/assets/{template.html,build.mjs} <atlas home>/atlas/;cp <skill>/assets/data.example.mjs <atlas home>/atlas/data.mjs 后填写;node <atlas home>/atlas/build.mjs 生成 ../SYSTEM.md 和 ../atlas.html。data.mjs 是唯一编辑对象,template.html 与 build.mjs 仅负责呈现,生成文件不可手改。

流程要点:先读输入再画图,先讨论再画图;首版覆盖整个系统;约十章渐进披露,每章最多加三个结构并跑一条小流程,末章展示全部并带流程选择器;每个角色配形状与可读名称标签;问题用 Q-<code><n> 编号并记录状态(open、resolved、routed);深挖结果回填数据;每次变更后重建并重新发布同一 URL。

限制与注意:atlas.html 为单文件,除 Google Fonts 样式表外无外部资源;需用静态服务器验证,部分应用内浏览器把 file:// 渲染为静态快照;保持 <!doctype html> 在最前、<meta charset="utf-8"> 紧随其后;避免在悬停处理器中调用 render();不要删除问题,只解决或标记丢弃;决策变更后要全局搜索过时措辞。CONTEXT.md 为手工术语表,adr/ 记录难以逆转的决策,research/ 存放证据。官方未提供收费、价格或平台信息。