跳到内容
StateDockStateDock
AI AGENT 任务流转规范 · AGENTFLOW

面向 AI Agent 的
任务流转协议与状态机

StateDock 为多 Agent 协作提供标准任务契约。ChatGPT、Claude Code、Cursor、OpenAI Codex 与 Antigravity 通过统一 MCP 协议读取上下文、认领 Ready 队列、挂起决策并交接成果。

五阶段状态机

从需求到交付的完整闭环

支持 Planned(探讨想法)、Ready(待认领队列)、Working(开工中)、Waiting(需人类决策挂起)与 Done(交付验证完毕)五种原子状态。

交互式任务流水线一个真实任务。多个不同 Agent。同一套共享状态。
stripe-billingstripe-124
Ready · 待执行

自动导出账单与 CSV 审计明细

按月汇总账户结算账单,支持生成月度 PDF 并导出 CSV 交易明细,需向下兼容缺少时间戳的旧版订单。

核心目标:

自动化导出 Stripe 账单与 CSV 明细

决策结论:

需求规范已理清 · 直接存入 Ready 待执行队列

你 · ChatGPT 网页版 (OAuth 2.1)

梳理出账单自动导出需求,支持按月下载 PDF 与 CSV 明细,存入 StateDock。

S

通过官方 OAuth 2.1 绑定 StateDock Remote MCP。在网页对话中梳理清晰需求与验收准则,一键入库并设为 Ready,无需切换窗口复制粘贴。

已存入 StateDock Ready 队列
在 ChatGPT 网页版聊出需求,直接存为 Ready。

网页大模型擅长构思与拆解,将你的模糊灵感转化为精准的任务指令。

标准 MCP 工具集

给 Agent 的机器可读契约

任何兼容 Model Context Protocol (MCP) 的 Agent 均可通过以下 5 个标准工具无缝接入 StateDock。

resume_project(project: string)
Agent 启动第一步 (强制)

会话启动或进入项目时调用,恢复目标、活跃任务、阻碍原因及最新交接摘要。

create_plan(status: 'WORKING' | 'READY' | 'PLAN', title, body)
执行前锁定 / 讨论保存

明确开发需求时调用,在修改代码前锁定任务;讨论想法时标记为 PLAN。

claim_next_task(project: string, mode?: 'mine' | 'unassigned')
队列自动化认领

认领项目 Ready 待办队列中的下一项任务,原子化将状态置为 WORKING。

pause_task(reference: string, reason: string)
遇到技术阻碍时

遇到破坏性变更、缺失凭据或需人类决断时调用,状态置为 WAITING 并推送手机通知。

submit_handoff(reference, { changes, verification, nextSteps })
开发与验证完成后

验证代码并完成任务后调用,提交三段式结构化交接记录,并将状态标记为 DONE。

三段式交接标准

不写散文,只留事实

当一个 Agent(如 Cursor)写完代码,交由下一个 Agent(如 Claude Code)进行测试时,必须留下精确的三段式交接结构。这保证了即使上下文窗口清空,下一个工具接手也能 100% 还原现场。

  • Changes(变更): 具体修改的文件列表与架构影响
  • Verification(验证): 运行了哪些单元测试、端到端测试与真实响应
  • Next Steps(后续建议): 给下一个接手者或人类的明确行动指引
// submit_handoff payload example:
{
  "reference": "SD-101",
  "handoff": {
    "changes": "Added Stripe webhook handler & signature checks in apps/api/src/webhook.ts",
    "verification": "12 unit tests pass. Tested Stripe webhook test event via CLI.",
    "nextSteps": "Claude Code: execute Playwright E2E checkout test."
  }
}
产品架构与能力边界

StateDock 是任务层,不是调度引擎

StateDock 不会自动在后台偷跑 Agent,也不负责调度你的算力资源。执行动作始终由人类或外部配置的 AI 工具主动发起。StateDock 负责持久化跨工具的任务、就绪队列、交接上下文与通知推送。