groove-admin-doctor

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

groove-admin-doctor

Outcome

预期效果

All groove sub-skill health checks are run and a consolidated summary is reported. User knows exactly what is working, what is misconfigured, and what action to take for any failure.

所有groove子技能健康检查都会执行，并输出整合后的摘要报告。用户可以清楚知晓哪些功能运行正常、哪些配置错误，以及针对故障需要采取的操作。

Acceptance Criteria

验收标准

/groove-utilities-task-doctor

and

/groove-utilities-memory-doctor

are run

Companion skill presence is checked directly
Results are shown per sub-skill with pass/fail per check
Overall status is shown: all healthy, or N issues found
Each failure includes a specific remediation action

/groove-utilities-task-doctor

和

/groove-utilities-memory-doctor

会被执行

直接检查配套技能是否存在
按子技能展示结果，每项检查标注通过/失败
展示整体状态：全部健康，或发现N个问题
每个故障项都附带具体的修复操作

Output format

输出格式

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: beans
  ✓ beans installed (v0.x.x)
  ✓ .beans.yml present
  ✓ beans reachable

memory
  ✓ memory path exists (.groove/memory/)
  ✓ memory dirs exist (.groove/memory/daily/, weekly/, monthly/, git/)

companions
  ✓ find-skills installed
  ✓ agent-browser installed
  ✓ pdf-to-markdown installed

AGENTS.md
  ✓ groove:prime section present
  ✗ groove:task section missing — run: /groove-admin-install

─────────────────────────────────────
1 issue found. Run the suggested commands above to fix.

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: beans
  ✓ beans installed (v0.x.x)
  ✓ .beans.yml present
  ✓ beans reachable

memory
  ✓ memory path exists (.groove/memory/)
  ✓ memory dirs exist (.groove/memory/daily/, weekly/, monthly/, git/)

companions
  ✓ find-skills installed
  ✓ agent-browser installed
  ✓ pdf-to-markdown installed

AGENTS.md
  ✓ groove:prime section present
  ✗ groove:task section missing — run: /groove-admin-install

─────────────────────────────────────
1 issue found. Run the suggested commands above to fix.

Constraints

约束条件

Run git repo check first, then version check, then
```
/groove-utilities-task-doctor
```
,
```
/groove-utilities-memory-doctor
```
, companions check in sequence

Git repo check:

Run
```
git rev-parse --is-inside-work-tree
```
in the current directory
If it succeeds:
```
✓ git repo: detected
```

If it fails:

✗ git repo: not a git repository — groove requires a git repo

Version check:

Read
```
groove-version:
```
from
```
.groove/index.md
```
(if absent, treat as
```
0.1.0
```
)
Read
```
version:
```
from
```
skills/groove/SKILL.md
```

If they differ:

✗ groove-version (<local>) behind installed (<installed>) — run: /groove-admin-update

Companions check:

Check

ls .agents/skills/find-skills/SKILL.md

— if absent:

✗ find-skills not installed — run: /groove-admin-install

Check

ls .agents/skills/agent-browser/SKILL.md

— if absent:

✗ agent-browser not installed — run: /groove-admin-install

Check

ls .agents/skills/pdf-to-markdown/SKILL.md

— if absent:

✗ pdf-to-markdown not installed — run: /groove-admin-install

Also check

AGENTS.md

for presence of

<!-- groove:prime:start -->

and

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

sections

Collect all results before printing — do not interleave output with check progress
Each
```
✗
```
item must include a concrete remediation command on the same line
Exit with a clear "all healthy" message if no issues found
Do not attempt to auto-fix issues — report only

先运行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.md

中是否存在

<!-- groove:prime:start -->

和

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

区块

收集全部检查结果后再打印输出 — 不要在检查过程中穿插输出内容
每个
```
✗
```
项必须在同一行附带具体的修复命令
如果未发现任何问题，最终输出清晰的「全部健康」提示
不要尝试自动修复问题 — 仅做报告