메뉴
Repository-specific workflow for installing, registering, initializing, validating, or troubleshooting CodeGraph MCP for Graft. Use when the task mentions CodeGraph, codegraph init, codegraph serve --mcp, MCP navigation, /mcp missing codegraph, or turning CodeGraph setup into a repeatable repository workflow.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Repository-specific loop orchestrator for Graft multi-agent tasks. Use when one bounded task should run through repeated same-session serial worker-subagent rounds of `graft-multi-agent-task` under the default `topic-completion-loop` mode until the topic reaches `archive-ready`, becomes `blocked`, or no remaining batches stay in scope.
Repository-specific multi-agent coordination workflow for Graft. Use when the user explicitly wants subagent delegation, or when the current task cleanly splits into two or more disjoint slices across server, web, docs, or automation, and the main agent should keep ownership of review, validation, and final integration. `graft-boot` should assess whether this skill is justified before delegation starts.
Repository-specific workflow wrapper for Graft multi-agent tasks. Use when a task should be executed through `graft-multi-agent-batch`, and the slice may need `graft-task-closeout` plus `graft-commit` to finish with a safe handoff after validation.
Repository-specific end-of-task closeout workflow for Graft. Use when a task slice is ending and the agent needs to decide whether to emit only a next-step startup prompt or to commit the current validated slice first and then hand off safely. This is the default slice-end path for work started through `graft-boot`.
Manage reusable Graft AI-agent worktrees through guarded status, acquire, and release commands without treating directories or task branches as long-lived ownership.
Repository-specific Playwright browser workflow for inspecting, authenticating into, and interacting with the local Graft web UI. Use when Codex needs Graft browser screenshots, DOM text snapshots, login/auth verification with temp credentials, or simple click/fill/wait checks before normal web validation.
| name | graft-codegraph-mcp |
| description | Repository-specific workflow for installing, registering, initializing, validating, or troubleshooting CodeGraph MCP for Graft. Use when the task mentions CodeGraph, codegraph init, codegraph serve --mcp, MCP navigation, /mcp missing codegraph, or turning CodeGraph setup into a repeatable repository workflow. |
Use this skill to set up or verify CodeGraph MCP as a developer-local AI navigation aid for Graft.
Treat root AGENTS.md and ai-plan/design/governance/ai/CodeGraph-MCP-辅助开发规范.md as the source of truth. This skill does not
replace startup governance, authority discovery, direct source reads, or repository validation entrypoints.
AGENTS.md before repository conclusions or edits.docs/automation unless the task also changes server or web.AGENTS.md.ai/environment/tools.ai.yamlai-plan/design/governance/ai/CodeGraph-MCP-辅助开发规范.mdgit status --short before edits. If other agents have changes, keep this skill's scope limited to
.agents/skills/graft-codegraph-mcp/**, CodeGraph governance docs, .gitignore, and confirmed CodeGraph-only
hunks.Check whether the CLI exists:
command -v codegraph
codegraph --version
If missing, install outside project dependencies:
bunx @colbymchenry/codegraph
or, for a PATH-installed CLI:
bun add -g @colbymchenry/codegraph
Never run bun add @colbymchenry/codegraph inside web, and never add CodeGraph to web/package.json,
web/bun.lock, server/go.mod, CI, hooks, or runtime scripts.
Register Codex MCP when the user wants Codex integration:
codex mcp add codegraph -- codegraph serve --mcp
Verify Codex configuration:
codex mcp list
codex mcp get codegraph
If /mcp does not show CodeGraph after registration, ask the user to restart the Codex session. A configured MCP
server usually is not exposed to the already-running session's tool list until restart.
Initialize the current worktree from the repository root:
codegraph init -i
codegraph status
Confirm local index hygiene:
git check-ignore .codegraph/codegraph.db
git status --short
.codegraph/ must remain ignored and uncommitted.
codegraph missing from /mcp:
codex mcp listcodegraph entry exists, run the codex mcp add commandcodegraph command not found:
bun --versionbunx @colbymchenry/codegraph or bun add -g @colbymchenry/codegraph.codegraph/ appears in git status:
.codegraph/ in .gitignoregit rm --cached only if it was accidentally tracked, and keep the removal scopedcodegraph init -i or codegraph status to refresh local indexing evidenceai-plan/design/governance/frontend/TDesign-MCP-辅助开发规范.md; CodeGraph does not replace component docs.For this skill's own setup or docs changes, use the strongest honest docs/automation checks:
git diff --check -- .agents/skills/graft-codegraph-mcp AGENTS.md ai-plan/design/governance/ai/CodeGraph-MCP-辅助开发规范.md .gitignore
command -v codegraph
codegraph --version
codex mcp list
codex mcp get codegraph
codegraph status
git check-ignore .codegraph/codegraph.db
Do not run graft validate backend or bun run check for CodeGraph-only docs/automation changes unless the task also
changes server or web code.
Include a concise CodeGraph setup record when relevant:
CodeGraph MCP setup:
- cli: installed | missing | not_checked
- cli_version: <version or not-applicable>
- codex_mcp: registered | missing | not_checked
- project_index: initialized | missing | not_checked
- git_ignore: passed | failed | not_checked
- note: <restart needed / fallback used / no runtime dependency added>