groove-utilities-task-doctor

用途

groove-utilities-task-doctor 用于检查任务后端（task backend）的健康状态与连通性。目标是让所有任务后端健康检查通过，并让用户了解任务后端是否已正确配置、安装且可访问。

主要能力

该技能按顺序执行以下检查，每项结果以 ✓ 或 ✗ 标记：

1. git 根目录下存在 .groove/index.md
2. tasks.backend 键存在且取值有效（beans、linear、github 或 none）
3. 若 tasks.backend 为 none —— 报告空操作（no-op）并退出（全部为绿色）
4. 后端 CLI 是否安装：beans 使用 beans version，linear 使用 linear --version，github 使用 gh --version
5. 后端专属配置文件是否存在：beans 检查 git 根目录下的 .beans.yml；linear 检查认证令牌是否已配置；github 检查 gh auth status
6. 后端是否可连通（执行轻量读取操作）：beans 使用 beans list --json（或等价命令）；linear 列出单个 issue；github 使用 gh issue list --limit 1
7. 若 tasks 为 beans，检查 AGENTS.md 是否包含 <!-- groove:task:start --> 段落

使用方式

运行该技能后，它会逐项报告检查结果。每个失败项都会附带具体的修复命令建议，例如：

• .groove/index.md 缺失 → /groove-utilities-task-config 或 /groove config
• 后端未安装 → /groove-utilities-task-install
• .beans.yml 缺失 → /groove-utilities-task-install（会进行脚手架生成）
• 后端不可连通 → 检查认证 / 网络，重新运行 /groove-utilities-task-install
• AGENTS.md 段落缺失 → /groove install

适用场景

适合在配置或排查 groove 任务后端（beans、linear、github）时使用，用于快速确认后端是否就绪、定位配置或连接问题。当 tasks.backend 设置为 none 时，会显示一行绿色信息“tasks: none — task commands disabled”并退出。

限制

• 即使较早的某项检查失败，也会继续报告所有检查项，以提供完整情况。
• 该工具不会尝试修复问题，只做报告并给出建议。
• 当 tasks.backend 为 none 时，仅报告空操作并退出。