plan

name	plan
description	在 LLMGateway 正式实现阶段编写和执行单文件 plan.md。适用于中大型开发、跨模块修改、产品边界调整、架构硬化、生产级验收和任何不能靠一次小补丁完成的任务；单纯初始化或讨论阶段不创建 plan.md。

Plan

plan.md 是正式实现阶段当前中大型任务的单文件执行合同，同时承担需求、事实、失败测试、目标、设计、任务、验证和收口记录。没有实际实现任务时只保留 plan.example.md。

触发后先做

1. 读取根目录 AGENTS.md。
2. 读取 .agents/skills/llmgateway-dev/SKILL.md。
3. 完整读取 spec.md 与 dev.md，调查当前仓库、工作区、实现、持久状态、测试、文档和运行事实。
4. 已有 plan.md 属于当前任务时更新；不属于时先向 owner 确认是否替换。
5. 没有当前计划时，以 plan.example.md 为结构参考创建根目录 plan.md。
6. 写完计划再做大改；新事实推翻计划时，先更新计划再继续。

事实边界

• 用户输入是需求来源，不自动等于已经实现的事实。
• 只把仓库、命令、运行结果和 owner 明确确认的内容写成事实。
• 区分已确认事实、owner 提供但未验证的事实、推测、计划事项和已完成并验证事项。
• 一个任务只维护一个根目录 plan.md。
• 切片和任务按可验收业务结果命名；数字只表达执行顺序，不使用 v1/v2/v3、new/old、legacy 或相似名称制造并行版本事实。
• checklist 随进度即时更新，不能在最后一次性全部勾选。
• 不把历史过程、废弃语义或兼容方案写入当前产品主干。
• 功能可以分切片，质量不能分期。每个进入主干的切片必须包含成功、错误、并发、中断、恢复、安全、可观测性、测试和文档。
• 首次生产发布前，不兼容的 schema、API、配置、事件和生成合同变化直接重建当前基线；计划不得为尚不存在的生产数据设计兼容层或积累过渡 migration。
• 计划不能用“先做 demo”“以后补生产化”掩盖当前切片的已知缺口；不在当前范围的能力明确不做。

标准结构

plan.md 必须按以下顺序组织：

1. 需求文档：用户、问题、范围和可验收完成标准。
2. 当前事实：已经核实的实现、测试、文档、配置、能力、缺口和未知项。
3. 失败证据：问题仍存在时可观察或可自动验证的结果。
4. 最终目标：完成后可以明确判断成功或失败的生产级终局与不变量。
5. 不做范围：本次明确排除的内容。
6. 设计：事实 owner、状态、数据流、接口、错误、恢复、安全和关键取舍。
7. 生产级切片：每个切片独立闭环实现、恢复、测试和文档。
8. 实施任务：覆盖调查、实现、测试、文档、验证和交付的 checklist。
9. 恶劣路径矩阵：记录接受、提交、失败状态、恢复 owner、重放/幂等与验证证据。
10. 验证计划：定向检查、完整验证、竞态/并发、目标平台、真实 Provider 和安全检查。
11. 收口：完成事实、实际命令、通过项、未验证项、剩余风险和外部操作状态。

完成标准

• owner 能从计划中判断需求、边界和完成状态。
• 开发者能按设计和任务继续执行。
• 验证者能按真实命令和场景复现结果。
• 每个当前切片都能回答接受、执行、提交、中断、失败、恢复、重放和清理边界。
• plan.example.md 只作为结构模板，不替代当前任务计划。