diagram

Diagram 技能是专为实践“图表驱动开发”(DDD) 的开发人员与架构师所设计的专业工具。它有助于建立、同步与维护储存在 ai/diagrams 存储库中的“统一影响图”。与标准的技术文档不同，DDD 着重于连接前台用户体验与后台技术实现。此技能确保每个系统图表都能成为代码库的精确反映，并强制明确定义技术组件与其交付的用户价值之间的连接。

• 使用 Mermaid 语法自动生成与更新序列图、架构图及功能流程图。

• 执行全面审计，通过交叉比对文件历史与存储库结构，检测过时或缺失的图表。

• 管理 README.md 中的所有可视化文件索引，维持系统理解的单一事实来源。

• 根据 DDD 原则验证技术图表，确保其包含影响注释、以用户为中心的进入点以及错误路径恢复记录。

• 执行严格的命名规则与组织模式（功能、旅程、架构、测试、重构），保持项目文档的易读性。

• 结合重构前/后的可视化记录，并利用颜色高亮显示系统改进，提高系统透明度。

• 用户在执行操作前，必须先通过 Read 工具读取相关参考文档（如 DDD_PRINCIPLES.md, CREATE.md, MERMAID_GUIDE.md），以确保符合质量标准。

• 输入通常包含功能规格或代码变更记录，输出则为包含 Mermaid 图表、关键洞察与清晰变更历史的结构化 Markdown 文件。

• 限制条件包括禁止使用自定义颜色（重构影响指标 #90EE90 除外），并要求每个图表必须平衡技术深度与用户导向的影响力。

• 此工具非常适合寻求减少技术债、提升新贡献者架构导入效率，并确保功能开发与用户旅程需求保持一致的敏捷团队。