第一性原理代码重构

它解决什么问题

面对一个陌生或历史包袱较重的代码库，直接问“哪里可以重构”很容易陷入凭感觉改代码：范围过大、误判技术债、把生成代码或薄封装当成核心问题。这个技能把代码优化从类比式经验判断转成可审查的工程流程，先确认目标，再定位真正值得投入的模块。

如何工作

技能按 Pre-Phase + 四阶段 推进：

• 范围对齐：确认分析深度、重点领域与范围，避免无差别全量扫描。
• 摸底：使用 explore.sh 输出目录结构、技术栈、代码规模、Git 健康度、工程规范和技术债信号，再和用户确认关键发现。
• 解构：围绕“为什么存在”“从零设计是否如此”“删除后果”等第一性原理问题，识别过度工程、防御性冗余、幽灵依赖和错位抽象。
• 审计：按项目规模选择可读性、可维护性、安全性等维度，标注红黄绿风险。
• 路线图：按 P0 到 P3 排序，优先处理安全、正确性、稳定性，再处理性能、依赖升级和架构改造，并倾向采用渐进式替换。

适用边界

它更适合需要技术判断和团队沟通的代码库升级，而不是简单格式修复或单函数优化。若缺少测试覆盖，应先补测试或明确风险；对业务目标不清、范围频繁变化的需求，也应在启动前完成范围对齐。