用途:当 Write 或 Edit 工具在创建新文件时失败,可用此技能作为恢复策略。
主要能力:多数失败原因是父目录不存在或文件系统需要先建立文件。通过 Bash 执行 mkdir -p 创建父目录,再用 touch 创建空文件,然后在重试 Write 时写入原内容,通常即可成功。步骤 1 与步骤 2 可合并,例如:mkdir -p src/utils && touch src/utils/helpers.ts
适用场景:Write 调用失败且目标文件尚不存在;错误提到目录缺失、文件未找到或路径问题;需要在嵌套目录中创建文件。
限制与不适用:若 Edit 或 Write 失败于已存在的文件,属于另一类问题,不适用本技能;错误与文件创建无关(如已存在文件的权限被拒绝、磁盘已满)也不适用。
边界情况:若 mkdir -p 因路径某一段是损坏的符号链接而失败(即使 mkdir -p 本应能创建却报 No such file or directory),说明该符号链接指向不存在的目标并阻碍目录创建。不要自动删除它,该链接可能是有意保留的;应告知用户发现的情况,并询问如何处理(例如删除符号链接、修复其目标或另选路径)。