Back to Details

groove-utilities-task-install

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

groove-utilities-task-install

groove-utilities-task-install

Outcome

预期结果

The configured task backend is installed and verified reachable. User is informed of what was installed and how to use it.

已完成配置的任务后端安装完毕且验证可访问，向用户告知已安装的内容以及使用方法。

Acceptance Criteria

验收标准

Backend CLI is available in PATH after install
User is shown a confirmation with the installed version or a reachability check
No-op if
```
tasks: none
```

If

tasks: beans

:

AGENTS.md

contains a

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

stub pointing to

beans prime

安装完成后Backend CLI已加入PATH环境变量
向用户展示安装版本确认信息或可达性校验结果
如果配置为
```
tasks: none
```
则不执行任何操作

如果配置为

tasks: beans

：

AGENTS.md

需包含指向

beans prime

的

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

存根内容

Constraints

约束条件

Read
```
tasks:
```
from
```
.groove/index.md
```
to determine backend
If
```
tasks: none
```
, print friendly no-op message and exit
Backend install guidance:
- ```
beans
```
  : link to https://github.com/hmans/beans for install instructions; verify with
```
beans version
```
- ```
linear
```
  : link to https://linear.app/docs/cli for install instructions; verify with
```
linear --version
```
  or MCP availability
- ```
github
```
  : link to https://cli.github.com for install instructions; verify with
```
gh --version
```
After install, run a simple reachability check (e.g.,
```
beans version
```
or
```
gh auth status
```
)
If CLI is already installed, report current version and skip install
If
```
tasks: beans
```
and
```
.beans.yml
```
does not exist at git root:
- Derive
```
[PROJECT_PREFIX]
```
  from the git repo name (last path component of
```
git remote get-url origin
```
  , uppercased, non-alphanumeric stripped) — e.g.
```
groove
```
  →
```
GRV
```
- Scaffold
```
.beans.yml
```
  from
```
skills/groove-utilities-task-install/templates/beans-config.md
```
  with the derived prefix
- Create
```
.groove/tasks/
```
  directory if it does not exist
- Report the path written

If

tasks: beans

: write a minimal stub to

AGENTS.md

at git root:

Wrap in

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

/

<!-- groove:task:end -->

fenced section

Stub content:

Task backend: beans — use `/groove-utilities-task-*` skills for all task management.
Run `beans prime` to load the full beans CLI reference.

Replace section if it already exists; append if not; preserve all other
```
AGENTS.md
```
content
Report the path written

从
```
.groove/index.md
```
读取
```
tasks:
```
配置项来确定要安装的后端
如果
```
tasks: none
```
，打印友好的无操作提示信息后退出
后端安装指引：
- ```
beans
```
  ：跳转至https://github.com/hmans/beans 查看安装说明，使用
```
beans version
```
  验证安装
- ```
linear
```
  ：跳转至https://linear.app/docs/cli 查看安装说明，使用
```
linear --version
```
  或MCP可用性验证安装
- ```
github
```
  ：跳转至https://cli.github.com 查看安装说明，使用
```
gh --version
```
  验证安装
安装完成后，运行简单的可达性校验（例如
```
beans version
```
或
```
gh auth status
```
）
如果CLI已经安装，上报当前版本并跳过安装流程
如果
```
tasks: beans
```
且Git根目录下不存在
```
.beans.yml
```
：
- 从Git仓库名称推导
```
[PROJECT_PREFIX]
```
  （取
```
git remote get-url origin
```
  的最后一段路径，转为大写，剔除非字母数字字符），例如
```
groove
```
  →
```
GRV
```
- 使用推导得到的前缀从
```
skills/groove-utilities-task-install/templates/beans-config.md
```
  生成
```
.beans.yml
```
  脚手架
- 如果
```
.groove/tasks/
```
  目录不存在则创建该目录
- 上报写入的文件路径

如果

tasks: beans

：向Git根目录的

AGENTS.md

写入最小存根内容：

使用

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

/

<!-- groove:task:end -->

围栏包裹内容

存根内容：

Task backend: beans — use `/groove-utilities-task-*` skills for all task management.
Run `beans prime` to load the full beans CLI reference.

如果该片段已存在则替换，不存在则追加，保留
```
AGENTS.md
```
的所有其他内容
上报写入的文件路径