Agent Skill 核验档案

Smart File Writer

智能文件写入错误处理器。在重试文件写入操作之前，系统地诊断并解决权限问题、磁盘空间不足、路径长度限制和文件锁定等常见故障，而不是盲目重试。

适用任务

在遇到“Error writing file”、“Permission denied”或“No space left on device”等文件写入失败错误时，运行诊断检查清单并解决根本原因
在执行关键文件写入前，主动验证路径长度限制、父目录存在性、磁盘空间（至少100MB）和写入权限等条件
检测并处理由其他进程（如 Microsoft Excel）锁定文件或防病毒软件干预而导致的写入失败，并提供解决建议
通过原子写入（临时文件加重命名）、缩短超长路径（使用哈希值替代文件名）、创建缺失目录等方式解决写入障碍

输入

Target file path（目标文件路径）
Intended operation（预期操作，如写入、追加、创建等）
Error message（错误消息，在反应式模式下使用）

输出

诊断结果说明（如：父目录不存在、文件被锁定、路径过长）
具体解决方案执行情况（如：已创建目录、已建议运行 'attrib -r data.csv' 移除只读属性）
重试结果或阻止写入的警告及建议（如：因磁盘空间不足阻止写入，建议清理临时文件或更换驱动器）
路径映射日志（如在处理超长路径时，记录原始路径到缩短路径的映射文件）

限制与检查

不处理网络文件系统（NFS、SMB）的特定问题，仅能进行基础诊断
未经用户确认，不修改系统级权限
不绕过安全策略或防病毒软件
不处理数据库写入操作（属于不同的错误领域）
部分防病毒软件无法被可靠检测
更改系统级权限需要管理员权限
验证路径长度：在 Windows 系统下检查文件路径长度是否超过 260 个字符限制
权限与目录检查：检查目标文件的父目录是否存在，以及当前用户是否对该目录或文件具有写入权限

今日榜单

0