SuperAPI AI 工具集

file-sharing

智能体与模型

查看项目

更新于 10-15 19:52

技能介绍

用途:该技能用于处理任务生命周期之外的共享文件同步,包括直接调用 filesync 前、读取非任务共享文件、推送任务中途进度,以及排查共享文件缺失。不用于常规任务操作。

主要能力与路径规则:只使用本地共享路径,不暴露存储内部结构。可用路径为 shared/tasks/{task-id}/,以及仅作只读项目上下文的 shared/projects/{project-id}/。目录同步路径必须以 / 结尾;若目录拉取失败,应报告 filesync 结果,而不是创建本地占位目录或改用绝对路径。禁止在聊天、任务输出或常规推理中使用 hiclaw/hiclaw-storage/...、teams/{team}/shared/...、/root/hiclaw-fs/...、/root/hiclaw-fs/agents/... 等路径。

使用方式:任务生命周期文件同步由 taskflow(action="ack_task") 和 taskflow(action="submit_task") 内部处理(pull、push、stat),不要为这些操作单独调用 filesync。对于任务生命周期之外的共享文件(项目上下文、参考资料),读取前先调用 filesync,例如 action 为 pull、path 为 shared/projects/{project-id}/。推送任务中途进度或协调者需要在提交前获取的非结果文件时,使用 action 为 push,path 为 shared/tasks/{task-id}/progress/,并可用 exclude 排除 spec.md、base/。

排查缺失文件:对 shared/tasks/{task-id}/ 调用 filesync 的 pull;检查 pwd,再检查任务消息中的本地相对路径,可执行 pwd、ls -la、ls -la shared/tasks/{task-id}/。若仍缺失,@mention 协调者并附上 filesync 结果与已检查的确切本地路径,例如 @coordinator:domain BLOCKED: I pulled shared/tasks/{task-id}/ but cannot find shared/tasks/{task-id}/spec.md.。不要搜索随机的容器绝对路径,也不要自行创建缺失的任务目录。

限制:资料未提供更多平台、收费或效果信息。