Smartgift-AI/AgentHub
14
0
Fork 0
Code Issues 3 Pull Requests Actions Packages Projects Releases 86 Wiki Activity
Files
ae9b3dbcd57e85b791a4beec837bbfb82fc3e205
AgentHub/skills/mcp-operations/references/runbook.md
T
nntrivi2001 b7c573f8d9 feat(plugin): ship the repo's skills as ccam plugin skills 
The repo root already IS the `ccam` plugin root (`"source": "./"`), so the
conventional `skills/` dir at the root is the plugin's skills dir — while
`.claude/skills/` only loaded for a session whose cwd was inside this
checkout. That is useless for a lane working in another repo, which is why
`ccam skills install` existed at all.

Move all seven skills to `skills/`: they now reach every plugin user as
`/ccam:<name>` (bare `/<name>` as an alias). `ccam skills install` stays as
the fallback for a plain checkout without the plugin, sourcing from the new
path.

Agents deliberately do NOT move. A plugin agent is addressed as
`ccam:qc-local`, which would break the `subagent_type: qc-local` references
in ship-feature-lane; `ccam lanes agents install` keeps writing them into the
lane's own `.claude/agents/`, the highest-priority agent source. MCP was
already plugin-shipped via `plugins/ccam/.mcp.json`.

Mechanical fallout: ~115 source files carry a doc-comment pointer to
`.claude/skills/file-headers/`, repointed to `skills/file-headers/`. The
generic Claude Code config-surface examples in openapi/cc-config (`.claude/
skills/code-reviewer`) describe any user's layout and are left alone.

Also fixes the two file-headers scripts, whose `ROOT=` climbed four levels
from `.claude/skills/file-headers/scripts/` and would have escaped the repo
from the new depth — it scanned sibling projects until corrected to three.

npm run test:server (1160 pass), test:client (422 pass), mcp:typecheck,
mcp:build + mcp:check-build all green.
2026-08-21 17:17:33 +07:00

537 B
Raw Blame History

MCP Runbook

Read-only daily mode

  • Keep both mutation flags false.
  • Use read tools for observability and reporting.

Admin mode

  • Set MCP_DASHBOARD_ALLOW_MUTATIONS=true.
  • Run maintenance/pricing operations.
  • Reset mutation flag to false after completion.

Destructive mode

  • Set both mutation and destructive flags true.
  • Execute destructive command only with explicit confirmation token.
  • Immediately disable destructive flag after operation.

Verification commands

  • npm run mcp:typecheck
  • npm run mcp:build
Reference in New Issue View Git Blame Copy Permalink