Housekeeper 是一个用于代码项目维护的保守型清理技能,其核心目标是每次只找出并应用一项已被证明低风险的清理,同时保持现有行为不变,并保护无关工作不被改动。
用途:适用于代码项目已积累小维护问题,例如死代码(不可达或未使用代码)、过期文件或注释、未使用依赖、重复逻辑、失效链接、命名不一致或结构混乱,而大范围删除又存在风险的情况。该技能只清理源码与项目结构,不是 Git 分支、拉取请求、提交或工作树清理流程。
主要能力:识别不可达或未使用代码、过期文件或注释、未使用依赖、重复逻辑、失效链接、不一致命名、混乱项目结构等候选类型。每次只选一个能依据代码引用、配置、文档、测试或运行行为证明低风险的候选,做最小且连贯的改动。
使用方式:先检查当前项目状态,识别活跃分支、未提交编辑、生成文件、配置、构建产物等不能被打扰的工作;收集候选;选定一项可证明低风险的候选;做最小连贯改动;运行相关现有检查(构建、测试、lint/类型检查、运行时冒烟检查、链接检查或项目特定验证);审阅 diff,仅在行为不变且无关工作未受影响时保留改动;重复直到没有已证实的低风险清理、进度停滞、无法验证或需要批准。对需批准的候选,需在一次提问中让用户选择(可用 AskUserQuestion 时设 multiSelect: true,每个推迟候选一个选项,每题最多 4 个,其余另起问题;否则在聊天中给编号列表),并在同一轮运行中对每个获批候选继续循环、一次一个。
适用场景:代码项目积累小维护问题但大范围删除有风险时;需要保守清理源码与项目结构时。
限制与护栏:不因目的不明显而删除代码;不触碰无关、活跃、未提交、生成或不确定的工作;不把无关清理合并成一个大改动;检查失败或行为无法验证则不保留清理;在风险不明时,删除依赖、删除大批文件或更改公共接口前需请求批准。报告需列出已审阅候选、所做改动、每项保留清理的证据、运行的验证命令及结果、推迟候选及原因、仍需批准事项及用户拒绝的候选;需用户参与项以 ⚠️ 开头,失败检查以 ❌ 开头,不使用其他标记。