feishu-cli-task

Original：🇨🇳 Chinese
Translated

Task Management. Used when users request to create, view, complete or manage tasks. Supports operations such as create, view, update, delete and complete tasks.

30installs
Sourceriba2534/feishu-cli
Added on

NPX Install

npx skill4agent add riba2534/feishu-cli feishu-cli-task

Tags

Translated version includes tags in frontmatter
feishu-task-clitask-managementcli-toolfeishu-integrationtask-operations

SKILL.md Content (Chinese)

View Translation Comparison →

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>                  # 删除任务

Detailed CLI Command Explanations

1. Create Task

bash
# 创建简单任务
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
Parameter Explanations:
ParameterShortcutDescriptionRequired
--summary
-s
Task titleYes
--description
-d
Task descriptionNo
--due
Due dateNo
--origin-href
Task origin linkNo
--origin-platform
Task origin platform nameNo (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. List Tasks

bash
# 列出所有任务
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
Parameter Explanations:
ParameterDescriptionDefault Value
--completed
Only show completed tasksfalse
--uncompleted
Only show uncompleted tasksfalse
--page-size
Number of items per page50
--page-token
Pagination tokenNone
--output, -o
Output formatText

3. Get Task Details

bash
feishu-cli task get <task_id>

# JSON 格式输出
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

4. Update Task

bash
# 更新任务标题
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
Parameter Explanations:
ParameterShortcutDescription
--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. Complete Task

bash
feishu-cli task complete <task_id>

6. Delete Task

bash
feishu-cli task delete <task_id>

Task Status Explanations

StatusDescription
UncompletedDefault status after task creation
CompletedMarked via 
complete
or 
update --completed

Typical Workflows

Create and Manage Tasks

bash
# 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>

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"

Batch View Task Statuses

bash
# 查看所有未完成任务
feishu-cli task list --uncompleted

# 查看已完成任务
feishu-cli task list --completed

# 导出为 JSON 便于处理
feishu-cli task list --output json

Update Task and Complete

bash
# 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>

Notes

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

Permission Requirements (Important)

⚠️ 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

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

ErrorCauseSolution
Access denied
Insufficient permissionsConfirm the application has activated 
task:task:read
and 
task:task:write
permissions
task not found
Task does not existCheck if task_id is correct (UUID format)
invalid parameter
Invalid parameterCheck the --due date format, and whether --summary is empty