技能介绍

这个技能解决什么问题

前端代码改动时容易踩三类坑。第一类是编码问题：在 Windows 环境下直接读取或写入文件，可能默认使用 GBK 或 ANSI，导致中文内容变成 \uXXXX 转义或乱码。第二类是改动范围失控：一次顺手重构、一组「风格统一」的重命名、一个提前引入的抽象层，往往与当前任务无关，却会让 diff 变大、review 变难。第三类是调用链残留：删掉一个兼容分支、收窄一个联合类型之后，留下的中转函数、兜底逻辑和纯透传代码仍在跑，但已经没有任何业务价值。

它如何工作

这套规则以「命中即全量执行」为前提：一旦触发，所有规则、流程、检查和交付条件默认一起执行，不能只挑部分内容。核心步骤包括：

编码检测前置：读写任何文件前先确认编码（UTF-8、GBK、ANSI 等），不假设文件编码；存在风险时统一为 UTF-8（优先无 BOM），写入时显式指定。
最小改动约束：只改与当前任务直接相关的内容，不重构、不优化、不调整结构；保持现有命名和编码风格，不主动「统一风格」。
变更后回查调用链：涉及类型收窄、字段类型统一、条件分支删除、兼容逻辑删除或数据转换删除时，必须回查完整调用链，清理因此失效的中转函数、中间变量、旧联合类型和冗余判断。
收口与交付确认：检查 diff 与调用点，确认无失效残留、无新增乱码、无隐式编码变化，实现与既有代码习惯一致后才能宣告任务完成。

适用边界与注意点

这是仓库级的通用执行约束，不是某个框架或组件库的专项规则。其他专项 skill 只需保留各自领域的专属内容，不必重复抄写这里的通用要求。多个 skill 同时命中时，相关规则叠加执行，交付前逐条确认。仅允许跳过规则正文明确限定且当前条件不成立的条款；不能因为「改动很小」「只是读文件」「只是回答一个问题」而跳过已命中的规则。类型检查、构建或测试通过只能验证代码可运行，不能替代调用链回查和残留清理。