SuperAPI AI 工具集

host-workspace-operator

编程与开发

查看项目

更新于 10-24 16:19

技能介绍

Host Workspace Operator 是一个面向宿主工作区的文件与 Shell 操作路由技能。其核心目标是按能力而非厂商特定工具名来组织操作,避免智能体假设 str_replace_editor、Bash、readFile 等固定工具名在不同宿主平台上并不存在,从而导致运行时执行崩溃或不安全的变更。

用途方面,该技能在 Skill Conductor 需要检查、搜索、修改或验证活动宿主工作区中的文件时使用,要求使用当前宿主可用的最安全原生能力,并在只读边界内收集证据。

主要能力按从窄到宽的能力顺序组织:读取已知文件或行范围;列出目录或工作区范围;在措辞或位置不确定时搜索宽泛概念;用 Grep 精确匹配已知术语、符号、字段或模式;对已有区段做聚焦补丁;仅在创建或替换被授权时写入;当更窄工具不足时使用 Shell 执行仓库命令;用 Python 或确定性计算进行解析、哈希、包检查或验证。技能同时明确,不得仅为模仿更安全的读取、搜索或文件操作而使用 Shell 或 Python。

使用方式上,技能要求变更前先只读优先:检查仓库说明、定位相关文件、读取足够上下文以保留无关工作、区分源文件与生成/供应商文件、确定完成请求所需的最小变更。变更边界将写入、补丁、删除、移动、重命名、格式化和变更性命令视为状态改变,仅在用户请求或明确授权时执行,优先聚焦补丁而非大范围重写,不得将凭据或密钥写入源代码、示例、清单、日志或产物,变更后应读取受影响区域并在宿主可执行时运行相关检查。

适用场景包括跨不同宿主运行时的文件读取、目录列举、搜索与精确匹配、聚焦修改及命令执行等操作。限制方面,技能强调证据规则:除非宿主产生该操作的证据,否则不得声称文件已被读取、搜索、修改、测试或执行;所需能力不可用时,不得虚构工具或清单权限,只有在保持语义与安全的前提下才能使用其他能力,否则应保持依赖结果未经验证。