groove-admin-doctor

用途

groove-admin-doctor 用于对 groove 技能体系做一次完整的健康检查，并输出一份合并后的汇总报告。运行后，用户能清楚知道哪些部分工作正常、哪些配置有误，以及针对任何失败应执行什么操作。

主要能力

该技能会依次运行以下检查：

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。
task 检查：运行 /groove-utilities-task-doctor。
memory 检查：运行 /groove-utilities-memory-doctor。
companion 技能检查：直接检查以下文件是否存在：
- ls .agents/skills/find-skills/SKILL.md
- ls .agents/skills/agent-browser/SKILL.md
- ls .agents/skills/pdf-to-markdown/SKILL.md 缺失时提示 ✗ <name> not installed — run: /groove-admin-install。
平台符号链接检查：对 .agents/skills/ 中每个 groove-* 目录，检查 .claude/skills/<name> 是否为指向 ../../.agents/skills/<name> 的符号链接。缺失、非符号链接或链接损坏时提示 ✗ ... — run: /groove-admin-install。同时检查 .cursor/skills/ 目录是否存在，不存在则提示 ✗ .cursor/skills/ missing — run: /groove-admin-install；存在则按同样方式检查各 groove 符号链接。全部健康时显示 ✓ platform symlinks (.claude/, .cursor/)。
Claude Code 原生 hooks 检查：检查 .claude/settings.json 是否存在。存在则解析 JSON，验证 hooks 键中是否包含 groove 的 hook 条目（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 (...)。
Cursor 原生 hooks 检查：若 .cursor/ 存在，检查 .cursor/hooks.json 是否存在。存在则解析 JSON，验证 hooks 键中是否包含 groove 的 hook 条目（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 (...)。若 .cursor/ 不存在则静默跳过。

使用方式

运行该技能后，输出按子技能分组，逐项显示通过/失败，并给出总体状态（全部健康，或发现 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.

适用场景

适用于需要确认 groove 技能体系整体配置是否正确的场合，例如安装或更新后验证、排查子技能异常、检查平台符号链接与原生 hooks 是否就绪。

限制

该技能只做报告，不会尝试自动修复问题。
检查按固定顺序执行：先 git 仓库检查，再版本检查，然后依次运行 /groove-utilities-task-doctor、/groove-utilities-memory-doctor、companion 检查，之后是平台符号链接、Claude Code 原生 hooks、Cursor 原生 hooks。
所有结果需收集完毕后再统一打印，不与检查进度交错输出。
每个 ✗ 项必须在同一行包含具体的修复命令。
无问题时以清晰的“all healthy”消息结束。

技能介绍

用途

主要能力

使用方式

适用场景

限制