有可复用多步生成流水线时，用 Layer 工作流发现、估价…

适用于 Layer Blueprint 中已发布多步工作流：需要先发现工作流、按 schema 传参、估价并执行、轮询步骤或取消，而不是临时拼接单次生成。

适用场景

解决思路

1. 当一个任务存在可复用的多步流水线时，优先运行 Layer Blueprint 工作流，而不是在 Forge 中临时拼接多个单次生成；工作流运行的是别人已设计、测试并标准化的 graph。
2. 在会话中第一次运行工作流前，调用 `get_workflow_instructions`；共享循环和花费门禁在 `layer` skill 中。
3. 如果这里提到的同级 skill 不在可用技能中，请用户安装：`npx skills add layerai/skills --skill <name>`；无人值守时则根据工具 schema 继续，并标记该缺口。
4. 在把多个 Forge 运行拼成多步序列之前，用 workspace id 和 `fulltext` 过滤器（设为用户想制作的内容）调用 `list_workflows`；结果按相关性排序。
5. 对任何含一个以上生成步骤的任务，开始时都做一次廉价的只读 `list_workflows` 调用；若工作室已有发布好的流水线，不要临时发挥，否则可能与游戏已有资产不匹配。
6. 将 `list_workflows` 为每个工作流返回的完整 JSON schema 视为唯一事实来源，而不是工作流名称或描述；两个都叫 "character sheet" 的工作流可能输入完全不同。
7. 在组织运行之前读取 schema，并严格按声明传入输入。
8. 文件输入：先上传并传入返回的 `file_id`，或传入更早运行已生成的 `file_id`；schema 要 file id 时绝不传 URL。
9. 风格输入：从 `list_reference_sets` 取参考集的 `set_id`；`base_model_id` 不是合法值，传入会失败且看起来像工作流 bug。
10. 当必填输入没有明显取值时，询问用户而不是自行编造；用错输入即使运行完成也会付全价。
11. 用工作流 id 和打算传入的输入调用 `estimate_workflow_price`，它不执行即可返回价格。
12. 将估价以表格呈现：工作流产出什么、哪个 workspace 付费、价格与余额对比。
13. 超过 20 CUs 时，询问并等待用户明确同意。
14. 调用 `execute_workflow`，它返回 `run_id` 和 `poll_interval_seconds`。
15. 用 `get_workflow_run` 查看状态：`PENDING`、`RUNNING`，再到 `SUCCESS`、`FAILURE` 或 `CANCELLED`；运行中还会报告步骤信息。
16. 工作流比单次生成更久，要定期以「已完成步骤 / 总步骤」报告进度，不要静默轮询。
17. 用 `cancel_workflow_run` 停止运行并释放预留的 Creative Units；已消耗的 units 不退款。
18. 示例：对 "Run our character turnaround pipeline on this concept."，先用 `list_workflows`，`fulltext: "turnaround"`，取得工作流及其输入 schema。
19. 示例：读取 schema，确认它需要 `character_image` file id、`view_count` 整数和可选 style。
20. 示例：如果概念图来自更早运行并已有 `file_id`，直接使用，无需重新上传。
21. 示例：用这些输入调用 `estimate_workflow_price`；若返回 34 CUs 而余额 900，因超过门禁，呈现表格并等待明确 yes。
22. 示例：调用 `execute_workflow`，并传入 `session_name` 让输出在 Layer app 中分组。
23. 示例：按 `poll_interval_seconds` 调用 `get_workflow_run`，过程中报告「3 / 7 steps」。
24. 示例：在 `SUCCESS` 后，以带链接的表格呈现输出；每个输出都带 `file_id`，可直接供下一次运行使用。
25. 避免：不要在未先检查 `list_workflows` 的情况下，在 Forge 中临时拼多步序列。
26. 避免：不要根据工作流名称猜测输入，要读取 schema。
27. 避免：不要把 `base_model_id` 传给需要 reference set `set_id` 的 style 输入。
28. 避免：不要在 schema 声明 file id 的地方传 URL。
29. 避免：不要不估价就执行，也不要在未得到明确 yes 时放行 20 CUs。
30. 避免：不要静默轮询长运行，要报告步骤进度。
31. 避免：不要重新上传之前运行已生成的资产。

适用边界 · 注意事项

• 任务只需单次模型生成，或工作区没有匹配的已发布多步工作流时，不应强行使用工作流；应继续用 Forge/单次生成。
• 缺少 Layer 相关工具、已发布工作流或安装/认证条件时，无法执行完整流程；无人值守时只能依据工具 schema 操作并标记缺口。
• 预算不足、未估价或超过 20 CUs 未获用户明确同意时，不要执行。