飞书任务操作技能

Feishu Task Operation Skill

管理飞书任务，包括创建、查看、更新、删除和完成任务。

Manage Feishu tasks, including creating, viewing, updating, deleting, and completing tasks.

使用方法

Usage

bash

/feishu-task create --summary "任务标题"       # 创建任务
/feishu-task list                              # 列出任务
/feishu-task list --completed                  # 列出已完成任务
/feishu-task get <task_id>                     # 获取任务详情
/feishu-task update <task_id> --summary "新标题"  # 更新任务
/feishu-task complete <task_id>                # 完成任务
/feishu-task delete <task_id>                  # 删除任务

bash

/feishu-task create --summary "任务标题"       # 创建任务
/feishu-task list                              # 列出任务
/feishu-task list --completed                  # 列出已完成任务
/feishu-task get <task_id>                     # 获取任务详情
/feishu-task update <task_id> --summary "新标题"  # 更新任务
/feishu-task complete <task_id>                # 完成任务
/feishu-task delete <task_id>                  # 删除任务

CLI 命令详解

Detailed CLI Command Explanations

1. 创建任务

1. Create Task

bash

undefined

bash

undefined

创建简单任务

feishu-cli task create --summary "完成项目文档"

创建带描述的任务

feishu-cli task create --summary "代码审查" --description "审查 PR #123"

创建带截止时间的任务

feishu-cli task create --summary "提交报告" --due "2024-12-31 18:00:00"

创建带来源链接的任务

feishu-cli task create --summary "处理 Issue"
--origin-href "https://github.com/example/repo/issues/1"

JSON 格式输出

feishu-cli task create --summary "测试任务" --output json


**参数说明**：
| 参数 | 简写 | 说明 | 必填 |
|------|------|------|------|
| `--summary` | `-s` | 任务标题 | 是 |
| `--description` | `-d` | 任务描述 | 否 |
| `--due` | | 截止时间 | 否 |
| `--origin-href` | | 任务来源链接 | 否 |
| `--origin-platform` | | 任务来源平台名称 | 否（默认 `feishu-cli`） |
| `--output` | `-o` | 输出格式（json） | 否 |

**截止时间格式**：
- `2024-12-31 18:00:00` - 完整格式
- `2024-12-31` - 仅日期

feishu-cli task create --summary "测试任务" --output json


**Parameter Explanations**:
| Parameter | Shortcut | Description | Required |
|------|------|------|------|
| `--summary` | `-s` | Task title | Yes |
| `--description` | `-d` | Task description | No |
| `--due` | | Due date | No |
| `--origin-href` | | Task origin link | No |
| `--origin-platform` | | Task origin platform name | No (default `feishu-cli`) |
| `--output` | `-o` | Output format (json) | No |

**Due Date Format**:
- `2024-12-31 18:00:00` - Full format
- `2024-12-31` - Date only

2. 列出任务

2. List Tasks

bash

undefined

bash

undefined

列出所有任务

feishu-cli task list

列出已完成的任务

feishu-cli task list --completed

列出未完成的任务

feishu-cli task list --uncompleted

分页查询

feishu-cli task list --page-size 10

JSON 格式输出

feishu-cli task list --output json


**参数说明**：
| 参数 | 说明 | 默认值 |
|------|------|--------|
| `--completed` | 只显示已完成任务 | false |
| `--uncompleted` | 只显示未完成任务 | false |
| `--page-size` | 每页数量 | 50 |
| `--page-token` | 分页标记 | 无 |
| `--output, -o` | 输出格式 | 文本 |

feishu-cli task list --output json


**Parameter Explanations**:
| Parameter | Description | Default Value |
|------|------|--------|
| `--completed` | Only show completed tasks | false |
| `--uncompleted` | Only show uncompleted tasks | false |
| `--page-size` | Number of items per page | 50 |
| `--page-token` | Pagination token | None |
| `--output, -o` | Output format | Text |

3. 获取任务详情

3. Get Task Details

bash

feishu-cli task get <task_id>

bash

feishu-cli task get <task_id>

JSON 格式输出

feishu-cli task get <task_id> --output json


**输出示例**：

