get_tasks
Retrieve work items from Feishu projects using filters for name keyword, status, priority, owner, or related item. Get complete lists or targeted results to support project tracking.
Instructions
获取项目中的工作项列表（支持全量获取或按条件过滤）。
这是通用的任务获取工具，具备以下特性：
1. 无过滤参数时，返回项目的全部工作项
2. 支持按任务名称关键词进行高效搜索（推荐）
3. 支持按状态、优先级、负责人进行灵活过滤
4. 支持按关联工作项 ID 或名称过滤（查找与指定工作项关联的项）
5. 如果项目不存在某个字段（如状态），会自动跳过该过滤条件
6. 支持指定工作项类型（如 "需求管理"、"Issue管理"、"项目管理" 等）
Args:
project: 项目标识符（可选）。可以是:
- 项目名称（如 "Project Management"）
- project_key（如 "project_xxx"）
如不指定，则使用环境变量 FEISHU_PROJECT_KEY 配置的默认项目。
work_item_type: 工作项类型名称（可选），如 "需求管理"、"Issue管理"、"项目管理" 等。
如果不指定，默认使用 "问题管理" 类型。
name_keyword: 任务名称关键词（可选，支持模糊搜索，推荐使用）。
例如："SG06VA" 可以搜索所有包含该关键词的任务。
status: 状态过滤（多个用逗号分隔），如 "待处理,进行中"（可选）。
priority: 优先级过滤（多个用逗号分隔），如 "P0,P1"（可选）。
owner: 负责人过滤（姓名或邮箱）（可选）。
related_to: 关联工作项 ID 或名称（可选）。用于查找与指定工作项关联的其他工作项。
- 如果是整数或数字字符串，直接作为工作项 ID 使用
- 如果是非数字字符串，自动搜索该名称对应的工作项（精确匹配优先）
例如：related_to="SG06VA1" 或 related_to=6288163810
page_num: 页码，从 1 开始（默认 1）。
page_size: 每页数量（默认 50，最大 100）。
user_key: (可选) 飞书用户标识符 (X-USER-KEY)，用于以特定用户身份进行操作。
Returns:
JSON 格式的工作项列表，包含 id, name, status, priority, owner。
失败时返回错误信息。
Examples:
# 获取默认项目的全部工作项
get_tasks()
# 获取"需求管理"类型的工作项
get_tasks(project="Project Management", work_item_type="需求管理")
# 按名称关键词搜索（推荐，高效）
get_tasks(name_keyword="SG06VA")
# 获取指定优先级的任务
get_tasks(priority="P0,P1")
# 查找与指定工作项关联的工作项（通过名称）
get_tasks(related_to="SG06VA1", work_item_type="Issue管理")
# 查找与指定工作项关联的工作项（通过 ID）
get_tasks(
project="Project Management",
work_item_type="需求管理",
related_to=6181818812
)
# 指定项目并组合多个条件过滤
get_tasks(
project="Project Management",
work_item_type="需求管理",
name_keyword="SG06VA",
status="进行中",
priority="P0"
)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| owner | No | ||
| status | No | ||
| project | No | ||
| page_num | No | ||
| priority | No | ||
| user_key | No | ||
| page_size | No | ||
| related_to | No | ||
| name_keyword | No | ||
| work_item_type | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |