实施计划模板
本模板是 docs/plans/ 内实施计划的固定结构。它不是审批表，也不引入普通任务门禁；作用是让每项计划在开始前明确目标、执行能力、成果、验收和如何复用 AgentMeshOS 分布式计算底座。
计划状态
- 计划名称：
- 阶段位置：当前阶段 / 后续阶段；阶段编号与前后依赖
- 计划状态：完善中 / 已完成 / 已取消
- 阶段状态：等待前置阶段 / 进行中 / 已完成并归档 / 已取消
- 当前工作包：仅当前阶段填写稳定工作包编号与名称
- 当前记录：
- 进入条件：上一阶段必须已经完成并归档的事实
- 目标与完成边界：
架构、数据与接口契约
- 技术栈与选型：延续或新增的技术栈，并比较可维护性、部署复杂度、性能、学习成本和扩展性
- 数据对象：对象 ID、权威状态、版本、关联关系、持久化位置和迁移边界
- 状态机：允许状态、转换条件、失败、中断、恢复、取消、重试和幂等规则
- API：查询、创建、修改、控制和错误返回；管理员身份、版本号与幂等键要求
- Console：用户入口、信息层级、人类可读结果、技术详情、自定义弹窗、桌面和移动端边界
- 兼容与迁移：旧数据库、旧接口、旧 Console、历史对象和回滚后的读取边界
目标、成果与验收契约
- 目标：要解决的问题和明确不包含的范围
- Worker 能力：使用已登记的逻辑能力 ID、版本和执行位置
- 预期成果：成果类型、名称、版本和结果契约
- 成果存储位置：
inline/ Runtime SQLite / Cloudreve / URL / Git / 镜像摘要 / 数据库引用 / 操作引用 / 外部回执 - 验收标准：逐条写成可判断条件，区分必需和可选
- 自动检查器：检查器 ID、版本、支持边界和失败处理
- 证据：来源、安全引用、哈希、可访问性和对应验收标准
- AI 审核：结构化
accept/rework/insufficient_evidence及依据 - Benson 决定条件：破坏性、外部业务、未知风险、证据不足或检查器不支持时的操作
- 风险：数据、权限、网络、外部副作用和不可恢复风险
- 回滚：代码、数据库、部署、成果和外部动作的恢复边界
- Token 预算：规划、执行、审核和返工使用 AI 工作台可见配置；明确有限或无限制，不得另设隐藏上限
- 生命周期：计划、任务、成果、检查、验收、返工、重开、替代和清理
工作包与依赖
每个工作包必须明确：
- 编号与名称：稳定阶段编号，例如
P6-1 - 目标：本工作包解决的单一问题
- 前置依赖：必须已完成的工作包或外部事实
- 实施范围：数据、API、Runtime、Console、Worker、Docs 和部署中的适用部分
- 预期成果：代码、迁移、接口、页面、运行证据或文档
- 验收标准：可重复执行、可以判断通过或失败的检查
- 失败与回滚：失败时停在哪里、保留什么、如何回退且不破坏历史
工作包必须给出依赖顺序；允许并行的工作包要明确共享契约和合并门槛，不得只按编号推测依赖。
分布式底座接入声明
必须明确填写“接入”或“本阶段不接入”，不得留空或写“待定”。
- 接入结论：接入 / 本阶段不接入
- 使用层：Network / Nomad / Compute / Storage / Observability（逐项写明使用或不适用）
- Adapter 归属：NomadAdapter / StorageAdapter / ToolAdapter / FeedbackAdapter（或明确不适用）
- 执行映射：主节点处理内容；
pcdell-101、pcdell-103或其他 Worker 处理内容；是否使用 Nomad Batch - 数据路径：输入、结构化结果、证据、长期数据、临时数据和清理位置
- 凭据路径：受控服务持有的凭据；Worker、模型、MCP Tool 明确不可见的凭据
- 生命周期：提交、状态回收、失败、重试、结果回收、临时文件和一次性凭据清理
- 验收证据：Nomad Job/Allocation、实际节点、资源、结果、Storage、日志和 Console 需要验证的事实
纯文档或纯讨论计划也必须写明“本阶段不接入”及原因。存在计算、采集、解析、批处理、文件结果或运行状态的计划，不得省略对应层和适配器说明。
实施步骤
1.
发布批次与阶段门
- 批次划分：每批涉及的 Runtime、Console、Worker、Docs 和迁移范围
- 批次进入条件：开始该批次前必须通过的自动化与人工验收
- 批次退出条件：代码、生产、数据、健康、公网页面和回滚证据
- 阶段出口：全部必需工作包、真实生产验收和文档归档条件
验收与发布
- 代码、文档和运行态检查：
- 底座接入的真实证据：
- 回滚和清理：