任务详情: ID: e297ddff-06ca-4166-b917-4ce57cd3a7a0 标题: 完成项目文档描述: 编写 Q1 项目技术文档状态: 未完成截止时间: 2024-12-31 18:00:00 创建时间: 2024-01-15 10:30:00

undefined

feishu-cli task get <task_id> --output json


**Output Example**:

任务详情: ID: e297ddff-06ca-4166-b917-4ce57cd3a7a0 标题: 完成项目文档描述: 编写 Q1 项目技术文档状态: 未完成截止时间: 2024-12-31 18:00:00 创建时间: 2024-01-15 10:30:00

undefined

4. 更新任务

4. Update Task

bash

undefined

bash

undefined

更新任务标题

feishu-cli task update <task_id> --summary "新标题"

更新任务描述

feishu-cli task update <task_id> --description "新描述"

更新截止时间

feishu-cli task update <task_id> --due "2024-12-31 18:00:00"

通过 update 标记任务为已完成

feishu-cli task update <task_id> --completed

JSON 格式输出

feishu-cli task update <task_id> --summary "新标题" --output json


**参数说明**：
| 参数 | 简写 | 说明 |
|------|------|------|
| `--summary` | `-s` | 新的任务标题 |
| `--description` | `-d` | 新的任务描述 |
| `--due` | | 新的截止时间 |
| `--completed` | | 标记任务为已完成 |
| `--output` | `-o` | 输出格式（json） |

feishu-cli task update <task_id> --summary "新标题" --output json


**Parameter Explanations**:
| Parameter | Shortcut | Description |
|------|------|------|
| `--summary` | `-s` | New task title |
| `--description` | `-d` | New task description |
| `--due` | | New due date |
| `--completed` | | Mark task as completed |
| `--output` | `-o` | Output format (json) |

5. 完成任务

5. Complete Task

bash

feishu-cli task complete <task_id>

bash

feishu-cli task complete <task_id>

6. 删除任务

6. Delete Task

bash

feishu-cli task delete <task_id>

bash

feishu-cli task delete <task_id>

任务状态说明

Task Status Explanations

状态	说明
未完成	任务创建后的默认状态
已完成	通过 `complete` 或 `update --completed` 标记

Status	Description
Uncompleted	Default status after task creation
Completed	Marked via `complete` or `update --completed`

典型工作流

Typical Workflows

创建并管理任务

Create and Manage Tasks

bash

undefined

bash

undefined

1. 创建任务

feishu-cli task create --summary "完成代码审查"
--description "审查 feature/new-api 分支"
--due "2024-01-25 18:00:00"

2. 查看任务列表

feishu-cli task list --uncompleted

3. 完成任务

feishu-cli task complete <task_id>

undefined

feishu-cli task complete <task_id>

undefined

从 GitHub Issue 创建任务

Create Task from GitHub Issue

bash

feishu-cli task create \
  --summary "修复登录 Bug #42" \
  --description "用户反馈登录偶尔失败" \
  --origin-href "https://github.com/company/repo/issues/42" \
  --due "2024-01-20"

bash

feishu-cli task create \
  --summary "修复登录 Bug #42" \
  --description "用户反馈登录偶尔失败" \
  --origin-href "https://github.com/company/repo/issues/42" \
  --due "2024-01-20"

批量查看任务状态

Batch View Task Statuses

bash

undefined

bash

undefined

查看所有未完成任务

feishu-cli task list --uncompleted

查看已完成任务

feishu-cli task list --completed

导出为 JSON 便于处理

feishu-cli task list --output json

undefined

feishu-cli task list --output json

undefined

更新任务并完成

Update Task and Complete

bash

undefined

bash

undefined

1. 更新任务描述

feishu-cli task update <task_id> --description "已完成 80%，待最终测试"

2. 修改截止时间

feishu-cli task update <task_id> --due "2024-01-22 12:00:00"

3. 完成任务

feishu-cli task complete <task_id>

undefined

feishu-cli task complete <task_id>

undefined

注意事项

Notes

任务 ID：UUID 格式，如
```
e297ddff-06ca-4166-b917-4ce57cd3a7a0
```
截止时间：支持
```
YYYY-MM-DD HH:mm:ss
```
或
```
YYYY-MM-DD
```
格式
来源链接：可关联外部系统（如 GitHub、Jira）的链接
权限要求：需要应用具有任务相关权限

Task ID: UUID format, e.g.,
```
e297ddff-06ca-4166-b917-4ce57cd3a7a0
```
Due Date: Supports
```
YYYY-MM-DD HH:mm:ss
```
or
```
YYYY-MM-DD
```
format
Origin Link: Can link to external systems (e.g., GitHub, Jira)
Permission Requirements: The application needs to have task-related permissions

权限要求（重要）

Permission Requirements (Important)

⚠️ 任务功能需要在飞书开放平台为应用开通以下权限：

```
task:task:read
```
- 任务读取权限（用于 list/get）
```
task:task:write
```
- 任务写入权限（用于 create/update/delete/complete）

申请链接：在飞书开放平台应用后台 → 权限管理 → 申请对应权限

⚠️ The task feature requires the application to activate the following permissions on the Feishu Open Platform:

```
task:task:read
```
- Task read permission (for list/get)
```
task:task:write
```
- Task write permission (for create/update/delete/complete)

Application Link: In the Feishu Open Platform Application Backend → Permission Management → Apply for corresponding permissions

已验证功能

Verified Features

以下命令已通过测试验证：

```
task create
```
✅ - 创建任务正常
```
task complete
```
✅ - 完成任务正常
```
task delete
```
✅ - 删除任务正常
```
task list
```
✅ - 列出任务正常（需
```
task:task:read
```
权限）
```
task get
```
✅ - 获取任务详情正常（需
```
task:task:read
```
权限）

The following commands have been tested and verified:

```
task create
```
✅ - Create task works normally
```
task complete
```
✅ - Complete task works normally
```
task delete
```
✅ - Delete task works normally
```
task list
```
✅ - List tasks works normally (requires
```
task:task:read
```
permission)
```
task get
```
✅ - Get task details works normally (requires
```
task:task:read
```
permission)

错误处理

Error Handling

错误	原因	解决
`Access denied`	权限不足	确认应用已开通 `task:task:read` 和 `task:task:write` 权限
`task not found`	任务不存在	检查 task_id 是否正确（UUID 格式）
`invalid parameter`	参数错误	检查 --due 时间格式、--summary 是否为空

Error	Cause	Solution
`Access denied`	Insufficient permissions	Confirm the application has activated `task:task:read` and `task:task:write` permissions
`task not found`	Task does not exist	Check if task_id is correct (UUID format)
`invalid parameter`	Invalid parameter	Check the --due date format, and whether --summary is empty

feishu-cli-task

Original

Translation

飞书任务操作技能

Feishu Task Operation Skill

使用方法

Usage

CLI 命令详解

Detailed CLI Command Explanations

1. 创建任务

1. Create Task

创建简单任务

创建简单任务

创建带描述的任务

创建带描述的任务

创建带截止时间的任务

创建带截止时间的任务

创建带来源链接的任务

创建带来源链接的任务

JSON 格式输出

JSON 格式输出

2. 列出任务

2. List Tasks

列出所有任务

列出所有任务

列出已完成的任务

列出已完成的任务

列出未完成的任务

列出未完成的任务

分页查询

分页查询

JSON 格式输出

JSON 格式输出

3. 获取任务详情

3. Get Task Details

JSON 格式输出

JSON 格式输出

4. 更新任务

4. Update Task

更新任务标题

更新任务标题

更新任务描述

更新任务描述

更新截止时间

更新截止时间

通过 update 标记任务为已完成

通过 update 标记任务为已完成

JSON 格式输出

JSON 格式输出

5. 完成任务

5. Complete Task

6. 删除任务

6. Delete Task

任务状态说明

Task Status Explanations

典型工作流

Typical Workflows

创建并管理任务

Create and Manage Tasks

1. 创建任务

1. 创建任务

2. 查看任务列表

2. 查看任务列表

3. 完成任务

3. 完成任务

从 GitHub Issue 创建任务

Create Task from GitHub Issue

批量查看任务状态

Batch View Task Statuses

查看所有未完成任务

查看所有未完成任务

查看已完成任务

查看已完成任务

导出为 JSON 便于处理

导出为 JSON 便于处理

更新任务并完成

Update Task and Complete

1. 更新任务描述

1. 更新任务描述

2. 修改截止时间