通过 Ask Gina 技能实现的工作流

功能说明

为 Gina sandbox 自动化提供一套实用的工作流编写与运维标准。

• 创建并验证工作流定义。
• 执行工作流，并检查产出物（artifacts）/日志。
• 应用可重复的「评估 → 优化 → 对比」循环。
• 使用安全的 TypeScript/SQL/KV 模式实现步骤逻辑。

适用场景

• 你正在创建或维护多步骤工作流编排任务。
• 你需要基于运行产出物进行可复现的调试。
• 你希望借助基线对比实现可度量的性能改进。

不适用场景

• 该任务仅为单次操作，无需编排能力。
• 你仅需高层策略性语言描述，而不需要可执行的具体步骤。
• 你无法明确声明所需权限或副作用（side effects）。

输入

• 工作流意图及成功判定标准。
• 触发器定义与输入 Schema。
• 所需工具/数据源及其权限范围。
• （可选）用于优化的基线运行 ID（baseline run ID）。

输出

• 已验证的工作流定义（.ts 文件）。
• 具备可追溯产出物的可执行流程。
• 含基线对比信息的评估记录。
• 清晰、明确的回滚路径，以应对退化（regression）问题。

核心命令

workflow create 
workflow validate 
workflow run  [--input JSON]
workflow status 
workflow logs  [--step ]
workflow eval 
workflow optimize  --baseline 
workflow rollback  

初始化配置

1. 确认工作流工具已就绪（执行 workflow list 应成功返回）。
2. 在 /workspace/.harness/workflows/ 路径下新建或打开目标工作流目录。
3. 若存在版本化变体，请将当前活跃版本统一命名为 @latest.ts。
4. 每次运行前均须验证：执行 workflow validate 。
5. 对高风险变更，应在编辑前先捕获一次基线运行并完成评估。

能力契约检查清单

针对每个工作流条目，需显式定义以下内容：

• 触发器（Trigger）。
• 输入（Inputs）。
• 输出（Outputs）。
• 副作用（Side effects）。
• 失败模式（Failure modes）。
• 权限范围（Permission scope）。

失败模式

• 因步骤定义格式错误导致验证失败。
• TypeScript / SQL / Bash 步骤在运行时发生错误。
• 缺少必要工具权限，或对应工具不可用。
• 数据结构变更引发解析（parse）或类型转换（cast）失败。
• 对外部服务调用超时或重试次数耗尽。

安全与权限

• 按步骤最小化授权，使用 allow 和 block 显式声明。
• 所有权限必须在提交契约中明确定义（禁止使用通配符权限）。
• 切勿在技能文本、日志或示例中直接嵌入原始密钥（raw secrets）。
• 将所有写入操作（如文件、KV、外部 POST 请求、交易动作等）视为显式副作用。

证据要求

• 提供一条评审者可在 10 分钟内完成执行的配置路径。
• 至少提供一个可复现的运行产出物或运行日志示例。
• 清晰陈述预期输出结果，以及可接受的失败行为定义。

可选目录结构

workflows/
  SKILL.md
  references/   # 实现细节与 API 文档
  scripts/      # 可选辅助脚本，用于执行可复现的校验
  assets/       # 可选图表或截图

参考材料

深度技术参考资料被有意拆分为独立文档：

• references/cli-and-definition.md
• references/eval-optimize-and-artifacts.md
• references/polymarket-patterns.md

请将这些文档作为附录查阅，同时保持本文件聚焦于实际运维使用场景。