Absolute Debt 是一个用于偿还代码库中累积的 lint 与类型检查债务的技能。它面向的是仓库中既有的警告、错误以及抑制注释(如 @ts-ignore、# type: ignore)——这些债务随时间积累,需要安全、分批地清理。其目标是实现真正干净的 lint 与类型检查,而不是仅仅让报告变得安静。
用途
Absolute Debt 用于清理代码库中预先存在的、跨仓库的 lint 与类型检查违规。典型使用场景包括:修复 lint 警告、清理类型错误、让代码库达到严格模式(strict mode)。它也用于收紧配置(启用某条规则、提高 tsconfig 严格度)并清理由此产生的连带问题,以及清除累积的 eslint-disable、@ts-ignore、# type: ignore 等抑制注释。
该技能与 simplify 有明确分工:simplify 改善你当前工作 diff 的质量;debt 清理的是绿色主干(green main)上预先存在的、跨仓库的 lint/类型违规。debt 用于常设的清理工作,而不是你正在进行的改动。
主要能力
该技能运行共享引擎 references/health-engine.md,遵循 DETECT → SCAN → TRIAGE → FIX → VERIFY → REPORT 循环与安全契约。它扫描的生态与债务类型包括:
- JS/TS:lint 债务使用 eslint .(完整报告,按规则分组);类型债务使用 tsc --noEmit。
- Python:lint 债务使用 ruff check / flake8;类型债务使用 mypy / pyright。
- Go:lint 债务使用 golangci-lint run;类型债务使用 go vet ./...、staticcheck。
此外,它还会将抑制注释本身作为债务进行清点:eslint-disable*、@ts-ignore/@ts-expect-error、# type: ignore、# noqa、//nolint。每一条抑制注释都是一个隐藏的违规。违规按规则(而非按文件)分组计数,这是分批处理的基础。
使用方式
该技能按风险将债务分为四批(wave),并给出默认处理策略:
- 第 1 批:可自动修复的 lint(eslint --fix、ruff --fix、gofmt)。默认立即修复——机械且安全。
- 第 2 批:按规则手动修复的低行为风险 lint(未使用、风格、导入)。默认本轮修复,一次一条规则。
- 第 3 批:类型错误,以及修复不当可能改变行为的 lint 规则。默认设门槛——逐条审查,可能需要真正的逻辑修改。
- 第 4 批:移除抑制注释(@ts-ignore 等)。默认设门槛——每一条都可能暴露真实 bug。
修复策略是每批跨仓库修复一条规则,而不是一个文件修复所有规则——这样 diff 可审查、回归可二分定位。配置收紧(启用规则/提高严格度)本身也是一个发现项:先提出建议,再清理它暴露出的问题。
修复与验证流程:先运行自动修复器(第 1 批),达到可提交状态,然后重新扫描以确认哪些是真正需要手动处理的。手动修复要解决根因而非症状——类型错误意味着某处类型有误,应修复类型,而不是 cast 成 any 或添加 # type: ignore。绝不通过抑制来清除违规;移除抑制才是目标,抑制不是工具。每批之后运行完整的测试 + lint + 类型检查 + 构建。违规数量必须下降,且不能有任何回归。
适用场景
适用于需要对既有代码库进行常设清理的团队或个人,尤其是当仓库中积累了大量 lint 警告、类型错误或抑制注释时。也适用于准备开启严格模式、收紧 lint 配置,或希望系统性移除 @ts-ignore 等抑制注释的场景。
限制与注意事项
该技能明确列出若干陷阱:通过抑制来修复(用 @ts-ignore 清除类型错误只会增加债务,此处禁止);用 any/cast 取胜(让检查器沉默,却保留了 bug,应修复真实类型);一个文件修复所有规则的批次(混合关注点,不可审查,应一条规则跨所有文件);未经审查的自动修复(--fix 可能改变行为,例如对通过 bug 重新赋值的变量应用 prefer-const,自动修复后也要运行测试);禁用规则而非修复(为达到零而放宽配置是债务洗白,不是偿还)。
配套命令包括:/absolute simplify(改善你当前正在修改的代码质量)、/absolute prune(清理死代码后,许多未使用变量/导入警告会消失)、/absolute work(如果清理债务需要真正的重构,则移交处理)。
关于该技能的收费、价格、平台支持等具体信息,资料中暂未提供。