القائمة
Use for symbol-level semantic code search, hybrid retrieval, or CodeGraph exploration seeded with vector candidates.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/delorenj/skills --skill codegraph-voyageيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
Consult before ANY coding task. Chooses the optimal coding agent strategy based on task complexity, available free tokens, parallelism potential, and provider quotas. Covers: OpenClaw sub-agents, Codex CLI, Claude Flow swarms/hive-minds, Jules (Google), GitHub Copilot coding models, Augment Code, Kimi K2.5, and OpenAI gpt-5.3-codex. All agents must read this before writing code.
Use for stateless cron or event-driven contractor jobs.
Use Orca orchestration for structured multi-agent coordination: threaded messages, blocking ask/reply flows, task dispatch, worker_done/escalation waits, task DAGs, decision gates, coordinator loops, or decomposing work across agents. Use `orca-cli` instead for full ownership handoffs, including requests phrased as "hand off", "handoff", "handover", "give this to another agent", or "another worktree" when the user did not explicitly ask to supervise, monitor, wait for results, or coordinate a DAG. Use `orca-cli` for ordinary terminal control, lightweight terminal prompts, shell commands, Orca worktree management, reading or waiting on terminals, and automation of the browser embedded inside Orca. Use Computer Use for browser windows, webviews, Orca app UI, or desktop UI outside Orca's embedded browser.
عرض SKILL.md
| name | codegraph-voyage |
| description | Use for symbol-level semantic code search, hybrid retrieval, or CodeGraph exploration seeded with vector candidates. |
codegraph-voyage is a symbol-level semantic retrieval sidecar for CodeGraph. It builds embeddings from .codegraph/codegraph.db, stores them separately in .codegraph/codegraph-voyage.db, and combines lexical and vector candidates for search and codegraph explore.
Use it when the user asks for semantic code search, hybrid lexical/vector retrieval, or a CodeGraph exploration seeded by semantically relevant symbols. Run commands from a project root containing .codegraph/codegraph.db and the tools/codegraph_voyage/ sidecar package.
python3 -m tools.codegraph_voyage index [--provider fake|voyage] [--dimensions N]
python3 -m tools.codegraph_voyage search "query" [--provider fake|voyage] [--top-k N] [--json]
python3 -m tools.codegraph_voyage status
python3 -m tools.codegraph_voyage explore "query" [--provider fake|voyage] [--dry-run]
search is also available as semantic_candidates. Index before searching when .codegraph/codegraph-voyage.db is absent or stale. Use status to inspect the CodeGraph and embedding indexes.
The fake provider is deterministic, offline, and suitable for development and CI. The voyage provider sends locally sanitized source-derived text to Voyage AI. Use it only when remote processing is acceptable.
Load the key into the environment from 1Password, then run the command:
export VOYAGE_API_KEY="$(op read 'op://DeLoSecrets/Voyage AI/API Key')"
python3 -m tools.codegraph_voyage index --provider voyage
Never put the key in CLI arguments, source files, logs, or MCP tool arguments.
This skill includes an optional hook bundle that keeps an existing CodeGraph Voyage index fresh without joining or modifying any global lifecycle publisher. The hook runtime is project-scoped and only acts when the project contains both .codegraph/codegraph.db and tools/codegraph_voyage/.
# Generate deterministic native fragments under hooks/generated/
python3 scripts/hooks-fanout.py render
python3 scripts/hooks-fanout.py check
# Install into one project only (surgical merge; unrelated hooks are preserved)
python3 scripts/hooks-fanout.py install --project-root /absolute/project
python3 scripts/hooks-fanout.py uninstall --project-root /absolute/project
The runtime defaults to the offline deterministic fake provider. Remote Voyage processing is never automatic: opt in per project with CODEGRAPH_VOYAGE_HOOK_PROVIDER=voyage in the client runtime environment or {"codegraph_voyage":{"hook_provider":"voyage"}} in gitignored .agents/local.json. The client must inherit VOYAGE_API_KEY; never put that key in hook JSON, config arguments, logs, or tool payloads. Set the provider to off to disable refreshes.
Read references/hooks.md for lifecycle behavior, generated client mappings, safety properties, and local configuration.
Use the packaged codegraph-voyage-mcp server when an MCP client should invoke the sidecar interactively. Its tools are index, search, semantic_candidates, status, and explore; every call requires an explicit project_path. The MCP server is separate from both this instructional skill and the optional lifecycle hooks. It inherits VOYAGE_API_KEY from its environment and never accepts the key as a tool argument.
Read references/mcp-server.md for installation, transport configuration, and tool details.