list_child_tasks
Retrieve child tasks for a given parent work item ID. Specify a relation name when multiple sub-task rules exist to get the correct task list.
Instructions
列出指定父工作项下的子任务(通过“空间关联关系”规则实现)。
背景说明:
- 飞书项目中的“父子/子任务”通常不是一个固定字段,而是通过“关联关系规则(Relation Rule)”实现。
- 同一个项目空间可能存在多条关联规则(例如:"子任务"、"关联"、"阻塞")。
因此本工具支持 relation_name 参数用于选择具体规则。
本工具的行为:
1) 解析 project / work_item_type 参数(支持 project_name 与 project_key 两种输入)。
2) 通过 HierarchyProvider 选择关联规则:
- 若 relation_name 传入:按名称精确匹配。
- 若未传:若规则只有 1 条则自动选择;若 >1 条则报错提示需要指定。
3) 调用 RelationAPI.work_item_list 获取关联的 work_item_ids。
注意:
- 成功时返回 JSON 字符串(success=true)。
- 失败时返回纯文本错误信息(由 with_error_handling 统一处理),不会返回 JSON。
Args:
parent_issue_id: 父工作项 ID(必填)。
relation_name: 关联规则名称(可选)。规则多于 1 条时建议必填。
page_num: 页码,从 1 开始(默认 1)。
page_size: 每页数量(默认 20)。
project: 项目标识符(可选)。可以是项目名称或 project_key;不传则使用环境变量 FEISHU_PROJECT_KEY 指定的默认项目。
work_item_type: 工作项类型名称(可选)。例如:"问题管理"、"Issue管理"。
user_key: (可选) 飞书用户标识符 (X-USER-KEY)。
Returns:
JSON 字符串。
成功时(success=true)data 格式:
{
"work_item_ids": [int, ...]
}
Examples:
# 获取父任务 123 的子任务列表(自动选择唯一规则)
list_child_tasks(parent_issue_id=123)
# 指定关联规则名称
list_child_tasks(parent_issue_id=123, relation_name="子任务")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project | No | ||
| page_num | No | ||
| user_key | No | ||
| page_size | No | ||
| relation_name | No | ||
| work_item_type | No | ||
| parent_issue_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |