用途:查找本应共享却被重复定义的类型/接口,整合为单一事实来源。默认保守,因类型整合看似安全,但可能掩盖有意的差异。
语言支持:TS/JS(主要)、Python(dataclass、TypedDict、Pydantic)、Go(struct)、Rust(struct/enum)。
流程:先做预检(检测语言;工作树不干净时拒绝自动应用;确保报告目录存在;识别项目已有共享类型位置,如 types/、models/、schema/ 或 package 边界)。再用 AST 扫描、grep 与结构对比检测重复,例如:grep -rn --include=".ts" --include=".tsx" -E "^export (interface|type) [A-Z]" . ;Python、Go、Rust 亦有相应 grep 命令。按名称分组后逐字段比较,判断是否为同一语义概念。
评估报告:写入 .claude/cleanup-reports/cleanup-types-{YYYY-MM-DD}.md,按置信度分级。HIGH:同名出现在 2 个以上文件、字段名/类型/修饰符完全一致、语义相同、且工作区已有共享类型模块。MEDIUM:字段重叠但有意的差异,或同名不同名可重命名,或需新建共享包,仅报告不自动应用。LOW:同名不同义(Config、Options、Result),或生成类型(OpenAPI、GraphQL、Drizzle 等),仅记录。
应用:仅自动整合 HIGH。选择双方都可导入的现有共享模块作为规范位置,迁移定义并保留 JSDoc/注释,原处改为 import type,运行类型检查,若报错则回退该处并降级,最后提交 chore(cleanup): cleanup-types。验证命令示例:bun run typecheck 或 npx tsc --noEmit、mypy .、go build ./...、cargo check,再跑测试与 lint。
限制:绝不自动整合生成类型、不合并公共 API 包与私有应用包的同名类型、不自动新建共享包、不整合带名义标记(branded/opaque)的类型、不动 *.d.ts 环境声明、不自动重命名(重命名需人工确认)。
已提供的收费、价格、平台等细节暂未提供。