verk

在 Verk（人工智能驱动的任务管理）中管理任务、项目和工作流程。创建、更新、分配和跟踪任务。添加评论、更改状态、列出自动化流程。

# Verk Task Management

You can manage tasks, projects, and automation flows in Verk using the `verk-cli.mjs` CLI tool.

## Available Commands

### Tasks

- **List tasks**: `node scripts/verk-cli.mjs tasks list [--status STATUS] [--priority PRIORITY] [--search QUERY]`
- **Get task**: `node scripts/verk-cli.mjs tasks get <taskId>`
- **Create task**: `node scripts/verk-cli.mjs tasks create --title "Title" [--description "Desc"] [--status STATUS] [--priority PRIORITY] [--assigned userId1,userId2]`
- **Update task**: `node scripts/verk-cli.mjs tasks update <taskId> [--title "New Title"] [--status STATUS] [--priority PRIORITY] [--assigned userId1,userId2]`
- **Delete task**: `node scripts/verk-cli.mjs tasks delete <taskId>`
- **Comment on task**: `node scripts/verk-cli.mjs tasks comment <taskId> --text "Comment text"`

### Projects

- **List projects**: `node scripts/verk-cli.mjs projects list`

### Flows (Automation Workflows)

- **List flows**: `node scripts/verk-cli.mjs flows list`

## Valid Values

- **Status**: `Backlog`, `Todo`, `In-Progress`, `Review`, `Done`
- **Priority**: `Urgent`, `High`, `Medium`, `Low`, `None`

## When to Use Each Command

- When asked to see what tasks exist, use `tasks list`. Add `--status` or `--priority` to filter, or `--search` to find specific tasks.
- When asked about a specific task, use `tasks get <taskId>`.
- When asked to create a task, use `tasks create` with at least a `--title`.
- When asked to update, change, or modify a task, use `tasks update <taskId>` with the fields to change.
- When asked to mark a task as done/complete, use `tasks update <taskId> --status Done`.
- When asked to assign a task, use `tasks update <taskId> --assigned userId`.
- When asked to delete or remove a task, use `tasks delete <taskId>`.
- When asked to comment on or add a note to a task, use `tasks comment <taskId> --text "..."`.
- When asked about projects, use `projects list`.
- When asked about automation workflows, use `flows list`.
- To see comments on a task, use `tasks get <taskId>` — comments are included in the task response.

## Output Format

All commands return JSON. Parse the output to extract relevant information for the user. When listing tasks, summarize key fields (title, status, priority, assignee) rather than dumping raw JSON.

## Examples

```bash
# List all high-priority tasks
node scripts/verk-cli.mjs tasks list --priority High

# Create a task and assign it
node scripts/verk-cli.mjs tasks create --title "Review Q2 roadmap" --priority High --status Todo

# Mark a task as done
node scripts/verk-cli.mjs tasks update task-abc123 --status Done

# Add a comment
node scripts/verk-cli.mjs tasks comment task-abc123 --text "Completed the review, looks good"
```

---

## 中文说明

# Verk 任务管理

你可以使用 `verk-cli.mjs` CLI 工具在 Verk 中管理任务、项目和自动化流程。

## 可用命令

### 任务

- **列出任务**：`node scripts/verk-cli.mjs tasks list [--status STATUS] [--priority PRIORITY] [--search QUERY]`
- **获取任务**：`node scripts/verk-cli.mjs tasks get <taskId>`
- **创建任务**：`node scripts/verk-cli.mjs tasks create --title "Title" [--description "Desc"] [--status STATUS] [--priority PRIORITY] [--assigned userId1,userId2]`
- **更新任务**：`node scripts/verk-cli.mjs tasks update <taskId> [--title "New Title"] [--status STATUS] [--priority PRIORITY] [--assigned userId1,userId2]`
- **删除任务**：`node scripts/verk-cli.mjs tasks delete <taskId>`
- **评论任务**：`node scripts/verk-cli.mjs tasks comment <taskId> --text "Comment text"`

### 项目

- **列出项目**：`node scripts/verk-cli.mjs projects list`

### 流程（自动化工作流）

- **列出流程**：`node scripts/verk-cli.mjs flows list`

## 有效取值

- **Status**：`Backlog`、`Todo`、`In-Progress`、`Review`、`Done`
- **Priority**：`Urgent`、`High`、`Medium`、`Low`、`None`

## 何时使用每个命令

- 当被要求查看存在哪些任务时，使用 `tasks list`。添加 `--status` 或 `--priority` 来筛选，或用 `--search` 查找特定任务。
- 当被问及某个特定任务时，使用 `tasks get <taskId>`。
- 当被要求创建任务时，使用 `tasks create`，至少带 `--title`。
- 当被要求更新、变更或修改任务时，使用 `tasks update <taskId>` 并带上要更改的字段。
- 当被要求将任务标记为完成时，使用 `tasks update <taskId> --status Done`。
- 当被要求分配任务时，使用 `tasks update <taskId> --assigned userId`。
- 当被要求删除或移除任务时，使用 `tasks delete <taskId>`。
- 当被要求对任务发表评论或添加备注时，使用 `tasks comment <taskId> --text "..."`。
- 当被问及项目时，使用 `projects list`。
- 当被问及自动化工作流时，使用 `flows list`。
- 要查看任务上的评论，使用 `tasks get <taskId>` —— 评论已包含在任务响应中。

## 输出格式

所有命令返回 JSON。解析输出以为用户提取相关信息。列出任务时，总结关键字段（标题、状态、优先级、负责人），而不是直接倾倒原始 JSON。

## 示例

```bash
# List all high-priority tasks
node scripts/verk-cli.mjs tasks list --priority High

# Create a task and assign it
node scripts/verk-cli.mjs tasks create --title "Review Q2 roadmap" --priority High --status Todo

# Mark a task as done
node scripts/verk-cli.mjs tasks update task-abc123 --status Done

# Add a comment
node scripts/verk-cli.mjs tasks comment task-abc123 --text "Completed the review, looks good"
```