groove-admin-install

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

groove-admin-install

Outcome

执行结果

All groove backends are installed in dependency order, groove-wide companion skills are installed, AGENTS.md contains the session bootstrap, and the repo is ready for use.

所有groove后端将按依赖顺序安装，全groove范围的配套skill已安装，AGENTS.md包含会话引导程序，仓库已准备就绪可投入使用。

Acceptance Criteria

验收标准

Task and memory backends installed
Companion skills installed (find-skills, agent-browser, pdf-to-markdown)
```
AGENTS.md
```
contains the
```

```
session bootstrap

AGENTS.md

contains a

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

stub (if

tasks: beans

)

User sees a summary of what was installed and what was written

任务和内存后端已安装
配套skill已安装（find-skills、agent-browser、pdf-to-markdown）
```
AGENTS.md
```
包含
```

```
会话引导程序

若配置为

tasks: beans

，

AGENTS.md

需包含

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

占位内容

用户可查看已安装内容和已写入内容的汇总信息

Steps

步骤

Run in order:

If
```
.groove/index.md
```
does not exist, run
```
/groove-admin-config --defaults
```
to create it with all defaults (no prompts)
Run
```
/groove-utilities-task-install
```
— installs the configured task backend (e.g. beans)
Run
```
/groove-utilities-memory-install
```
— creates memory directories

Install companion skills:

find-skills (downloaded): check

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

; if absent:

npx skills add https://github.com/vercel-labs/skills --skill find-skills

agent-browser (downloaded): check

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

; if absent:

npx skills add https://github.com/vercel-labs/agent-browser --skill agent-browser

pdf-to-markdown (embedded): check

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

; if absent:

npx skills add andreadellacorte/groove --skill pdf-to-markdown

Report each as installed / already-present / failed

Scaffold hooks and cache directories:
- Create
```
.groove/hooks/
```
  if it does not exist (with a
```
.gitkeep
```
  )
- Create
```
.groove/.cache/
```
  if it does not exist (with a
```
.gitkeep
```
  )
- Report each as created / already-present

Apply git strategy — write

.groove/.gitignore

from

git.*

sub-keys in

.groove/index.md

(see

/groove-admin-config

for rules)

Write the session bootstrap to

AGENTS.md

Replace any existing

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

<!-- groove:prime:end -->

section with:

<!-- groove:prime:start -->
**Run at the start of every session:**
`/groove-utilities-prime` — loads groove workflow context into the conversation
<!-- groove:prime:end -->

If section absent, append to end of
```
AGENTS.md
```
; preserve all other content

```
/groove-utilities-task-install
```
already wrote the
```

```
stub in step 2 — no additional AGENTS.md write needed here

按顺序执行：

若
```
.groove/index.md
```
不存在，运行
```
/groove-admin-config --defaults
```
以默认配置创建该文件（无交互提示）
运行
```
/groove-utilities-task-install
```
— 安装已配置的任务后端（如beans）
运行
```
/groove-utilities-memory-install
```
— 创建内存目录

安装配套skill：

find-skills（需下载）：检查

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

；若不存在，执行

npx skills add https://github.com/vercel-labs/skills --skill find-skills

agent-browser（需下载）：检查

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

；若不存在，执行

npx skills add https://github.com/vercel-labs/agent-browser --skill agent-browser

pdf-to-markdown（内置）：检查

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

；若不存在，执行

npx skills add andreadellacorte/groove --skill pdf-to-markdown

报告每个skill的状态：已安装/已存在/安装失败

搭建钩子和缓存目录：
- 若
```
.groove/hooks/
```
  不存在则创建（包含
```
.gitkeep
```
  文件）
- 若
```
.groove/.cache/
```
  不存在则创建（包含
```
.gitkeep
```
  文件）
- 报告每个目录的状态：已创建/已存在
应用Git策略 — 从
```
.groove/index.md
```
中的
```
git.*
```
子项写入
```
.groove/.gitignore
```
文件（规则详见
```
/groove-admin-config
```
）

将会话引导程序写入

AGENTS.md

：

替换任何已存在的

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

<!-- groove:prime:end -->

区域，内容如下：

<!-- groove:prime:start -->
**每次会话开始时运行：**
`/groove-utilities-prime` — 将groove工作流上下文加载到对话中
<!-- groove:prime:end -->

若该区域不存在，则追加到
```
AGENTS.md
```
末尾；保留所有其他内容

```
/groove-utilities-task-install
```
在步骤2中已写入
```

```
占位内容 — 无需在此步骤再次更新AGENTS.md

Constraints

约束条件

Read
```
.groove/index.md
```
for
```
tasks:
```
and
```
git.*
```
config before running
If
```
.groove/index.md
```
does not exist,
```
/groove-admin-config
```
is run first (step 1) to create it
Dependency order for backends must be respected: task → memory → companions
Each step reports installed / already-present / failed
```
AGENTS.md
```
update is additive per section — preserve all other content
If any step fails, report it clearly but continue with remaining steps
Companion skills (find-skills, agent-browser, pdf-to-markdown) are hardcoded here, not read from any config file

Report a final summary:

✓ task backend (beans)
✓ memory backend — memory dirs ready
✓ companion: find-skills
✓ companion: agent-browser
✓ companion: pdf-to-markdown
✓ hooks: .groove/hooks/ ready
✓ AGENTS.md updated (groove:prime, groove:task)

运行前需读取
```
.groove/index.md
```
中的
```
tasks:
```
和
```
git.*
```
配置
若
```
.groove/index.md
```
不存在，需先执行步骤1中的
```
/groove-admin-config
```
创建该文件
必须遵循后端的依赖顺序：任务 → 内存 → 配套工具
每个步骤需报告状态：已安装/已存在/失败
更新AGENTS.md时需按区域追加 — 保留所有其他内容
若任何步骤失败，需清晰报告错误，但继续执行剩余步骤
配套skill（find-skills、agent-browser、pdf-to-markdown）为硬编码，不读取任何配置文件

输出最终汇总报告：

✓ task backend (beans)
✓ memory backend — memory dirs ready
✓ companion: find-skills
✓ companion: agent-browser
✓ companion: pdf-to-markdown
✓ hooks: .groove/hooks/ ready
✓ AGENTS.md updated (groove:prime, groove:task)