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-install
  • 检查 ls .agents/skills/agent-browser/SKILL.md——如果不存在：✗ agent-browser not installed — run: /groove-admin-install
  • 检查 ls .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 并确认其中包含 groove 的钩子条目（hooks 键中的 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 并确认其中包含 groove 的钩子条目（hooks 键中的 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）
• 收集完所有结果后再打印——不要在检查过程中穿插输出
• 每个 ✗ 项目都必须在同一行包含明确的修复命令
• 如果未发现问题，则以明确的“全部正常”消息结束
• 不要尝试自动修复问题——只报告