メニュー
Workflows and protocols for Pathfinder v6 semantic navigation tools (locate, trace, inspect). Covers: semantic addressing, dual-channel response model, tri-state evidence, budget controls, and error recovery.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/irahardianto/pathfinder --skill pathfinderコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
| name | pathfinder |
| description | Workflows and protocols for Pathfinder v6 semantic navigation tools (locate, trace, inspect). Covers: semantic addressing, dual-channel response model, tri-state evidence, budget controls, and error recovery. |
Pathfinder v6 exposes exactly 3 precision navigation tools:
| Tool | Purpose | Key Parameters |
|---|---|---|
locate | Jump to definition, batch locate definitions, or resolve file:line to semantic path | semantic_path, locations, file, line |
trace | Callers/callees hierarchy, references lookup, and symbol overview | semantic_path, scope (callers |
inspect | Extract symbol source, batch read symbols, and analyze outgoing dependencies | semantic_path, semantic_paths, include_dependencies, max_dependencies |
All symbol-level tools require semantic paths in file_path::symbol_chain format:
src/auth.ts::AuthService.logincrates/pathfinder/src/server.rs::PathfinderServer.newSymbol segments are separated by . (e.g. ClassName.method_name).
Every tool returns dual-channel output:
status, confidence, evidence, and diagnostic indicators.ToolStatus::Ok: Normal operational success with verified compilation/LSP results.ToolStatus::NotReady: LSP indexing/warmup in progress. Check retry_after_secs and retry with retry_attempt = attempt + 1.ToolStatus::Degraded: Fallback mode (tree-sitter / ripgrep).ToolStatus::Unavailable: Language server unavailable.Verified: Compiler / LSP confirmed truth.Heuristic: Best-effort tree-sitter or ripgrep fallback (marked [HEURISTIC]).null = UNKNOWN (degraded / unverified — callers/callees/references may exist, do NOT treat as zero).[] = CONFIRMED ZERO (LSP verified that exactly zero references/callers exist).| I want to... | Tool & Parameters |
|---|---|
| Jump to a definition | locate(semantic_path="src/auth.ts::AuthService.login") |
| Batch jump to definitions | locate(locations=[{semantic_path: "..."}, {file: "...", line: 42}]) |
| Convert file:line to semantic path | locate(file="src/auth.ts", line=42) |
| Read symbol source code | inspect(semantic_path="src/auth.ts::AuthService.login") |
| Inspect symbol + dependencies | inspect(semantic_path="...", include_dependencies=true) |
| Batch read symbols | inspect(semantic_paths=["...", "..."]) (max 10) |
| Trace callers & callees | trace(semantic_path="...", scope="callers") |
| Trace all references | trace(semantic_path="...", scope="references") |
| Full symbol overview | trace(semantic_path="...", scope="overview") |
| Parameter | Tool | Default | Purpose |
|---|---|---|---|
max_references | trace | 20 | Cap total references in references and overview scopes |
max_depth | trace | 1 | BFS traversal depth. Hard ceiling 2 — requests above 2 are rejected, not clamped. scope="callers" only |
max_dependencies | inspect | 50 | Cap outgoing dependency entries (with include_dependencies=true) |
If Pathfinder tools are unavailable or return ToolStatus::Unavailable, fall back gracefully to built-in host tools (Read, Grep, Glob). Do not block.