# 飞书 Base V2 提单契约

目标 Base 与表单由组织配置固定；脚本每次提交前读取真实表单详情，校验字段类型、必填配置和选项，不在 Skill 文档中复制一套可漂移的字段定义。

允许提交的 JSON：

| JSON 属性 | Base 字段 | 要求 |
| --- | --- | --- |
| `type` | 类型 | 必填；`需求` / `Bug` |
| `title` | 标题 | 必填非空文本 |
| `background` / `problem_or_goal` | 需求背景与目标 | 必填非空文本 |
| `expected_result` / `expected_outcome` | 期望结果 | 必填非空文本 |
| `acceptance_criteria` | 验收标准 | 可选字符串数组，仅作为验收提示 |
| `priority` | 优先级 | 可选；`P0` / `P1` / `P2` / `P3`，默认 `P2` |
| `environment` | 发生环境 | Bug 可选 |
| `reproduction_steps` | 复现步骤 | Bug 可选字符串数组 |
| `actual_result` | 实际结果 | Bug 可选 |
| `impact_scope` | 影响范围 | 可选提示数组；`前端` / `后端` / `全栈` / `部署` |
| `constraints` | 约束与非目标 | 可选字符串数组，以“约束：”前缀保存 |
| `non_goals` | 约束与非目标 | 可选字符串数组，以“非目标：”前缀保存 |
| `desired_at` | 期望完成时间 | `YYYY-MM-DD HH:mm:ss`，可选 |
| `references` | 参考资料 | 可选文本 |
| `attachments` | 附件 | 当前目录内相对路径数组 |

脚本自动注入且不接受模型指定：`产品负责人`、`提交幂等键`、`提交来源`。附件路径、大小与 SHA256 一起进入确认摘要；表单成功后同一内容摘要会按返回的记录编号固化到 `原始意图指纹`。该补写失败时回执进入 `unknown`，下次先按幂等键找到已有记录并完成指纹固化，不会重复提交表单。

受飞书现有表单主字段约束，`任务编号（系统自动生成，请勿填写）` 仍可能作为可选问题存在。V2 插件不得展示或提交它，任务编号由中央调度器生成；任务状态、执行阶段、状态版本、Thread、PR、部署、验收、锁、重试和审计字段都不属于提单插件。