Environment Discovery 是一个面向开发与自动化场景的技能,其核心目标是在进入一个不熟悉的环境后,先进行系统性的探索,再开始实际工作。该技能强调“先探索,后行动”,以避免因对文件格式、工具可用性或代码结构做出错误假设而浪费时间。
用途 该技能适用于被放入陌生工作区、代码库或数据目录时,帮助使用者快速建立对环境的整体认知。它尤其适合需要读取数据、修改代码或运行构建流程之前的前置调查阶段。
主要能力 技能提供了一套分步骤的探索流程:
第一步:了解工作区。使用 ls -la /app/ 或当前工作目录,以及 find . -type f | head -50 来查看存在哪些文件、文件大小、是否有 README、Makefile、配置文件,以及涉及哪些语言或框架。
第二步:检查数据文件。在编写任何读取数据的代码之前,先理解数据格式。可使用 file <filename> 检测文件类型(二进制、文本、编码),head -20 <file> 查看文本文件前几行,xxd <file> | head -20 对二进制文件进行十六进制转储,wc -l <file> 统计文本行数,stat <file> 获取精确字节大小,以及 python3 -c "import struct; ..." 解析二进制头部。
第三步:检查可用工具。使用 which python3 gcc g++ make cmake node npm cargo rustc java go 和 pip list 2>/dev/null | head -20 来确认安装了哪些编译器、解释器、库和包管理器。
第四步:阅读现有代码。如果存在源码文件,应在修改前完整阅读,理解构建系统(Makefile、CMakeLists.txt、pyproject.toml),并检查现有测试。
关键原则 技能列出了若干必须遵守的原则:绝不假设文件格式,始终先检查;绝不假设工具已安装,始终先确认;500MB 的文件不是“小文件”,需要提前规划;二进制文件需要字节级检查,而不是直接 cat;花 30 秒探索可以节省 5 分钟调试。
使用方式 该技能以命令和检查步骤的形式提供,使用者可以按照四个步骤依次执行,也可以根据实际情况调整顺序。所有命令均为通用 shell 命令,不依赖特定平台。
适用场景 适用于进入不熟悉的代码库、数据目录、容器环境或远程服务器时,在编写代码、读取数据或运行构建之前进行快速调查。也适用于自动化代理在未知环境中执行任务前的准备阶段。
限制 资料中未提供关于该技能的具体实现语言、依赖项、安装方式、收费模式或平台支持的信息。该技能本身是一套探索流程和原则,不包含自动化执行逻辑。