SuperAPI AI 工具集

diagram

编程与开发

查看项目

更新于 10-15 23:34

技能介绍

用途:维护 ai/diagrams 目录,使其成为理解系统的单一事实来源。所有图表遵循 DDD 原则,把前端(用户体验)与后端(技术实现)连接,并附清晰的影​​响注释。

主要能力:创建新图(功能、架构、用户旅程、测试、重构);在代码变更后同步更新已有图;审计过期、缺失或低质量图表;维护一致的结构与命名;保持 README.md 索引最新;按 DDD 原则做质量校验。

使用方式:执行任何图表操作前,必须先用 Read 工具加载相关参考文件。创建图读 references/CREATE.md 和 references/DDD_PRINCIPLES.md;更新读 UPDATE.md 和 DDD_PRINCIPLES.md;审计读 AUDIT.md;组织/重构读 ORGANIZE.md;了解 DDD 读 DDD_PRINCIPLES.md;Mermaid 语法帮助读 MERMAID_GUIDE.md。随后按参考文件中的模式执行、校验质量并更新 README.md 索引。

目录结构:ai/diagrams/ 下有 README.md 索引,以及 features/、architecture/、journeys/、tests/、refactoring/ 子目录。文件命名格式为 {type}-{descriptive-name}.md,类型前缀包括 feature-、sequence-、arch-、flow-、test-。

DDD 核心原则:每个图必须同时包含前端与后端、影响注释、用户动作、错误路径和相关文件;禁止自定义填充色,仅允许用 #90EE90 标注 Before/After 变化;不得只有纯技术图而无用户上下文。

适用场景:新项目初始设置、新功能、代码变更同步、图表审计、重构前后对比文档,以及代码评审、GitHub issue、chrome-devtools 测试规划、新人入职等流程集成。

限制:必须先读取参考文件,不能直接创建或修改图表;图表须与代码保持同步,过期图表比没有更糟;命名、目录和索引须一致;质量优先于数量。具体安装命令、收费与价格信息暂未提供。