用途:seam-ripper 用于系统性剖析代码库的内部架构,找出组件接口、边界与契约中的问题,指出耦合过重、抽象泄漏、依赖方向错误等结构性缺陷,并给出应然的架构与迁移步骤。其立场是不迷信既有模式、不把向后兼容当作约束、复杂度默认有罪,接口与抽象必须自证存在的必要性。
主要能力:分四个阶段推进。第一阶段绘制地形:枚举所有模块/包/命名空间,追踪 import 与依赖图,清点公开接口(导出的函数、类、类型、常量),找出跨边界的共享类型、DTO、schema 等数据契约与集成点,输出依赖图,包括边及依赖理由、循环依赖、每模块的扇入扇出。第二阶段逐缝审问:从接口清晰度(能否仅凭公开接口理解职责、是否存在 util/helper 导出这类无明确职责的气味、是否暴露实现细节)、依赖方向(依赖是否概念上合理、低层是否依赖高层、反转后能否简化)、耦合评估(改接口会波及多少模块、耦合经由数据还是行为、能否改为事件/消息)、抽象完整性(是否泄漏实现、调用方是否在做模块内的事、是否存在多条路径做同一件事)、契约稳定性(历史改动频率、是否有版本化接口或弃用警告、测试是否 mock 该接口)等维度作答。第三阶段识别失败模式,包括上帝模块、霰弹式修改、特性依恋、不当亲密、中间人、平行继承体系、臆测性通用化、死抽象。第四阶段对每个重大问题给出指控(具体说明错在哪、为何重要)、正确架构(清晰模块边界与职责、符合概念层级的依赖方向、暴露意图而非实现的接口)、转型步骤(什么移动到哪里、拆分或合并什么、改哪些接口、出现哪些新抽象)与证据(量化耦合变化如 N 个 import 变为 M 个、职责更清晰、更易测试扩展替换)。输出采用固定结构:Seam Analysis 标题、Dependency Map、Critical Findings(每条含位置、严重度、模式、证据、指控、重设计、转型步骤)、Recommended Architecture、Transformation Sequence。红线上,拒绝保留坏架构的增量改进、拒绝以“能跑”为由、拒绝用适配器/门面掩盖问题、拒绝仅因广泛使用而保留接口。
使用方式:作为 Claude Code 技能加载后,对目标系统或区域运行,按上述四阶段产出分析报告。资料未提供具体安装命令或调用方式。
适用场景:适合架构评审、模块边界梳理、重构前诊断、依赖治理等需要深入代码内部结构的场景。
限制:其分析依赖对代码库的完整枚举与依赖图,资料未说明语言、仓库规模或工具链支持情况;明确不提供向后兼容与迁移方案(迁移被视为独立问题),也不输出代码补丁。