更新 TAPD 需求
tapd_writeback_storyWrite back updates to TAPD story requirements including comments, description, status, assignee, standard and custom fields. Each action is independent and combinable.
Instructions
对 TAPD 需求执行一个或多个已确认操作：回填评论、更新描述正文、更新状态、更新处理人，以及更新标题、优先级、迭代、版本、工时、标签等标准字段和自定义字段。各功能相互独立且可自由组合，至少提供 comment、description、target_status、target_owners、标准字段或 custom_fields 之一。注意：各动作分多次请求提交、非事务，可能出现部分成功（结果会逐项标明成功/失败）。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | 可选，抄送人。与处理人同为 TAPD 用户 nick，参考 owner 格式，多个以分号分隔（如 a;b;） | |
| due | No | 可选，预计结束日期（YYYY-MM-DD） | |
| name | No | 可选，更新需求标题 | |
| size | No | 可选，规模 | |
| type | No | 可选，类型 | |
| begin | No | 可选，预计开始日期（YYYY-MM-DD） | |
| label | No | 可选，标签，不存在时自动创建，多个以英文竖线（|）分隔 | |
| effort | No | 可选，预估工时 | |
| exceed | No | 可选，超出工时 | |
| module | No | 可选，模块 | |
| remain | No | 可选，剩余工时 | |
| source | No | 可选，来源 | |
| comment | No | 可选，回填到 TAPD 需求的评论内容 | |
| version | No | 可选，版本 | |
| story_id | Yes | TAPD 需求 ID | |
| confirmed | Yes | 必须为 true，表示用户已明确确认本次评论、描述、字段、状态变更和处理人变更 | |
| developer | No | 可选，开发人员。与处理人同为 TAPD 用户 nick，参考 owner 格式，多个以分号分隔（如 a;b;） | |
| release_id | No | 可选，发布计划 ID | |
| test_focus | No | 可选，测试重点 | |
| category_id | No | 可选，需求分类 ID | |
| description | No | 可选，更新需求描述正文（支持 HTML 富文本）。注意：该字段会整体覆盖原描述，应先获取原描述并在其基础上修改后传入完整正文 | |
| iteration_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 自定义字段配置接口获取 | |
| target_owners | No | 可选，将需求处理人更新为指定 TAPD 用户 nick 列表；应先调用 tapd_search_users 确认 | |
| target_status | No | 可选，将需求状态更新为 TAPD 工作流中的状态值；必须使用当前项目实际支持的状态枚举。写入前会校验是否为项目工作流合法状态，非法状态将被拒绝并返回可选状态清单 | |
| business_value | No | 可选，业务价值 | |
| priority_label | No | 可选，优先级（对应 TAPD priority_label，兼容自定义优先级） | |
| comment_root_id | No | 可选，评论的根评论 ID。传入时本条评论挂到该评论树下；需同时提供 comment | |
| comment_reply_id | No | 可选，被回复的评论 ID，表示本条评论是对它的回复；需同时提供 comment | |
| effort_completed | No | 可选，完成工时 | |
| owner_update_mode | No | 可选，处理人更新方式。用户说“添加、加上、补上、也给”等追加语义时传 append；用户说“改为、替换为、转给、只保留”等替换语义时传 replace；不传默认 append | |
| is_auto_close_task | No | 可选，流转到结束状态时是否自动关闭关联任务（仅 0/1，1 关闭，默认 0）。仅在本次同时变更状态时生效，需与 target_status 一起提交 |