---
name: feishu-bitetable-creator
description: "把已有视频制作流程整理为飞书多维表格自动化工作流。用户提到“把刚才的视频制作流程固化为飞书多维表格工作流”“整理成飞书多维表格自动化”“生成飞书多维表格工作流提示词”时必须使用本规则。输入可以是自动化代码脚本，也可以是多轮对话；输出必须同时包含多维表格字段结构与飞书多维表格的工作流提示词。"
---

# Feishu Bitable Creator Skill

用于把一条已经存在的视频制作链路，抽象为可落到飞书多维表格中的字段结构与按钮工作流说明，方便用户后续在飞书多维表格中实现半自动或全自动执行。

这个规则的重点不是直接替用户剪视频，而是把“已有流程”翻译成飞书多维表格可执行的工作流设计文档。

## 何时使用

- 用户想把“刚才的视频制作流程”沉淀成飞书多维表格工作流
- 用户希望把一段自动化脚本转换成飞书多维表格字段和按钮流程
- 用户希望给飞书多维表格 生成一段可直接使用的工作流描述提示词
- 用户明确提到“飞书多维表格”“bitable”“飞书自动化”“固化工作流”

## 输入形态

支持以下两类输入，至少命中一种：

1. 自动化代码脚本
- 例如 Python/JS 脚本、curl 串联、伪代码、接口调用顺序说明
- 需要先抽取其中的输入参数、执行步骤、异步任务、结果字段

2. 多轮对话
- 例如用户和助手已经反复讨论过一条视频生产流程
- 需要先整理出显式步骤、隐含前置条件、失败重试点、产物字段

若输入信息零散，先做一次“流程归纳”，再生成最终输出。

## 固定输出

必须同时输出以下两个部分，缺一不可：

1. `飞书数据表创建 Prompt`
- 第一部分必须先输出一个可直接交给 AI 的 `建表提示词`
- 这个 Prompt 的核心目标是：`创建一个数据表，表格的结构是 xxx`
- Prompt 中要明确写出表头结构，包括列名、列类型、用途、是否必填
- 第一部分生成的表头顺序必须固定为：`输入` -> `执行` -> `状态` -> `结果`
- Prompt 中必须明确要求：创建完表格后，自动新增一条默认记录，作为这条工作流的初始测试数据

2. `飞书多维表格 工作流 Prompt`
- 这是给飞书多维表格工作流 使用的系统级执行说明
- 这一部分在第一部分建表完成后继续使用
- 必须写清每个按钮会触发什么动作、依赖哪些列、成功后回写哪些列、失败时如何记录

## 工作方法

1. 先理解原流程
- 按时间顺序整理所有步骤
- 标记同步步骤与异步步骤
- 标记哪些步骤调用 VectCut，哪些是飞书内部状态流转

2. 先生成 Python 工作流脚本
- 先把这条低代码工作流抽象成一份 Python 代码脚本
- 这份 Python 工作流脚本是中间产物，用于推导表头与最终 Prompt，本身不属于最终固定输出
- 代码中应明确每个节点调用什么接口、依赖什么上游结果、成功后产出什么、失败时如何停止或回写
- 若有异步任务，应用代码应固定轮询间隔为3分钟、循环条件和退出条件

3. 再根据 Python 脚本的总体输入参数设置表头
- 第一部分的数据表结构，不是根据每个节点的全部内部参数生成
- 而是根据这份 Python 工作流脚本对外暴露的“总体输入参数列表”来设置 `输入` 分组
- 再根据脚本定义的触发动作来设置 `执行` 分组
- 再根据脚本最终需要回写的运行状态来设置 `状态` 分组
- 再根据脚本最终需要回写的“总体结果字段”来设置 `结果` 分组
- 节点内部临时变量、推导参数、中间结果，不应默认进入第一部分表头

4. 最后生成两段 Prompt
- 第一段用于创建数据表
- 第一段应根据 Python 脚本的总体输入参数、执行动作、状态字段、总体结果字段来描述表头
- 第二段用于驱动工作流执行
- 第二段应把 Python 脚本已经表达清楚的执行顺序、条件、循环、接口调用、回写逻辑，转写成“点击按钮后读取什么、执行什么、成功后写回什么、失败时写回什么”的可直接落地低代码工作流 Prompt

## 多维表格设计原则

- 第一部分优先输出“创建数据表 Prompt”，而不是零散说明
- 这个 Prompt 要能被直接复制给 AI，用来创建飞书多维表格
- 第一部分表头的来源口径固定为：根据 Python 脚本的总体输入参数、执行动作、状态字段、总体结果字段设置表头，而不是先写固定推荐字段
- 第一部分的字段顺序必须固定为：`输入`、`执行`、`状态`、`结果`
- 第一部分必须额外明确：建表完成后自动新增一条默认记录，并写清默认值
- 若场景需要，按钮列和状态列也可以写入第一部分建表 Prompt，但必须严格放在对应分组中
- 列名要可读，优先业务语义，不要只写内部变量名
- 一个按钮只承担一个主要目标，避免一个按钮混杂过多分支
- 每个会产生草稿、任务或媒体结果的步骤，都要有对应结果列，避免结果丢失

## 第二部分：工作流执行 Prompt

第二部分用于告诉飞书多维表格 如何基于第一部分已经创建好的数据表执行工作流。

这一部分必须产出“一段可以真实构建工作流的最终 Prompt”，而不是分析过程、查资料过程或执行建议。拿到这段 Prompt 后，飞书多维表格 可直接按工作流顺序执行。

