groove-admin-doctor について
groove-admin-doctorは、grooveと関連スキルの状態や設定を確認する診断スキルです。項目ごとの結果と対処方法を報告し、自動修復は行いません。
主な機能
- 01リポジトリとバージョンの確認
- 02タスクとメモリーの診断実行
- 03関連スキルとシンボリックリンクの検証
- 04Claude CodeとCursorのフック確認
- 05失敗項目と対処方法の報告
活用シーン
- 01grooveのインストール状態の診断
- 02不足しているフックや関連スキルの特定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ andreadellacorte/ groove --skill groove-admin-doctorインストール後、Claude Code で/groove-admin-doctorを入力して読み込まれたか確認します。
詳細
groove-admin-doctor
結果
すべての groove サブスキルのヘルスチェックが実行され、統合された概要が報告されます。ユーザーは、何が正常に動作しているか、何が正しく設定されていないか、失敗した場合にどのような対応を取るべきかを正確に把握できます。
受け入れ基準
/groove-utilities-task-doctorと/groove-utilities-memory-doctorが実行される- 関連スキルの存在が直接確認される
- サブスキルごとに、各チェックの合格/不合格が表示される
- 全体のステータスとして、すべて正常、または N 件の問題が見つかったことが表示される
- 各失敗に具体的な修正アクションが含まれる
出力形式
groove doctor
─────────────────────────────────────
groove
✓ git repo: detected
✓ groove-version: 0.1.0
✓ installed version: 0.1.0
✓ up to date
task
✓ .groove/index.md present
✓ tasks.backend: beans
✓ beans installed (v0.x.x)
✓ .beans.yml present
✓ beans reachable
memory
✓ memory path exists (.groove/memory/) [hardcoded]
✓ memory dirs exist (.groove/memory/daily/, weekly/, monthly/, git/)
companions
✓ find-skills installed
✓ agent-browser installed
✓ pdf-to-markdown installed
platform symlinks
✓ .claude/skills/groove → ../../.agents/skills/groove
✗ .cursor/skills/ missing — run: /groove-admin-install
─────────────────────────────────────
1 issue found. Run the suggested commands above to fix.
制約
- まず git リポジトリの確認を実行し、次にバージョンの確認を実行してから、
/groove-utilities-task-doctor、/groove-utilities-memory-doctor、コンパニオンの確認を順に実行します - Git リポジトリの確認:
- 現在のディレクトリで
git rev-parse --is-inside-work-treeを実行します - 成功した場合:
✓ git repo: detected - 失敗した場合:
✗ git repo: not a git repository — groove requires a git repo
- 現在のディレクトリで
- バージョンの確認:
.groove/index.mdからgroove-version:を読み取ります(存在しない場合は0.1.0として扱います)skills/groove/SKILL.mdからversion:を読み取ります- 一致しない場合:
✗ groove-version (<local>) behind installed (<installed>) — run: /groove-admin-update
- コンパニオンの確認:
ls .agents/skills/find-skills/SKILL.mdを確認します。存在しない場合:✗ find-skills not installed — run: /groove-admin-installls .agents/skills/agent-browser/SKILL.mdを確認します。存在しない場合:✗ agent-browser not installed — run: /groove-admin-installls .agents/skills/pdf-to-markdown/SKILL.mdを確認します。存在しない場合:✗ pdf-to-markdown not installed — run: /groove-admin-install
- プラットフォームのシンボリックリンクの確認(コンパニオンの後):
.agents/skills/内の各groove-*ディレクトリについて、.claude/skills/<name>が../../.agents/skills/<name>を指すシンボリックリンクであることを確認します- 存在しない場合、またはシンボリックリンクではない場合:
✗ .claude/skills/<name> not a symlink — run: /groove-admin-install - シンボリックリンクが壊れている場合(リンク先が存在しない場合):
✗ .claude/skills/<name> broken symlink — run: /groove-admin-install
- 存在しない場合、またはシンボリックリンクではない場合:
.cursor/skills/ディレクトリが存在するか確認します- 存在しない場合:
✗ .cursor/skills/ missing — run: /groove-admin-install - 存在する場合:各 groove シンボリックリンクを上記と同様に確認します
- 存在しない場合:
- すべてのシンボリックリンクが正常な場合:
✓ platform symlinks (.claude/, .cursor/)
- Claude Code ネイティブフックの確認(プラットフォームのシンボリックリンクの後):
.claude/settings.jsonが存在するか確認します- 存在する場合:JSON を解析し、
hooksキーに groove のフックエントリ(daily-end-reminder、git-activity-buffer、block-managed-paths、context-reprime、version-check、session-captureコマンド)があることを確認します- エントリが欠けている場合、それぞれ:
✗ .claude/settings.json missing groove hook <name> — run: /groove-admin-claude-hooks
- エントリが欠けている場合、それぞれ:
- 存在しない場合:
ℹ .claude/settings.json not present — run /groove-admin-claude-hooks to install native hooks (optional) - すべて存在する場合:
✓ Claude Code native hooks (daily-end-reminder, git-activity-buffer, block-managed-paths, context-reprime, version-check, session-capture)
- Cursor ネイティブフックの確認(Claude Code フックの後):
.cursor/ディレクトリが存在するか確認します.cursor/が存在する場合:.cursor/hooks.jsonが存在するか確認します- 存在する場合:JSON を解析し、
hooksキーに groove のフックエントリ(context-reprime、daily-end-reminder、git-activity-buffer、block-managed-paths、version-check、session-captureコマンド)があることを確認します- エントリが欠けている場合、それぞれ:
✗ .cursor/hooks.json missing groove hook <name> — run: /groove-admin-cursor-hooks
- エントリが欠けている場合、それぞれ:
- 存在しない場合:
ℹ .cursor/hooks.json not present — run /groove-admin-cursor-hooks to install native hooks (optional) - すべて存在する場合:
✓ Cursor native hooks (context-reprime, daily-end-reminder, git-activity-buffer, block-managed-paths, version-check, session-capture)
.cursor/が存在しない場合:何もせずにスキップします(Cursor を使用していません)
- 結果はすべて収集してから出力します。確認の進捗と出力を混在させないでください
- 各
✗項目には、同じ行に具体的な修正コマンドを記載する必要があります - 問題が見つからなかった場合は、すべて正常であることを明確に示して終了します
- 問題の自動修正は試みず、報告のみ行います
コメント
Markdown 対応