oil-explore
/oil-explore
Szybko mapuje bazę kodu tylko do odczytu, znajduje miejsca implementacji i zbiera fakty do planu, bez zmian w kodzie.
- Autor
- oil-oil ↗
- Repozytorium
- oil-dev-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 6
- Skrypty
- 4
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 4 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/preferences.py, scripts/repo_map.py, tests/test_preferences.py, tests/test_repo_map.py
Co robi i kiedy
Szybko mapuje bazę kodu tylko do odczytu, znajduje miejsca implementacji i zbiera fakty do planu, bez zmian w kodzie.
Oryginalny opis (EN)
对代码库做快速、低成本、严格只读的结构盘点与并行代码探索:在熟悉仓库直接精准检索,在陌生或跨模块项目中用轻量脚本获取目录规模、现存规范与真实脚本清单,再按模块边界派发轻量只读子 Agent 并行查清调用链与可复用基建。用户要求摸清陌生仓库、定位某功能实现位置、盘点可复用组件/函数或为写方案收集代码事实时使用;不用于修改代码、撰写开发方案(交给 oil-plan)、审查代码改动(交给 oil-code-review)或治理失效文档与测试(交给 oil-govern)。
Jak działa
- 核心规则
- 先选探索档位
- 工作流
- 个人偏好
- 输出与后续衔接
- 资源导航
Podgląd SKILL.md
--- name: oil-explore description: "对代码库做快速、低成本、严格只读的结构盘点与并行代码探索:在熟悉仓库直接精准检索,在陌生或跨模块项目中用轻量脚本获取目录规模、现存规范与真实脚本清单,再按模块边界派发轻量只读子 Agent 并行查清调用链与可复用基建。用户要求摸清陌生仓库、定位某功能实现位置、盘点可复用组件/函数或为写方案收集代码事实时使用;不用于修改代码、撰写开发方案(交给 oil-plan)、审查代码改动(交给 oil-code-review)或治理失效文档与测试(交给 oil-govern)。" license: MIT metadata: version: "0.4.0" --- # oil-explore `SKILL_DIR` 指当前 Skill 的绝对目录;`<python>` 指 Python 3.10+(macOS/Linux 通常为 `python3`,Windows 通常为 `py -3`);`REPO_MAP` 是 `<python> "$SKILL_DIR"/scripts/repo_map.py` 的简写,`PREFS` 是 `<python> "$SKILL_DIR"/scripts/preferences.py` 的简写。 ## 核心规则 - **全程严格只读**:探索阶段绝不修改、新建或删除项目文件,不安装依赖,不触发会改动工作区状态、抢占前台窗口焦点或弹出系统权限框的命令。 - **按熟悉度选最轻路径**:在已知结构或单点定位任务上,直接用宿主自带的检索工具(如 `glob` / `rg`)直奔目标文件,不强行多跑一轮全仓脚本;只有在进入陌生仓库或做跨模块大改造摸底时才先跑 `REPO_MAP`。 - **低成本局部读取**:派发探索子 Agent 时显式选用轻量快速模型档位(用户的[个人偏好](#个人偏好)另有要求时照偏好),不默认继承昂贵的主模型;只按局部行号精读关键函数与类型定义,不把整篇大文件原样塞进主上下文。 - **必查现成基建与真实测试入口**:除了查清目标业务链路,必须顺手确认仓库已有的公共组件、共享核心模块、`AGENTS.md` / `DESIGN.md` 硬约束,以及项目规定使用的真实快测命令(注意排查 `AGENTS.md` 是否禁用了默认的慢速全量命令)。若 `AGENTS.md` 有标题含 `oil-dev` 的开发约定小节(`REPO_MAP` 会直接展示),快测与门禁命令、高风险与禁改目录以它为准。 ## 先选探索档位 | 档位 | 适用场景 | 执行方式 | 默认停止点 | | --- | --- | --- | --- | | `quick` | 熟悉仓库查单个符号、配置项、报错位置 | 直接检索目标关键词并局部读 1–3 处代码片段(无需跑脚本、无需子 Agent) | 给出精确 `file:line` 结论后停止 | | `medium` | 梳理单个功能模块的入口、状态流转与可复用组件 | 局部检索 + 读取 `AGENTS.md` / `DESIGN.md` 相关约束 + 精读模块核心文件 | 输出模块调用链、可复用基建与局部快测命令 | | `thorough` | 初入陌生大仓库、跨多子系统改造前摸底 | 先跑 `REPO_MAP` 看全局结构 → 按独立子系统边界派 2–3 个轻量只读子 Agent 并行探索 | 汇总结构化探索简报,准备交接方案阶段 | ## 工作流 ### 1. 全局快照(仅陌生仓库或 `thorough` 档需要) 初入陌生项目或不清楚目录结构与并行工作树分布时,运行轻量结构快照(遵循 Git 忽略规则,秒级返回目录规模、后缀分布、规范文件、已定义脚本与 Worktree 列表): ```text REPO_MAP --workspace "<项目路径>" ``` 若输出显示存在 `AGENTS.md`、`DESIGN.md` 或自定义 `scripts/` 测试脚本,优先读取其中与当前任务相关的命令约定和禁令,不凭经验臆造默认测试命令。输出里的 `ci_run_steps` 是 CI 实际执行的命令,确认快测与门禁命令时以它和仓库已定义脚本为准。 ### 2. 按真实模块边界只读深挖 - **`quick` / `medium` 档**:直接用宿主检索工具定位相关文件,每次按行号读取 40–100 行确认真实调用关系,顺手查看同模块或公共目录下的可复用组件与辅助函数。 - **`thorough` 档**:阅读 [并行只读探索切片指南](references/parallel-exploration.md)。**按互不重叠的子系统目录划分切片**(不要把强耦合在同一批文件里的视图与状态硬拆给多个子 Agent 重复读取): - 若当前环境支持原生子 Agent:先运行 `PREFS get oil-explore --host <宿主>` 读取[个人偏好](#个人偏好)。`shared` 对所有宿主生效,`host_text` 只对当前宿主生效,两者冲突时以 `host_text` 为准。偏好写了用哪种子 Agent 机制、什么模型、派几个或怎么回收,就照着做;没写到的部分按默认:启动 2–3 个只读子 Agent,显式指定轻量快速模型档位并行查询。命令失败或没有设置时按默认做法继续,不为此打断用户。 - 若当前环境不支持子 Agent:主 Agent 按子系统顺序逐块做局部行号读取,每读完一块记下 `file:line` 摘要再看下一块。 ### 3. 交叉核验并输出探索简报 交付前核对所有结论均有代码依据: 1. 关键结论附上准确的 `文件路径:行号` 与核心符号名,区分“代码已确认事实”与“待用户拍板的产品问题”。 2. 明确列出本次任务**可直接复用的公共组件、设计令牌或底层模块**。 3. 明确列出改动该模块后对应的**局部快测命令**与现有测试路径。 ## 个人偏好 整个 oil-dev 系列共用一份本机偏好文件 `~/.oil-dev/preferences.md`(环境变量 `OIL_DEV_HOME` 可以改目录),用自然语言写:每个 Skill 一节(如 `## oil-explore`),紧跟在 Skill 标题下的文字对所有宿主生效,`### 宿主名` 下面的文字只对该宿主生效。它只放跟用户本人有关的设置;团队共享的约定写在仓库 `AGENTS.md` 的 `oil-dev` 小节。 `<宿主>` 是你当前运行在哪个 Agent 产品里,用小写连字符名称,例如 `claude-code`、`codex`、`antigravity`、`opencode`、`workbuddy`、`kimi-code`、`grok-build`、`deepseek-harness`、`gemini-cli`。 oil-explore 只在 `thorough` 档派发子 Agent 时读取偏好。常见的内容是派发机制、模型、数量上限和回收方式,例如: ```markdown ## oil-explore 探索子 Agent 最多 3 个。 ### antigravity - 用 swarm 派发探索子 Agent,每个 Worker 用 `<模型 ID>`。 - 收齐所有简报后结束 Worker。 ``` 不要主动询问偏好。用户说“以后探索子 Agent 用某个模型”“在 Antigravity 里用 swarm 派发”这类话时保存:`set` 会整段替换,所以先用 `PREFS get` 取出现有文字,把新要求合并进去再保存,最后把保存后的内容告诉用户。 ```text PREFS set oil-explore --host <宿主> --text "<合并后的完整文字>" ``` 对所有宿主生效的要求,把 `--host <宿主>` 换成 `--all-hosts`。用户要求查看时运行 `PREFS show`,要求删除时运行 `PREFS unset oil-explore --host <宿主>`。命令返回 `status: ERROR` 时,把 `error` 原样告诉用户。 ## 输出与后续衔接 探索简报交付后停止,不顺手改代码,也不在未获要求时直接铺开长篇方案。 | 下游意图 | 衔接动作 | | --- | --- | | 基于探索事实制定开发方案 | 进入 `oil-plan`,直接复用本次查清的 `file:line`、可复用组件与局部快测命令 | | 发现常驻文档描述与当前代码目录明显脱节 | 进入 `oil-govern` 做文档与规范治理 | ## 资源导航 - [references/parallel-exploration.md](references/parallel-exploration.md):进入 `thorough` 档并行探索时阅读,说明子系统切片原则与简报格式。 - [scripts/repo_map.py](scripts/repo_map.py):零第三方依赖的 Git 文件分布、规范入口、真实脚本列表(含 justfile 与 CI 命令)与 Worktree 快照工具。 - [scripts/preferences.py](scripts/preferences.py):读写本机个人偏好文件,零第三方依赖。 - [tests/test_repo_map.py](tests/test_repo_map.py)、[tests/test_preferences.py](tests/test_preferences.py):两个脚本的回归测试,仅在修改脚本时运行。
Pliki w paczce (6)
- SKILL.md 8 KB
- references/parallel-exploration.md 2 KB
- scripts/preferences.py 11 KB
- scripts/repo_map.py 15 KB
- tests/test_preferences.py 7 KB
- tests/test_repo_map.py 4 KB
Wersje
W bazie nie ma innych skilli o nazwie oil-explore.
Migawka bazy z 13.11.2026 · wersja paczki 188845a2e8d2 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100oil-govern
Porządkuje dokumentację i standardy projektu, dzieli testy na szybkie i wolne oraz zamienia twarde reguły w automatyczne kontrole w repozytorium. - 100oil-code-review
Przegląda zmiany w kodzie według poziomów ryzyka pod kątem logiki, duplikacji, błędów wykonania, bezpieczeństwa i zgodności danych. - 95oil-diff
Zamienia zmiany w Git na czytelną stronę HTML z opisem modułów, przykładami i porównaniem przed i po. - 95oil-motion
Zamienia wideo i sekwencje klatek w animacje na stronach, reagujące na przewijanie, kursor, dotyk i dźwięk. - 100explore
Eksploruje bazę kodu tylko do odczytu: odkrywa strukturę, mapuje pliki, śledzi przepływ funkcji, lokalizuje symbole i zbiera kontekst przed implementacją. - 96oil-motion
Przetwarza wideo i sekwencje klatek w animacje webowe sterowane przewijaniem, wskaźnikiem, przeciąganiem i stanem, z lokalnymi skryptami do obróbki mediów.