查询 TAPD 需求列表
tapd_list_storiesRead-only
Search TAPD requirements by owner, status, ID, workspace, and custom fields. Returns markdown table with workflow status names.
Instructions
查询 TAPD 需求列表，默认查询当前登录用户负责的需求；传入 owner 可查询指定处理人名下的需求。传入 id 精确查询时不限处理人，可查到已转给他人的需求。传入 workspace_id 时只查该项目；不传 workspace_id 时会聚合处理人参与的所有项目的需求。支持按字段过滤：需求 ID、名称、描述、状态、创建人、处理人、创建时间，以及优先级、标签、版本、模块、迭代、分类、排期/修改/完成时间、父子需求、特性、技术风险、需求类别、发布计划、规模、测试重点、抄送/开发人、来源/类型、工时、自定义字段等，并可自定义排序（order）。返回的状态会附带项目工作流中文名（如「已实现（resolved）」）。【展示约定】向用户呈现结果时，请直接原样输出本工具返回的 Markdown 表格，完整保留「序号」「id」在内的所有列（其中「需求」列已是内嵌超链接的 Markdown 写法，请勿拆成裸 URL、改成纯文本或删除链接），不要裁剪列、改列名或将表格拆分重排；如需补充分类或小结，可在表格之外另起段落，但表格本身保持原样。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | 可选，抄送人 TAPD nick | |
| id | No | 需求 ID，TAPD 支持多 ID 查询。传入 id 时默认跳过处理人过滤（除非同时显式传入 owner），以便查到已转出的需求 | |
| due | No | 可选，预计结束时间，TAPD 支持时间查询 | |
| name | No | 需求名称，TAPD 支持模糊匹配 | |
| page | No | 页码，默认 1。聚合查询（不传 workspace_id）时按每个项目分别分页，并非跨项目全局分页 | |
| size | No | 可选，规模 | |
| type | No | 可选，类型 | |
| begin | No | 可选，预计开始时间，TAPD 支持时间查询 | |
| label | No | 可选，标签，TAPD 支持枚举查询 | |
| limit | No | 返回数量上限，默认 30，最大 200；聚合查询时为每个项目的上限 | |
| order | No | 可选，排序规则，格式「字段名 asc|desc」（如 created desc），不传默认 modified desc。注意：聚合查询（不传 workspace_id）时各项目内按此排序取数，但跨项目合并后最终仍按修改时间倒序展示 | |
| owner | No | 单个处理人 TAPD nick，不传默认查询当前登录用户负责的需求；传入则查询指定处理人名下的需求，建议先用 tapd_search_users 确认 nick | |
| effort | No | 可选，预估工时 | |
| exceed | No | 可选，超出工时 | |
| module | No | 可选，模块 | |
| remain | No | 可选，剩余工时 | |
| source | No | 可选，来源 | |
| status | No | 需求状态，TAPD 支持枚举查询和不等于查询 | |
| created | No | 创建时间，TAPD 支持时间查询 | |
| creator | No | 创建人，TAPD 支持多用户查询 | |
| feature | No | 可选，特性 | |
| version | No | 可选，版本 | |
| modified | No | 可选，最后修改时间，TAPD 支持时间查询 | |
| v_status | No | 可选，状态，支持传入中文状态名（如「已实现」） | |
| completed | No | 可选，完成时间，TAPD 支持时间查询 | |
| developer | No | 可选，开发人员 TAPD nick | |
| parent_id | No | 可选，父需求 ID，查询其直接子需求 | |
| tech_risk | No | 可选，技术风险 | |
| release_id | No | 可选，发布计划 ID | |
| test_focus | No | 可选，测试重点 | |
| ancestor_id | No | 可选，祖先需求 ID，查询其下所有层级子需求 | |
| category_id | No | 可选，需求分类 ID，TAPD 支持枚举查询 | |
| children_id | No | 可选，子需求 ID；查询无子需求的需求时传「|」 | |
| description | No | 需求详细描述，TAPD 支持模糊匹配 | |
| iteration_id | No | 可选，迭代 ID，TAPD 支持枚举/不等于查询 | |
| workspace_id | No | TAPD 项目 ID。传入则只查该项目；不传则聚合处理人参与的所有项目的需求。可先用 tapd_list_workspaces 查看会覆盖哪些项目 | |
| custom_fields | No | 可选，自定义字段过滤透传。key 为 TAPD 字段名（custom_field_*、cus_* 或 custom_plan_field_*），原样提交；具体字段名通过 TAPD 自定义字段配置接口获取 | |
| priority_label | No | 可选，优先级（推荐字段，兼容自定义优先级），TAPD 支持枚举查询 | |
| effort_completed | No | 可选，完成工时 | |
| workitem_type_id | No | 可选，需求类别 ID | |
| include_leaf_stories | No | 可选，是否包含子需求，默认否 | |
| include_sub_category | No | 可选，是否包含子分类，默认否 | |
| include_sub_iteration | No | 可选，是否包含子迭代，默认否 |