用途:这是一个代码审查技能,用于分析代码库的模块化失衡。它基于 Vlad Khononov 的 Balanced Coupling 模型(由 balanced-coupling 技能预加载),产出一份模块化审查,指出具体设计问题,并从知识封装、复杂度、级联变更以及如何改进设计等角度解释每个问题。
主要能力:按四步流程工作,并用 TaskCreate 跟踪:理解问题域、映射集成关系、应用平衡规则、撰写审查。审查会识别组件共享了哪些知识(实现细节、业务规则、领域模型或集成契约)、集成强度(intrusive、functional、model、contract)、距离(同模块、同服务、不同服务、不同系统;同团队或不同团队;同步或异步)以及波动性,再对每个集成套用 BALANCE = (STRENGTH XOR DISTANCE) OR NOT VOLATILITY,标出既不平衡又易变的集成。最终使用 document 技能产出 Markdown 和 HTML 两种格式的审查文档。
使用方式:交互固定使用 AskUserQuestion,一次只问一个问题,优先给出 2-4 个具体选项,标题最多 12 字符,如 Scope、Domain、Teams、Pain points。先读取 docs/ 下的功能需求文档和代码本身,再用 LSP(findReferences、goToDefinition)、Grep、Glob 导航,不靠猜测;随后先呈现对组件、职责、集成模式和领域分类的理解,再请用户确认或纠正,并针对真正影响评估的信息缺口提问。
适用场景:审查现有代码的模块化设计、定位变更昂贵或部署易出问题的区域、评估核心/支撑/通用子域的耦合是否合理。
限制:不只看结构就下结论,必须阅读实际集成点;不从单一维度评估耦合,需同时考虑强度、距离与波动性;区分本质波动与偶然波动;不逐一标记所有小问题,聚焦既不平衡又易变的关键集成;不建议“全部解耦”,因为分解会增加距离;需考虑组织维度,同一代码结构在不同团队下有效距离更高。具体命令与技能安装方式文中未提供。