change-safeguard Skill

Description

工作区文件变更操作的安全保险箱。

任何对工作区文件、配置、脚本的优化、修改、移动、删除操作，都必须走此技能流程。确保不遗漏、不误改。

When to Use

触发场景：

• 文件/目录移动、重命名 → 更新所有引用
• 脚本路径/配置项修改 → 更新所有调用点
• 批量替换关键词/函数名/变量名
• 删除文件前 → 检查是否有引用
• 优化修改后 → 验证影响范围

不触发：

• 纯内容创作（不涉及已有文件引用）
• 读取文件后直接输出（不修改其他文件）

核心原则

5 步流程

1️⃣ 影响分析  ── grep 找出所有旧引用
2️⃣ 列清单    ── 逐个文件 + 具体位置 + 分类标记
3️⃣ 执行      ── 按清单逐一编辑，改一个打一个勾
4️⃣ 复验      ── 再次 grep 旧字符串，区分遗漏 vs 无需修改
5️⃣ 完成      ── 旧引用清零 → 展示修改总结

任何步骤不可跳过，不可合并。

步骤详解

步骤 1：影响分析

全量搜索，覆盖所有常见文件类型：

grep -rn "旧字符串" /path/to/ \
  --include="*.md" --include="*.py" --include="*.json" \
  --include="*.yaml" --include="*.yml" --include="*.sh" \
  --include="*.js" --include="*.ts" --include="*.toml" \
  2>/dev/null

搜索结果分类标记：

步骤 2：列出清单

格式：

### 影响分析结果
共 X 处引用：Y 处需修改，Z 处无需修改

### 需修改清单
| # | 文件 | 需修改内容 | 状态 |
|---|------|-----------|------|
| 1 | file.md | old → new | ⬜ |
| 2 | script.py | 参数更新 | ⬜ |

列出后告知用户，等待确认后再执行。

步骤 3：执行修改

• 按清单逐一编辑，不跳跃
• 每改一个打勾 ⬜ → ✅
• 不凭记忆修改，不跳过任何一项

步骤 4：复验（强制）

# 复验旧字符串
grep -rn "旧字符串" /path/to/ --include="*.md" --include="*.py" --include="*.json" ... 2>/dev/null

# 验证新字符串
grep -rn "新字符串" /path/to/ --include="*.md" --include="*.py" --include="*.json" ... 2>/dev/null

结果处理：

步骤 5：完成总结

### 修改总结
共修改 X 个文件：

| # | 文件 | 修改内容 |
|---|------|----------|
| 1 | file.md | 路径更新 |
| 2 | script.py | 函数调用更新 |

✅ 复验通过，旧引用已清零。

禁止行为

场景速查

自检

说"完成"前，自问：

1. grep 过旧字符串了吗？结果清零了吗？
2. 搜索了所有常见文件类型吗？
3. 区分了需要改和不需要改的引用吗？

任何一题回答"没有" → 不准说完成。

全局技能，所有 Agent 必须遵循