mcpField
G
groove-utilities-task-doctor

groove-utilities-task-doctor

github.com/andreadellacorte生产力6551 次安装14 周前更新
代码仓库

关于 groove-utilities-task-doctor

面向 Groove 项目的任务后端诊断技能，检查配置、CLI 安装、身份验证和连通性，并为失败项提供修复命令建议，不会自行更改设置。

主要功能

  1. 01检查 Groove 任务配置
  2. 02验证后端 CLI 是否安装
  3. 03测试身份验证和连通性
  4. 04逐项报告检查结果与修复建议
  5. 05不更改现有设置

适用场景

  1. 01使用任务命令前诊断后端
  2. 02查找缺失的配置或 CLI 工具
  3. 03任务操作失败时检查后端访问

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/andreadellacorte/groove --skill groove-utilities-task-doctor

安装后在 Claude Code 中输入/groove-utilities-task-doctor确认已加载。

详细介绍

groove-utilities-task-doctor

目标

所有任务后端健康检查均通过。用户可以了解任务后端是否已正确配置、安装并可访问。

验收标准

  • 每项检查都用 ✓ 或 ✗ 报告
  • 每项失败都包含具体的修复命令
  • 检查涵盖配置、CLI 安装和可访问性

检查项（按顺序运行）

  1. Git 根目录下存在 .groove/index.md
  2. 存在 tasks.backend 键，且值有效（beans、linear、github 或 none）
  3. 如果 tasks.backend: none，则报告无需执行并退出（全部通过）
  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. AGENTS.md 包含 `` 部分（如果是 tasks: beans）

修复提示

失败项修复方法
缺少 .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

限制

  • 即使较早的检查失败，也要报告所有检查结果，以便全面了解情况
  • 不要尝试修复问题，只报告并提供建议
  • 如果是 tasks: none，仅显示一行绿色状态：“tasks: none — task commands disabled”，然后退出

评论

支持 Markdown