本文档由 g2rain-agent-runtime 的
# 需求设计与验收模板
docs/requirements/README.md 自动同步生成。每项运行时需求至少记录以下内容:
- 目标与边界:说明用户目标、非目标,以及是否涉及执行、恢复、对话、工具或模型调用。
- 状态影响:列出新增或变更的任务/节点状态、迁移条件、检查点和幂等语义;同步更新
STATE_SPEC.md与状态图。 - 接口与事件:列出 HTTP、SSE、MCP 或服务间契约的请求、响应、错误及兼容性策略。
- 安全与失败处理:说明授权、敏感数据处理、超时、重试、取消、恢复和人工介入方式。
- 验收条件:包含成功路径、失败路径、恢复路径和可观测性断言。
涉及 Agent 配置、MCP 注册或模型供应商接入时,需求须明确对应责任仓库,不在 Runtime 内重复实现其管理职责。