feat(插件): 发布意图提单 V2

2026-08-27 12:03:08 +08:00
parent 72e5396e6d
commit 758aa59470
10 changed files with 1107 additions and 215 deletions
@@ -1,28 +1,27 @@
-# 飞书 Base 字段契约
+# 飞书 Base V2 提单契约

- Base Token: `Ed21b9VwNaZfiesxWgDc67wXnoc`
- 数据表: `tblelMMlOif1YHPD`（需求与缺陷）
- 受控表单: `产品需求与 Bug 提交`
- 表单提交范围: 仅企业内获得链接的用户
+目标 Base 与表单由组织配置固定；脚本每次提交前读取真实表单详情，校验字段类型、必填配置和选项，不在 Skill 文档中复制一套可漂移的字段定义。

-允许提交的字段：
+允许提交的 JSON：

-| JSON 属性 | Base 字段 | 值 |
-|---|---|---|
-| `type` | 类型 | `需求` / `Bug` |
-| `title` | 标题 | 非空文本 |
-| `background` | 需求背景与目标 | 非空文本 |
-| `acceptance_criteria` | 验收标准 | 非空字符串数组 |
-| `priority` | 优先级 | `P0` / `P1` / `P2` / `P3` |
-| `environment` | 发生环境 | Bug 必填 |
-| `reproduction_steps` | 复现步骤 | Bug 必填字符串数组 |
-| `actual_result` | 实际结果 | Bug 必填 |
-| `expected_result` | 期望结果 | Bug 必填 |
-| `impact_scope` | 影响范围 | `前端` / `后端` / `全栈` / `部署` 数组，可选 |
+| 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、部署、验收、锁、重试和审计字段都不属于提单插件。