精确编辑 (Precise Edit)

像 Claude Code 一样外科手术式改代码:先读懂、再精确替换、改完自检。是「读-改-验」闭环里的「改」。

使用时机

✅ 使用此技能当: 要修改任何已存在的文件 / 修 bug / 重构 / 按需求改逻辑。 ❌ 不要用当: 只是新建空文件、或纯只读调研(走探索模式)。

铁律

1. 先读后改 — 改任何文件前必须先读到要改的那段(连同上下文),禁止凭记忆/猜测改。没读过 = 不许改。
2. 精确匹配、最小 diff — 只替换需要变的那几行;old 文本要带足上下文以唯一定位,禁止整文件重写(除非确实是从零新建)。保持与周围代码同样的缩进、命名、风格。
3. 一次一处、可复核 — 多处改动拆成多个小而清晰的替换,而不是一个大块塞改。每处改动都能被人一眼看懂。
4. 不顺手改无关内容 — 不重排 import、不改格式、不删注释,除非任务要求。
5. 改后自检 — 改完立刻重读改动处确认正确、闭合(括号/标签/引号),再考虑跑验证(配合「火一五执行验证」技能跑 typecheck/测试)。

标准流程

1. 定位

• 用检索(配合「火一五代码检索」技能)找到要改的文件与行。
• 读目标段落 + 上下文,理解它怎么被调用、有无副作用。

2. 设计最小改动

• 想清楚:改哪几行?会不会影响调用方/类型/测试?
• 优先复用现有函数/模式,别另起一套。

3. 执行替换

• old = 文件里逐字一致(含缩进)的原文,带足上下文确保唯一;new = 改后文本。
• 匹配失败/不唯一 → 扩大上下文重试,不要改成整文件覆盖。

4. 复核

• 重读改动处:逻辑对不对?符号闭合没?风格一致没?
• 有无遗漏的关联点(同名引用、类型定义、文档/测试)?

5. 验证(交棒)

• 交给「火一五执行验证」跑 typecheck / lint / 相关测试,绿了才算完成。

反模式(禁止)

• ❌ 没读原文就改 / 凭印象改
• ❌ 整文件重写来"顺便"改一行
• ❌ old 上下文不足导致改错位置或多处误伤
• ❌ 夹带无关的格式化/重排
• ❌ 改完不复核、不验证就宣称完成

核心原则

先读后改 · 精确最小 · 改后自检 · 不伤无关。 改动越小越精确,越可控、越好复核。