用途:design-sync 用于验证 DESIGN.md 是否准确反映当前代码库架构,适合在架构变更后、提交前或定期维护时运行。
主要能力:检查 internal/ 下新增或删除的目录是否与文档一致;提取 DESIGN.md 中的文件与行号引用并验证是否仍指向正确代码;查看自上次更新以来变更的文件,判断是否影响已记录的抽象(如 BubbleTea Model/Update/View、Git 服务信号量、屏幕管理栈、主题系统、配置级联);对比当前包导入图与文档依赖图,标记新增、移除或循环依赖;核对主题字段数量;检查文档是否超过 90 天未更新。
使用方式:在项目目录中调用 /design-sync,技能会执行一系列命令收集目录列表、文档片段、文件引用、git 日志、导入图和主题字段计数,然后按“已同步”“需小更新”“需大更新”“建议操作”四类输出结果。典型流程为:完成架构变更后运行,根据建议修改 DESIGN.md,更新“Last updated”日期,再次运行确认显示已同步,最后一并提交。
适用场景:新增 internal/ 包、重构关键文件、改变架构模式、新增屏幕类型或主题字段、修改配置级联规则,以及季度维护、发布前检查或合并大型架构 PR 后。
限制:资料未提供该技能的安装方式、依赖环境、支持的语言或框架范围、收费信息及具体平台兼容性;其检查逻辑主要面向 Go 项目与 lazyworktree 仓库结构,其他项目需自行调整。