SuperAPI AI 工具集

spec-system-map

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

spec-system-map 用于创建或修订 spec/system-map.md,即项目形态的高层地图,比通用 ARCHITECTURE.md 更聚焦,记录项目级结构、边界、流程、存储/外部系统、不变量及深层文档指针。适用于架构范围与文档记录、项目尚无系统地图、或地图已偏离仓库现状时,也用于判断某项改动应归属 charter(方向)还是 capabilities(能力契约)。

模式:create 在文件缺失或首次创建时使用;amend 在文件存在且需更新架构形态、边界、流程、不变量或链接时使用。未指定模式则按文件状态路由,必要时创建 spec/ 目录。

流程:create 模式先读取 charter、README、AGENTS/CLAUDE、顶层目录、配置与架构相关文档,执行 Repo Evidence Pass 检查入口、命令、配置脚本、运行时边界、存储/状态、外部系统、测试及近期提交与执行日志,再依 templates/system-map.md 起草,包含系统形态、运行时边界、核心流程、存储与外部系统、项目级不变量、候选能力边界、后续去处等小节。棕地项目不确定边界须标为假设。完成时给出 Evidence Read 与 Evidence Missing。amend 模式仅更新项目级内容,把模块细节、端点清单、部署命令移出,能力契约改动转 spec-grill,方向改动转 spec-charter。

边界:不写成模块文档、API 参考、运行手册或实现笔记;仅保留项目级结构与不变量。质量要求读者五分钟内理解项目形态,所有内容为当前证据支持的事实而非愿景。限制与失败模式包括:仅凭 README 和顶层目录起草、内容漂移为愿景、端点清单混入流程、amend 吸收底层细节、方向或契约改动误写入地图。