2.0 KiB
2.0 KiB
飞书 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、部署、验收、锁、重试和审计字段都不属于提单插件。