oil-explore 是一个面向代码库的只读探索技能，核心目标是快速、低成本地盘点项目结构并收集代码事实，供后续开发方案使用。它自身不修改任何代码。
用途：
- 摸清陌生仓库的整体结构；
- 定位某个功能的具体实现位置；
- 盘点可复用的组件、函数与底层模块；
- 为编写方案收集准确的 file:line 依据。
主要能力与工作方式： 它按任务熟悉度划分三个档位。quick 档适合在熟悉仓库中查单个符号、配置项或报错位置，直接用宿主检索工具（如 glob、rg）定位并局部读 1–3 处代码，给出精确 file:line 后停止。medium 档用于梳理单个功能模块的入口、状态流转与可复用组件，在局部检索基础上读取 AGENTS.md、DESIGN.md 相关约束并精读模块核心文件，输出调用链、可复用基建与局部快测命令。thorough 档用于初入陌生大仓库或跨多子系统改造前的摸底：先运行 REPO_MAP 获取全局结构，再按互不重叠的子系统边界派发 2–3 个轻量只读子 Agent 并行探索，最后汇总结构化探索简报。
关键规则： 全程严格只读，不修改、新建或删除项目文件，不安装依赖，不触发会改变工作区状态或抢占焦点的命令；派发子 Agent 时显式选用轻量快速模型档位；只按行号精读关键函数，不把大文件整篇塞入主上下文；除查清业务链路外，还须确认现有公共组件、共享核心模块、AGENTS.md/DESIGN.md 硬约束与项目真实快测命令。
使用方式： SKILL_DIR 为当前技能绝对目录，<python> 指 Python 3.10+。REPO_MAP 为 <python> "$SKILL_DIR"/scripts/repo_map.py，PREFS 为 <python> "$SKILL_DIR"/scripts/preferences.py。陌生仓库执行 REPO_MAP --workspace "<项目路径>" 获取目录规模、后缀分布、规范文件、已定义脚本与 Worktree 列表；输出中的 ci_run_steps 反映 CI 实际命令。并行探索前可运行 PREFS get oil-explore --host <宿主> 读取个人偏好，偏好中可指定子 Agent 机制、模型、数量与回收方式，未设置时按默认 2–3 个只读子 Agent 处理。偏好文件位于 ~/.oil-dev/preferences.md，可用 OIL_DEV_HOME 改目录，用 PREFS set 保存、PREFS show 查看、PREFS unset 删除命令，--all-hosts 对所有宿主生效。
适用场景： 熟悉或陌生仓库的代码检索与结构盘点、功能定位、可复用基建梳理、方案前的代码事实收集。
限制： 不用于修改代码；探索简报交付后即停止，不顺手改代码或铺开长篇方案。若需基于探索事实制定开发方案可进入 oil-plan，发现文档与代码明显脱节可进入 oil-govern。资源包括 references/parallel-exploration.md（并行探索切片原则与简报格式）及两个零第三方依赖脚本 repo_map.py、preferences.py，其回归测试仅在修改脚本时运行。