技能：file-operations

用途

在启用 MCP 的环境中执行安全、可审计的文件操作（读取/写入/更新/删除/移动/复制），包含路径校验与自动备份机制。

适用场景

• 任何需要编辑磁盘上文件的任务。
• 需确保变更安全且可回滚。
• 必须避免意外覆盖或破坏性操作。

输入参数

• operation（必填，枚举值：read|write|update|delete|move|copy）。
• paths（必填，对象）：
  • source（可选，字符串）
  • target（可选，字符串）
  • targets（可选，字符串数组）
• content（可选，字符串）：仅用于 write 或 update 操作。
• backup（可选，布尔值，默认值：true，仅对覆盖类或删除类操作生效）。
• constraints（可选，字符串数组）：例如 "only within workspace"。

执行步骤

1. 解析为绝对路径并标准化路径格式。
2. 校验作用域：
   • 确保操作始终限定在指定的工作区根目录（roots）范围内；
   • 拦截路径遍历（path traversal）及可疑目标路径。
3. 预检（Preflight）：
   • 对 read/update/delete 操作，确认源路径存在；
   • 对 write/move 操作，确认目标路径不存在（或显式允许覆盖）。
4. 若为覆盖或删除操作且 backup=true，则创建带时间戳的备份副本。
5. 执行操作，并明确报告变更详情（例如“修改了 X 行”、“创建了 Y 文件”等）。
6. 后校验（Post-validate）：
   • 确认目标路径下文件已按预期存在；
   • 验证内容或差异（diff）符合预期。

校验要求

• 尽可能保证操作可逆（对破坏性操作须存在有效备份）。
• 执行前须校验最终目标路径的合法性与可达性。
• 操作结果必须显式返回（禁止静默执行）。

输出格式

operation: ""
affected: [""]
backup_paths: [""]
result: "success|blocked|failed"
notes: ["..."]

安全规则

• 未经用户显式确认，禁止递归删除或递归覆盖。
• 禁止对动态计算出的路径直接执行操作；必须先打印解析后的最终路径供确认。
• 在可行前提下，优先采用基于补丁（patch-based）的增量更新，而非全量文件重写。

示例

更新配置文件：

• operation：update
• paths：{ target: "apps/api/.env.example" }
• 校验项：已创建备份；变更 diff 极小；文件仍可正常解析。