Back to Details

groove-utilities-task-doctor

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

groove-utilities-task-doctor

groove-utilities-task-doctor

Outcome

执行结果

All task backend health checks pass. User knows if the task backend is correctly configured, installed, and reachable.

所有任务后端健康检查通过。用户可得知任务后端是否配置正确、安装成功且可访问。

Acceptance Criteria

验收标准

Each check is reported with ✓ or ✗
Each failure includes a specific remediation command
Checks cover config, CLI installation, and reachability

每项检查结果用 ✓ 或 ✗ 标识
每项失败结果都附带具体的修复命令
检查覆盖配置、CLI安装、可访问性三个维度

Checks (run in order)

检查项（按顺序执行）

```
.groove/index.md
```
exists at git root
```
tasks:
```
key is present and has a valid value (
```
beans
```
,
```
linear
```
,
```
github
```
, or
```
none
```
)
If
```
tasks: none
```
— report no-op and exit (all green)

Backend CLI is installed:

```
beans
```
:
```
beans --version
```
```
linear
```
:
```
linear --version
```
```
github
```
:
```
gh --version
```

Backend-specific config file exists:
- ```
beans
```
  :
```
.beans.yml
```
  at git root
- ```
linear
```
  : auth token configured
- ```
github
```
  :
```
gh auth status
```
Backend is reachable (lightweight read operation):
- ```
beans
```
  :
```
beans list --json
```
  (or equivalent)
- ```
linear
```
  : list one issue
- ```
github
```
  :
```
gh issue list --limit 1
```

AGENTS.md

contains

<!-- groove:task:start -->

section (if

tasks: beans

)

git根目录下存在
```
.groove/index.md
```
存在
```
tasks:
```
配置项且值合法（可选值为
```
beans
```
、
```
linear
```
、
```
github
```
或
```
none
```
）
若
```
tasks: none
```
— 提示无操作并退出（全部检查通过）

后端CLI已安装：

```
beans
```
:
```
beans --version
```
```
linear
```
:
```
linear --version
```
```
github
```
:
```
gh --version
```

后端专属配置文件存在：
- ```
beans
```
  : git根目录下存在
```
.beans.yml
```
- ```
linear
```
  : 已配置身份认证令牌
- ```
github
```
  :
```
gh auth status
```
  校验通过
后端可访问（执行轻量读操作校验）：
- ```
beans
```
  :
```
beans list --json
```
  （或等效命令）
- ```
linear
```
  : 成功列出1个issue
- ```
github
```
  :
```
gh issue list --limit 1
```
  执行成功

若

tasks: beans

，则

AGENTS.md

中包含

<!-- groove:task:start -->

标记段

Remediation hints

修复提示

Failure	Remediation
`.groove/index.md` missing	`/groove-utilities-task-config` or `/groove config`
Backend not installed	`/groove-utilities-task-install`
`.beans.yml` missing	`/groove-utilities-task-install` (will scaffold)
Backend unreachable	Check auth / network, re-run `/groove-utilities-task-install`
`AGENTS.md` section missing	`/groove install`

失败场景	修复方案
缺少 `.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`

Constraints

约束条件

Report all checks even if an early one fails — give the full picture
Do not attempt to fix issues — report and suggest only
If
```
tasks: none
```
, show one green line: "tasks: none — task commands disabled" and exit

即使前期检查项失败，也要返回所有检查项的结果，提供完整的状态全景
不要尝试自动修复问题，仅上报问题并给出建议
若
```
tasks: none
```
，仅展示一行通过提示："tasks: none — 任务命令已禁用" 后退出