task

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

task

Backend-agnostic task management skill for groove. Reads backend config from

.groove/index.md

and routes all commands to the appropriate CLI or API.

适用于groove的与后端无关的任务管理Skill。从

.groove/index.md

读取后端配置，并将所有命令路由到对应的CLI或API。

Git Root Detection

Git根目录检测

Before running any command, detect the git root:

bash

git rev-parse --show-toplevel

All file paths (

.groove/index.md

.beans.yml

) are relative to git root.

在执行任何命令之前，先检测Git根目录：

bash

git rev-parse --show-toplevel

所有文件路径（

.groove/index.md

、

.beans.yml

）均相对于Git根目录。

Commands

命令

Command	Description
`list`	Show active, ready tasks from configured backend
`create`	Create task with title, type, parent, status
`update`	Update task status, body, or metadata
`archive`	Archive all completed/scrapped tasks (user confirms)
`analyse`	Summarise tasks by status for closeout/daily memory
`install`	Install configured task backend
`config`	Show or update task backend configuration

命令	描述
`list`	显示已配置后端中的活跃、待处理任务
`create`	创建包含标题、类型、父任务、状态的任务
`update`	更新任务状态、内容或元数据
`archive`	归档所有已完成/废弃的任务（需用户确认）
`analyse`	按状态汇总任务，用于收尾工作/每日记录
`install`	安装已配置的任务后端
`config`	查看或更新任务后端配置

$ARGUMENTS Routing

$ARGUMENTS 路由

$ARGUMENTS	Action
`help`	→ `commands/help.md`
`doctor`	→ `commands/doctor.md`
`list`	→ `commands/list.md`
`create`	→ `commands/create.md`
`update`	→ `commands/update.md`
`archive`	→ `commands/archive.md`
`analyse`	→ `commands/analyse.md`
`install`	→ `commands/install.md`
`config`	→ `commands/config.md`
(empty)	→ `commands/help.md`

$ARGUMENTS 参数	操作
`help`	→ 跳转至 `commands/help.md`
`doctor`	→ 跳转至 `commands/doctor.md`
`list`	→ 跳转至 `commands/list.md`
`create`	→ 跳转至 `commands/create.md`
`update`	→ 跳转至 `commands/update.md`
`archive`	→ 跳转至 `commands/archive.md`
`analyse`	→ 跳转至 `commands/analyse.md`
`install`	→ 跳转至 `commands/install.md`
`config`	→ 跳转至 `commands/config.md`
(空值)	→ 跳转至 `commands/help.md`

Bootstrap

初始化引导

.groove/index.md

does not exist at git root, create it from the template at

templates/groove-config.md

before proceeding. Ask user to confirm the defaults or provide overrides.

如果Git根目录下不存在

.groove/index.md

，则从

templates/groove-config.md

的模板创建该文件后再继续操作。请用户确认默认配置或提供自定义配置。

File Structure

文件结构

.groove/
└── index.md          # shared groove config (frontmatter: tasks, sessions, finder, memory, git)
.beans.yml            # beans CLI config (at git root, owned by beans)
skills/task/
├── SKILL.md
├── commands/
│   ├── list.md
│   ├── create.md
│   ├── update.md
│   ├── archive.md
│   ├── analyse.md
│   ├── install.md
│   └── config.md
├── references/
│   └── backends.md
└── templates/
    ├── beans-config.md
    └── groove-config.md

.groove/
└── index.md          # 共享groove配置文件（前置内容：tasks、sessions、finder、memory、git）
.beans.yml            # beans CLI配置文件（位于Git根目录，归beans所有）
skills/task/
├── SKILL.md
├── commands/
│   ├── list.md
│   ├── create.md
│   ├── update.md
│   ├── archive.md
│   ├── analyse.md
│   ├── install.md
│   └── config.md
├── references/
│   └── backends.md
└── templates/
    ├── beans-config.md
    └── groove-config.md