这一部分重点描述：
- 整条工作流的执行顺序
- 尽量使用线性顺序结构，避免复杂分支
- 若必须区分不同路径，优先通过第一部分的输入字段明确指定所需分支，而不是在第二部分中展开多层条件分支
- 每个按钮触发后按什么顺序执行
- 少量必要执行条件和失败条件
- 若有异步任务，工作流中的循环和停止条件
- 点击按钮后读取哪些列
- 点击按钮后执行什么动作
- 需要发起请求时，在对应执行步骤里直接写出请求方法、URL、请求头、请求体
- 各步骤如何判断成功
- 成功后把什么结果写回哪些列
- 失败时如何回写错误和状态

### 第二部分生成约束

在生成第二部分之前，你应先在内部完成所有接口确认与鉴权准备；这些准备动作不要再出现在最终 Prompt 里。

1. 先内部查明当前场景要用的实际接口
- 包括接口 URL、请求方法、必填参数、可选参数、返回结构、异步查询方式
- 最终 Prompt 中不要再出现“先查接口”“先分析接口是否可用”“先确认返回结构”这类步骤

2. 先内部确定鉴权信息
- 如果当前执行环境中已有 `VECTCUT_API_KEY`，则在生成 Prompt 时直接使用当前环境中的实际值完成请求头预填
- 不要假设飞书多维表格 的运行环境也有 `VECTCUT_API_KEY`
- 最终 Prompt 中不要再出现“去哪里获取 API_KEY”“检查环境变量”“读取 `$VECTCUT_API_KEY`”这类步骤
- 规则文档本身不要写死具体 token，但最终 Prompt 应视为已经完成实际值替换

3. 输入是本地文件时，先在生成阶段确定是否需要 `sts-upload`
- 若需要上传，最终 Prompt 中应直接把上传动作写成一个明确步骤
- 不要把“是否需要上传”留给飞书智能体临场判断

4. 涉及已有草稿继续编辑时，先在生成阶段确定 `draft_id` 传递规则
- 最终 Prompt 中应明确写出后续所有写入步骤都持续透传同一个 `draft_id`
- 避免多次写入落到不同草稿

5. 第二部分默认优先生成线性工作流，不要主动展开复杂分支树
- 如果存在多个可选链路，优先把分支选择前置为第一部分中的显式输入字段，例如 `工作流类型`、`处理模式`、`模板类型`
- 第二部分应根据这些输入字段的取值，明确选择唯一执行路径
- 除非用户明确要求保留多分支结构，否则不要在最终 Prompt 中生成多层 if/else、嵌套条件或平行分支
- 能通过输入提前说清“要哪个分支”，就不要把判断逻辑留到执行时

## 异步任务统一策略

飞书多维表格 循环有 20 次上限，因此所有异步任务都按统一保守策略描述：

1. 提交异步任务后，不要立刻高频轮询
2. 统一等待 3 分钟后，再发起第一次状态查询
3. 若结果仍未完成，继续按 3 分钟间隔查询
4. 每次查询都回写第一部分已经建好的结果列：
- `异步任务ID`
- `当前阶段`

在提示词里要明确写出：异步任务的默认轮询间隔为 180 秒，目的是适配飞书多维表格 的循环次数限制。

## 按钮描述要求

为飞书多维表格 生成的第二部分 Prompt 中，每个按钮都要写清以下四项：

1. 读取哪些列
2. 调用哪些动作或接口
3. 把什么结果写回哪些列
4. 失败时更新哪些结果列

如果一个按钮理论上可能进入多个分支，优先在读取列中加入一个显式选择字段，让按钮只执行一个已选定分支，不要在按钮内部展开复杂分支判断。

例如：

- `按钮-创建草稿`
  - 读取：第一部分中的 `标题`、`尺寸`、`封面`
  - 动作：直接调用已确认的 `create_draft` 接口，按最终 Prompt 中给定的请求方法、URL、请求头和请求体执行；鉴权信息在生成 Prompt 时已完成实际值替换
  - 回写：`草稿ID`、`草稿链接`、`当前阶段`
  - 失败：写入 `当前阶段=失败`

## 建议输出模板

回答时优先使用下面结构：

### 一、飞书数据表创建 Prompt

第一部分必须先输出一个可直接复制的 Prompt，这个 Prompt 至少要包含：
- `请创建一个新的飞书多维表格`
- `表格的结构如下`
- 表头分组顺序：`输入`、`执行`、`状态`、`结果`
- 每列的 `列名`
- 每列的 `列类型`
- 每列的 `是否必填`
- 每列的 `用途`
- `创建完成后自动新增一条默认记录`

字段必须按当前任务裁剪，并严格按 `输入`、`执行`、`状态`、`结果` 的顺序输出。

### 二、飞书多维表格 工作流 Prompt

提示词中至少包含：
- 顺序、少量必要条件、循环、失败回退要写成可直接执行的按钮触发式工作流
- 默认优先输出线性工作流；若存在不同路径，应通过输入字段先明确指定要走哪条路径
- 应使用“点击某个按钮后，读取什么、执行什么、成功后写回什么、失败时写回什么”的描述方式，尽量不要使用“节点1/节点2”式表达
- 各执行步骤都要明确请求方法、URL、请求头、请求体、成功条件、回写字段，但要写在对应步骤里，不要先单独罗列字段清单或接口总览
- 最终 Prompt 中不要再出现“先查接口”“先找 API_KEY”“先确认返回结构”这类中间步骤
- 每个按钮的执行说明
- 异步任务等待 3 分钟后查询的统一规则
- 错误处理与结果回写规则

## 额外要求

- 若用户给的是代码脚本，先把代码流程翻译成业务步骤，不要直接逐行照抄代码
- 若用户给的是多轮对话，先消解上下文歧义，再输出最终方案
- 若存在多个可选链路，优先输出“基础可跑版本”，再补充可扩展按钮
- 不要只给抽象建议，必须产出可直接落表的列结构和可直接贴给飞书多维表格 的提示词