面向 AI Agent 的
任务流转协议与状态机
StateDock 为多 Agent 协作提供标准任务契约。ChatGPT、Claude Code、Cursor、OpenAI Codex 与 Antigravity 通过统一 MCP 协议读取上下文、认领 Ready 队列、挂起决策并交接成果。
从需求到交付的完整闭环
支持 Planned(探讨想法)、Ready(待认领队列)、Working(开工中)、Waiting(需人类决策挂起)与 Done(交付验证完毕)五种原子状态。
自动导出账单与 CSV 审计明细
按月汇总账户结算账单,支持生成月度 PDF 并导出 CSV 交易明细,需向下兼容缺少时间戳的旧版订单。
自动化导出 Stripe 账单与 CSV 明细
需求规范已理清 · 直接存入 Ready 待执行队列
梳理出账单自动导出需求,支持按月下载 PDF 与 CSV 明细,存入 StateDock。
通过官方 OAuth 2.1 绑定 StateDock Remote MCP。在网页对话中梳理清晰需求与验收准则,一键入库并设为 Ready,无需切换窗口复制粘贴。
网页大模型擅长构思与拆解,将你的模糊灵感转化为精准的任务指令。
给 Agent 的机器可读契约
任何兼容 Model Context Protocol (MCP) 的 Agent 均可通过以下 5 个标准工具无缝接入 StateDock。
resume_project(project: string)会话启动或进入项目时调用,恢复目标、活跃任务、阻碍原因及最新交接摘要。
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(后续建议): 给下一个接手者或人类的明确行动指引
{
"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 负责持久化跨工具的任务、就绪队列、交接上下文与通知推送。
