创建 TAPD 需求
tapd_create_storyCreate a confirmed TAPD requirement with assignee, priority, iteration, custom fields, and more. Requires explicit user confirmation before submission.
Instructions
在 TAPD 中创建一个已确认的新需求,支持设置处理人、优先级、迭代、父需求、标签、排期、工时、自定义字段等。创建前建议先用 tapd_search_users 确认处理人的 nick;不传处理人则默认指派给当前登录用户。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | 可选,抄送人。与处理人同为 TAPD 用户 nick,参考 owner 格式,多个以分号分隔(如 a;b;) | |
| due | No | 可选,预计结束日期(YYYY-MM-DD) | |
| name | Yes | 需求名称 | |
| size | No | 可选,规模 | |
| type | No | 可选,类型 | |
| begin | No | 可选,预计开始日期(YYYY-MM-DD) | |
| label | No | 可选,标签,不存在时自动创建,多个以英文竖线(|)分隔 | |
| effort | No | 可选,预估工时 | |
| exceed | No | 可选,超出工时 | |
| module | No | 可选,所属模块 | |
| owners | No | 可选,需求处理人 TAPD nick 列表;建议先调用 tapd_search_users 确认 | |
| remain | No | 可选,剩余工时 | |
| source | No | 可选,来源 | |
| feature | No | 可选,特性 | |
| version | No | 可选,版本 | |
| confirmed | Yes | 必须为 true,表示用户已明确确认创建该 TAPD 需求 | |
| developer | No | 可选,开发人员。与处理人同为 TAPD 用户 nick,参考 owner 格式,多个以分号分隔(如 a;b;) | |
| parent_id | No | 可选,父需求 ID,用于创建子需求 | |
| tech_risk | No | 可选,技术风险 | |
| release_id | No | 可选,发布计划 ID | |
| test_focus | No | 可选,测试重点 | |
| category_id | No | 可选,分类 ID | |
| description | Yes | 需求详细描述,支持 TAPD 富文本 HTML | |
| iteration_id | No | 可选,迭代 ID | |
| templated_id | No | 可选,模板 ID。从需求模板创建时使用 | |
| workspace_id | Yes | TAPD 项目 ID(必填)。可先用 tapd_list_bugs / tapd_list_stories 跨项目查询,或 tapd_list_workspaces 获取目标项目 ID | |
| custom_fields | No | 可选,自定义字段透传。key 为 TAPD 字段名(custom_field_*、cus_* 或 custom_plan_field_*),原样提交;具体字段名通过 TAPD 自定义字段配置接口获取 | |
| apply_template | No | 可选,模板选项,多个以英文逗号分隔(如 preset_stories,preset_tasks,分别预设子需求/子任务),需配合 templated_id | |
| business_value | No | 可选,业务价值 | |
| priority_label | No | 可选,优先级标识,推荐使用此字段以兼容自定义优先级(如 High/Medium/Low) | |
| effort_completed | No | 可选,完成工时 | |
| workitem_type_id | No | 可选,需求类别 ID | |
| is_apply_template_default_value | No | 可选,是否从模板继承默认值/保密设置(仅 0/1,1 继承),需配合 templated_id |