用途:该技能用于对 TypeScript 代码库进行质量评分与修复,主要面向清理重复、混乱的 AI 生成代码,同时保留行为、公共契约与交付安全。
主要能力:
- 从结构组织、文件放置、封装与 API 表面、模块化与内聚、DRY 与抽象质量、可测试性、类型安全、错误处理、文档与意图清晰度、回归与变更安全等维度按 1-5 分评分,并采用 High=3、Medium=2、Low=1 的权重计算加权百分比;总评分为 Excellent(87-100%)、Good(70-86%)、Adequate(50-69%)、Weak(30-49%)、Insufficient(<30%)。
- 对超大文件设置硬性门槛:>250 LOC 警告、>350 LOC 高优先级需重构规划、>500 LOC 视为关键风险,并设置评分上限;同时检查顶层导出数超过 10、函数超过 60 行、混合关注点、单模块超过 3 个副作用依赖等结构触发条件。
- 要求先制定拆分计划,分阶段重构(每轮最多 2 次提取),每阶段后用 lint:fix、typecheck、build、test、test:e2e 验证。
- 使用 plan/code-quality-audit-tracking.md 作为追加式审计日志,plan/repo-organization-map.md 作为文件夹意图与依赖边界的事实来源;缺失时从 references 下对应模板创建。
- 每个发现须包含严重程度、置信度与证据(path:line 及具体不匹配),不接受无依据或仅风格的意见。
使用方式:先建立或更新跟踪文件并定义目标批次,每轮处理 10-20 个文件,逐文件评分、记录发现、记录放置状态、列出优先改进项;高置信且安全的改进立即实施,否则先记录开放问题;验证后记录结果、分数变化、未解决问题与下一批次。
限制与安全边界:不改变公共 API/契约,除非明确要求并记录;不做单轮大范围重写;不做无证据的推测性重构;不做仅风格变动。每轮默认编辑预算为最多改动 3 个非测试文件、净变更约 200 行;超出则停止并记录分阶段后续工作。文件移动需高置信且有明确地图证据,优先小范围局部移动,移动前最多 10 个文件后重新验证。失败时区分真实实现缺陷与设计歧义,前者修复,后者回滚并记录开放问题,相关测试运行两次以防偶发。为节省上下文,只读取目标文件及直接相关邻居,报告保持紧凑。