核心用法
file-writer 是一套针对大文件（>5000 字节）的安全写入策略框架，而非单一工具调用。其核心工作流为四步循环：读取当前状态 → 精准编辑修改 → 验证结果 → 重复直至完成。该 skill 强调使用 edit 工具替代 write 工具进行增量修改，并提供了详细的安全阈值表：新建文件 <2000 字节可直写，2000-5000 字节为中等风险，>5000 字节必须使用分块策略；编辑操作则以 500 字节为安全线，>1000 字节需采用标记分段法。
显著优点
1. 系统性风险管控：明确量化截断风险阈值，将抽象的"大文件问题"转化为可执行的操作规则
2. 多层级回退策略：提供 4 种 fallback 方案（分块写入、唯一标记、增量构建、备份恢复），覆盖从网络中断到工具限制的各类故障场景
3. 精准定位机制：强调 edit 工具的精确匹配特性，配合唯一标记（如 <!-- SECTION_START -->）实现复杂内容的安全替换
4. 验证闭环设计：每次修改后要求验证文件大小、行数、尾部完整性，避免"静默截断"
潜在局限
1. 操作复杂度高：相比直接 write，需多次工具调用和人工验证，简单场景下效率损失明显
2. 依赖环境一致性：oldText 精确匹配要求文件内容稳定，并发修改或编码差异易导致匹配失败
3. 无自动化保障：策略本身依赖用户严格执行，缺乏强制校验机制，存在"知道但未做到"的执行 gap
4. 阈值静态化：5000/500 字节等阈值基于经验假设，未考虑具体运行时的内存/网络环境差异
适合人群
- 需要频繁操作大型 Markdown/配置文件的开发者
- 在不稳定网络环境或受限沙箱中工作的用户
- 对数据完整性要求极高的关键文件维护者
- 遭遇过文件截断问题、需要系统性解决方案的技术人员
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 文件截断 | 高 | 未遵循策略时，大文件写入可能中断导致数据丢失 |
| 编辑匹配失败 | 中 | `oldText` 不匹配会阻断操作，需重新读取定位 |
| 增量不一致 | 中 | 多步骤修改中若未逐步验证，可能出现中间状态错误 |
| 备份覆盖 | 低 | 频繁备份策略若管理不当，可能浪费存储或混淆版本 |
该 skill 属于防御性编程指南，本身无代码执行风险，但执行效果高度依赖用户对策略的理解与遵守程度。