仓库地址：repo
0. 本文要解决的核心断点
旧版 MVP 的根节点上下文构建方式非常脆弱：只截取 PRD 前若干行文本。其后果是：
- 业务规则和验收条件大量丢失
- 根节点职责边界模糊
- 信息失真沿分解树逐层放大
因此，这次迭代聚焦“信息无损传递链”的建立。
1. 关键设计一：JSON PRD 注入根节点
在初始化阶段先把自然语言 PRD 转为结构化 JsonPRD，再由 create_root_from_prd 构建根节点。
它至少覆盖：
- 功能需求与非功能需求
- 验收标准与技术约束
- 全局数据源、初始状态与 schema
- 输入输出格式规格
根节点不再是摘要片段，而是带约束与状态语义的可执行蓝图。
2. 关键设计二：subPRD 做父子信息桥接
只解决根节点还不够，父子节点之间也需要结构化传递。为此引入了比完整 PRD 更轻量的 subPRD：
- 保留功能描述与边界
- 保留输入输出规格
- 保留数据源操作约束
- 控制信息密度，避免上下文过载
3. 关键设计三：ChildContract 固化接口契约
分解阶段直接产出并固化 ChildContract，核心字段包括：
- purpose / behavior
- signature（不可随意漂移）
- inputs / outputs
- preconditions / postconditions
- data_operations
在 codegen 阶段，父节点签名与子节点契约同时进入提示词，减少接口漂移空间。
4. 已观察到的收益
结合当前测试输出，主要收益体现在四点：
- 需求覆盖完整度提升
- 节点层次与边界更清晰
- 接口一致性有了前置约束
- 信息传递从“脑补”变为“结构化对齐”
5. 仍需补强的部分
当前版本依然有工程性短板：
global_vars声明与代码实现仍有错位- 个别必填业务字段会在链路中丢失
- 契约验证仍偏浅层，闭环不完整
- 跨函数返回值类型一致性仍需加强
下一步会继续沿“结构化输入 + 契约校验”方向推进到更强的自动化验证层。