‹ 首页

explore

@darkroomengineering · 收录于 昨天 · 上游提交 昨天

Read-only codebase investigation via Explore agent; also handles upward-zoom for unfamiliar code regions. Triggers "how does X work", "where is X", "find X", "understand X", "navigate codebase", "zoom out", "bigger picture", "where does this fit".

适合你,如果想快速弄清陌生代码库的来龙去脉

/ 通过 npx 安装 校验哈希
npx oh-my-skill add darkroomengineering/cc-settings/explore
/ 通过 bash 安装
curl -fsSL https://oh-my-skill.com/install.sh | bash -s -- darkroomengineering/cc-settings/explore
/ 已经装过?验证本机副本,不用重装
npx oh-my-skill verify darkroomengineering/cc-settings/explore
安装目标可用 --agent / --scope 或 --to 明确指定;省略时只会在唯一已存在的 agent 目录上自动选择,零命中或多命中会停止并提示。content_hash 缺失或不一致均拒装。
40GitHub stars
~638上下文体积 · 单文件
索引托管

怎么用

商店整理自技能原文 · 版本 fa04efc · 表述以原文为准
它做什么

装上后,Claude 会启动只读的 Explore agent 调查代码。它不修改文件,而是根据你的问题选择两种模式:广域调查(从全局找起)或向上缩放(聚焦已知代码看它如何融入系统),最后返回文件位置、流程解释等总结。

什么时候触发

当你询问“某个功能如何工作”、“某段代码在哪里”,或者要求“看整体结构”、“这个模块怎么融入系统”时触发。

装好后可以这样说
触发广域调查模式。
触发向上缩放模式。
触发依赖追踪。
技能原文 SKILL.md作者撰写 · MIT · fa04efc

Codebase Exploration

Delegates to the Explore agent for fast, read-only investigation of the codebase.

Current State
  • Directory: !pwd 2>/dev/null
  • Project: !basename "$(pwd)" 2>/dev/null
  • Stack: !ls package.json Cargo.toml go.mod pyproject.toml 2>/dev/null || echo "unknown"
  • Git root: !git rev-parse --show-toplevel 2>/dev/null || echo "not a git repo"
Two modes — pick by what the user asked
Broad investigation mode (default)

Use when the user is asking "how does X work" / "where is X" / "what handles Y" — finding code without a known starting point.

  1. Start broad - Use tldr semantic or Glob to find relevant files
  2. Narrow down - Read specific files to understand implementation
  3. Trace connections - Use tldr impact to find callers/dependencies
  4. Summarize findings - Return clear, actionable summary
Upward-zoom mode

Use when the user is staring at a known function or module and needs to know how it fits — triggers like "zoom out", "bigger picture", "where does this fit", onboarding unfamiliar code.

  1. Follow [../context-doc/DOMAIN-AWARENESS.md](../context-doc/DOMAIN-AWARENESS.md) — read CONTEXT.md and any relevant ADRs first if they exist.
  2. Identify the symbol or file the user is asking about.
  3. Use TLDR for the structural answer:

``bash tldr context <symbol> --depth 3 --project . tldr impact <symbol> --project . ``

  1. Synthesize a map: list immediate callers, the modules they live in, and where this area sits in the system. Use CONTEXT.md vocabulary when naming concepts.
  2. Stop at one layer up. The user can ask for another zoom-out if they need it.

Upward-zoom output shape:

{Symbol/file in question}
  ↑ called by: {module A}, {module B}
  ↓ depends on: {module C}, {module D}

Where this fits:
{1–2 sentence narrative using CONTEXT.md terms}

Related ADRs:
- ADR-NNNN ({title}) — relevant because…

The point is orientation, not exhaustive coverage.

Output Format (broad mode)

Return a concise summary:

  • Location: Key files and their paths
  • How it works: Brief explanation of the flow
  • Key functions/components: Entry points
  • Dependencies: What it relies on
  • Suggestions: If the user needs to modify something
Remember
  • You are READ-ONLY - do not modify files
  • Return summaries, not raw file contents
  • Be specific with file paths and line numbers
按 MIT 许可原样转载,未经改动 · 在 GitHub 查看 →

评论

登录即可评论;带「已验证安装」的,是发布者名下有本店的安装或持有记录。