SuperAPI AI 工具集

write

编程与开发

查看项目

更新于 10-15 23:46

技能介绍

用途:write 工具用于从零创建新文件,适合生成代码文件、编写配置或产出输出文件。它会在需要时自动创建父目录。

主要能力与用法:调用时必须提供两个参数——path(绝对路径)和 content(完整文件内容)。示例:{"name": "Write", "input": {"path": "/tmp/example/new_module.py", "content": "def hello():\n return 'hi'\n"}}。路径应使用任务中给出的精确路径,不要用占位符。

限制:write 仅用于新建文件。如果目标文件已存在,工具会拒绝并返回错误,提示改用 Edit;不要对同一路径重复尝试 write。对已有文件的任何修改(修 bug、重构、调整格式、添加函数、重命名变量等)都应使用 Edit,其参数为 path 加 edits: [{oldText, newText}],就地打补丁。若需整体替换已有文件内容,Edit 也可完成:把当前完整内容作为 oldText、新完整内容作为 newText;若没有当前内容,先读取文件。

工作流建议:先确认文件不存在,再使用 write;提供完整内容而非部分更新;使用任务指定的精确路径;若 write 被拒绝,改用 Edit 修改已有文件。