用途:读取真实仓库(包清单、docker-compose、k8s、terraform、导入图)生成反映实际系统的工程图,而非脱离现实的示意图。
主要能力:四种模式共用同一流水线(DCI 环境探测→节点/边图→模板填充→指纹写入)。generate 生成架构图;diff 用 PR 差异高亮结构变更(delta-added/removed/changed);trace 将堆栈或日志转为时序图;watch 对比存储指纹检测架构漂移并输出 Markdown 报告。输出为单文件 HTML(离线可用,仅 Google Fonts 为外部依赖)加 Mermaid 文本块,深色主题、按组件角色语义配色,默认含 ARIA、reduced-motion 与键盘导航。
使用方式:命令为 /design:generate、/design:diff、/design:trace <path>、/design:watch。需 Git 仓库及至少一种清单文件,Python 3.9+。指纹写入命令:python3 ${CLAUDE_SKILL_DIR}/scripts/fingerprint.py write --input /tmp/graph.json;校验命令:python3 ${CLAUDE_SKILL_DIR}/scripts/validate_html.py $CWD/.arch/<mode>-<timestamp>.html。
适用场景:单仓库或多模块系统的架构文档、PR 结构变更说明、事故日志时序还原、架构漂移巡检。
限制:节点超过 50 个回退 Mermaid,硬上限 150 个;diff/watch 需 Git 与基线分支;未知堆栈格式仅输出 Mermaid 时序;kubectl 缺失时跳过集群叠加;docs-layout 面向宽屏,不设移动断点。具体收费与平台支持暂未提供。