该技能用于 ChatGPT/Codex 插件工作流中与宿主工作区文件交互的场景,核心原则是使用当前宿主实际提供的原生工具,而不是假定插件自带文件系统 API。由于不同运行界面的工具名称不一致,技能要求按能力而非硬编码工具名进行路由,典型能力包括读取、列目录、搜索、grep、写入、补丁、shell 和 python。
主要能力与操作顺序:优先选择能回答任务的最窄操作。已知路径或精确范围时用读取;文件名未知时用列目录;问题宽泛或措辞不确定时用语义/内容搜索;术语、符号、字段或模式明确时用 grep 精确匹配;宿主具备补丁工具时对现有文件做聚焦修改;仅在请求的工作流需要变更时才创建或替换文件;文件工具不足且适合执行命令时使用 shell;需要确定性解析、转换、哈希、包检查或验证时使用宿主原生 Python。技能明确要求不要用 shell 或 Python 去模仿宿主已提供的更安全的读取、搜索或文件操作。
只读优先:将读取、列目录、搜索和 grep 作为默认的发现阶段,在变更前收集足够证据理解现状。仓库工作中要求先查看仓库说明再编辑,搜索定位后再做精确的文件/范围读取,避免无必要地加载庞大的依赖或构建目录,搜索时遵守忽略/生成/vendor 目录规则,并区分仓库源码与生成产物。
变更边界:写入、打补丁、删除、移动、重命名、格式化或基于命令的修改都属于变更操作。变更前需确认用户已请求或明确授权,遵守仓库说明与现有范围,保留无关工作,优先聚焦补丁而非整文件替换,能用文件操作完成时避免破坏性 shell 命令,且绝不把密钥写入源码、清单、日志、示例或发布产物。变更后应在可行时回读改动区域,运行相关验证或测试,并报告确切的改动文件与验证证据。
搜索与 grep 规则:概念性问题用搜索,精确模式用 grep;技能举例说明宽泛问题先搜索再读取可能文件、查找特定引用用精确搜索、定位含某字段的文件时先 grep 再读取。同时要求不得在宿主搜索仅覆盖索引、有限范围或结果被截断时声称已搜索整个工作区。
shell 规则:当工作流需要测试、git 检查、归档工具或仓库原生验证等命令时使用 shell;运行前先检查命令,优先只读命令,除非网络访问已知且必要否则避免依赖网络的命令,不要仅因目标仓库存在脚本就执行任意脚本,绝不为了获得通过结果而削弱测试或安全检查。
Python 交接:需要确定性计算或文件处理时,在已打包且宿主暴露 Python 的情况下调用 sandbox-python-executor,并保持同样的证据规则——必须先实际执行才能声称得到结果。
工具不可用时:不得虚构替代工具名或未记录的插件清单字段,不得声称发生了读取、写入、搜索、grep、shell 或 Python 活动;只有在保持任务语义和安全边界的前提下才改用其他可用能力,否则应说明哪项操作不可用,并将依赖该操作的结果保持为未验证状态。
此外,插件自动生成流程在转换后的插件工作流涉及文件、仓库、生成产物或本地工作区状态时,应将本技能安装进去;面向 Codex 风格仓库工作的插件也可将其作为标准基线技能。需要强调的是,该技能本身不授予文件系统权限,只是在宿主具备相应能力时教会模型如何安全使用。该技能的收费、价格、平台与效果等信息暂未提供。