飞书任务操作技能

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

使用方法

/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 命令详解

1. 创建任务

创建简单任务

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

• 仅日期

2. 列出任务

列出所有任务

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

输出格式 文本

3. 获取任务详情

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

4. 更新任务

更新任务标题

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）

5. 完成任务

feishu-cli task complete <task_id>

6. 删除任务

feishu-cli task delete <task_id>

任务状态说明

状态 说明

未完成 任务创建后的默认状态

已完成 通过 complete 或 update --completed 标记

典型工作流

创建并管理任务

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>

从 GitHub Issue 创建任务

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

批量查看任务状态

查看所有未完成任务

feishu-cli task list --uncompleted

查看已完成任务

feishu-cli task list --completed

导出为 JSON 便于处理

feishu-cli task list --output json

更新任务并完成

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>

注意事项

• 任务 ID：UUID 格式，如 e297ddff-06ca-4166-b917-4ce57cd3a7a0

• 截止时间：支持 YYYY-MM-DD HH:mm:ss 或 YYYY-MM-DD 格式

• 来源链接：可关联外部系统（如 GitHub、Jira）的链接

• 权限要求：需要应用具有任务相关权限

权限要求（重要）

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

• task:task:read

• 任务读取权限（用于 list/get）

• task:task:write

• 任务写入权限（用于 create/update/delete/complete）

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

已验证功能

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

• task create ✅ - 创建任务正常

• task complete ✅ - 完成任务正常

• task delete ✅ - 删除任务正常

• task list ✅ - 列出任务正常（需 task:task:read 权限）

• task get ✅ - 获取任务详情正常（需 task:task:read 权限）

错误处理

错误 原因 解决

Access denied

权限不足 确认应用已开通 task:task:read 和 task:task:write 权限

task not found

任务不存在 检查 task_id 是否正确（UUID 格式）

invalid parameter

参数错误 检查 --due 时间格式、--summary 是否为空