Files
easyai-codex-plugins/plugins/easyai-product-intake/skills/easyai-submit-task/references/base-schema.md
T

2.0 KiB
Raw Blame History

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