用途:clean 是对自己改动(diff)做的一次独立打磨,而非测试、类型检查或 lint 任务。它强调 KISS/DRY 并复制本地代码风格,追求简洁、优雅、高效。可在任何时候运行,包括工作中途代码变乱时;也应在任何 PR 交接前自动运行(创建、更新、自动合并或进入下一个 PR),无需每次被提醒。
主要能力:重新阅读 diff,删除死代码、遗留调试日志和重复;扩展现有 helper 而非并行实现;匹配邻近风格(命名、导入、文件布局、注释密度);偏好小而精的版本而非繁文缛节。UI 工作仅在用户满意 UI 后进行(ui-only),基础组件使用 ui-system。在 PR 上,标题/正文应整体描述变更(简短介绍),而非步骤变更日志;拆分为主题提交(pr-update),对文本运行 no-tropes,并链接 PR。
限制:不要因为被要求“clean”就运行测试套件、tsc 或 lint;仅在确需确认打磨安全时才运行检查。不做无关重构;不为单一调用者新增抽象;不把范围蔓延伪装成清理。