运行时无关的 AI agent workflow 规格（如 itsHarness）应把「编排语义」与「具体 runtime（LangGraph/Claude Code/…）」解耦，用可移植的状态机/任务图描述，避免锁死单一供应商。

Claim

运行时无关的 AI agent workflow 规格（如 itsHarness）应把「编排语义」与「具体 runtime（LangGraph/Claude Code/…）」解耦，用可移植的状态机/任务图描述，避免锁死单一供应商。

Why it matters

多 harness 并存时，规格若不解耦会导致评测、迁移与二次开发成本指数上升；runtime-agnostic 是工程化 agent 的接口层。

Summary

运行时无关的 AI agent workflow 规格（如 itsHarness）应把「编排语义」与「具体 runtime（LangGraph/Claude Code/…）」解耦，用可移植的状态机/任务图描述，避免锁死单一供应商。

Actions

• (none)

Evidence

• (none)

Caveats

• (none)

Research queries

• (none)

Body

正文

背景

社区出现大量 LangGraph / Claude Code / 自定义 orchestrator 方案；若「工作流含义」绑死在某一 runtime，换引擎=重写。itsHarness 类项目试图提供 runtime-agnostic 规格讨论与参考实现。

机制

规格层描述任务、门禁、产物与回环；执行层由 adapter 落到具体 runtime。反馈线程强调：可移植性优先于单一框架便利；需明确状态序列化、失败语义与人工门。

取舍

抽象带来学习成本与「空壳规格」风险；过薄则无约束，过厚则无人用。与现有 maestro/ralph 状态机应对齐术语而非重复造轮。

动作

用一份真实 phase（plan→execute→gate）对照 itsHarness 概念表，输出映射矩阵与缺口清单。