Huo15 Edit

SKILL.md

---
name: huo15-edit
displayName: 火一五精确编辑技能
version: 1.0.0
description: "精确改代码 — 先读后改、精确匹配、最小化 diff、改后自检。借鉴 Claude Code 的 Edit 工具纪律,杜绝整文件重写与误伤。"
homepage: https://github.com/zhaobod1/huo15-skills
metadata: { "openclaw": { "emoji": "✏️", "requires": { "bins": [] } } }
aliases:
  - 火一五精确编辑技能
  - 火一五代码修改技能
  - 精确编辑
  - 精确改代码
  - edit mode
  - precise edit
---

# 精确编辑 (Precise Edit)

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

## 使用时机

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

## 铁律

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

## 标准流程

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

### 2. 设计最小改动
- 想清楚:改哪几行?会不会影响调用方/类型/测试?
- 优先复用现有函数/模式,别另起一套。

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

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

### 5. 验证(交棒)
- 交给「火一五执行验证」跑 typecheck / lint / 相关测试,绿了才算完成。

## 反模式(禁止)

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

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