Skills: 文件操作技能

最后更新：2026-08-31

文件是代码的载体——不会操作文件的 Skill，就像没有手的设计师。

1. 文件操作工具箱

(1) 读取类操作

(2) 写入类操作

(3) 执行类操作

2. 文件操作模式

(1) 只读分析模式

不修改任何文件，只输出分析结果：

---
name: code-metrics
description: "代码度量分析"
tools:
  - Read
  - Grep
  - Glob
---

## 执行流程
1. Glob 确定项目文件范围
2. Grep 统计代码模式（类、函数、TODO）
3. Read 深入分析关键文件
4. 输出度量报告，不修改任何文件

(2) 安全修改模式

修改前先备份，修改后验证：

## 安全修改规则
1. Read 当前文件内容
2. 分析需要修改的位置
3. Edit 精确修改，只改目标行
4. Bash 运行测试验证
5. 如果测试失败，说明问题并建议回滚

(3) 批量操作模式

## 批量重命名流程
1. Glob 获取目标文件列表
2. 列出所有计划的修改
3. 逐个 Edit 执行修改
4. Bash 运行全量测试验证

3. 搜索策略

(1) 搜索优先原则

错误方式：读取所有文件 → 逐个检查
正确方式：搜索定位 → 精准读取

(2) 常用搜索模式

(3) 搜索与读取配合

graph TD
    A[Glob: 确定文件列表] --> B[Grep: 搜索关键模式]
    B --> C{找到目标？}
    C -->|是| D[Read: 深入阅读]
    C -->|否| E[扩大搜索范围]
    D --> F{需要修改？}
    F -->|是| G[Edit: 精确修改]
    F -->|否| H[输出分析结果]

graph TD
    A[Glob: 确定文件列表] --> B[Grep: 搜索关键模式]
    B --> C{找到目标？}
    C -->|是| D[Read: 深入阅读]
    C -->|否| E[扩大搜索范围]
    D --> F{需要修改？}
    F -->|是| G[Edit: 精确修改]
    F -->|否| H[输出分析结果]

4. 文件操作实战

▶ 示例：项目迁移 Skill

Alice 需要将项目从 JavaScript 迁移到 TypeScript：

---
name: js-to-ts-migration
description: "将 JS 文件迁移为 TS"
tools:
  - Read
  - Write
  - Glob
  - Grep
  - Bash
---

## 迁移流程
1. Glob 找到所有 .js 文件
2. 对每个文件：
   a. Read 读取内容
   b. 分析依赖和导出
   c. Write 创建对应 .ts 文件
   d. 添加类型注解
3. Bash 运行 tsc --noEmit 验证
4. 输出迁移报告

Bob 说："文件操作最怕的是误删误改——搜索定位、精准编辑、事后验证，三步一个都不能少。"

❓ 常见问题

📖 小节

• 三类操作：只读分析、安全修改、批量操作
• 搜索优先：先 Glob/Grep 定位，再 Read 深入，最后 Edit/Write 修改
• 安全原则：修改前读取、修改时精确、修改后验证
• 大文件策略：按行号范围读取，不全文加载

📝 作业

1. 基础题（难度⭐）：创建一个只读分析 Skill，统计项目中 TODO/FIXME 的数量和分布。
2. 进阶题（难度⭐⭐）：创建一个安全修改 Skill，自动为 Python 函数添加 type hints，修改后运行测试验证。
3. 挑战题（难度⭐⭐⭐）：创建一个批量迁移 Skill，将项目中的 CommonJS require 改为 ES Module import，处理循环依赖等边界情况。

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。

关于我们