
工作支持与交付 · 功能说明
当关键事实确认后,需求文档、评审演示和执行表从同一版事实生成,日期、范围、指标和负责人不会各说各话。我可以只要本轮真正需要的一种文件,之后再从同一版补齐其他格式。
当前情况:已有从同一份事实生成文档、演示与执行表的功能,9 月 1 日用合成材料验收过,之后没有重新生成;9 月 24 日起,生成时只用刚核对过的那一份清单。整组文件替换仍可能部分完成。
源码事实核对截至 2026-11-04 09:12(北京时间);历史测试保留各自日期;页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


工作支持与交付 · 功能说明
当关键事实确认后,需求文档、评审演示和执行表从同一版事实生成,日期、范围、指标和负责人不会各说各话。我可以只要本轮真正需要的一种文件,之后再从同一版补齐其他格式。
当前情况:已有从同一份事实生成文档、演示与执行表的功能,9 月 1 日用合成材料验收过,之后没有重新生成;9 月 24 日起,生成时只用刚核对过的那一份清单。整组文件替换仍可能部分完成。
源码事实核对截至 2026-11-04 09:12(北京时间);历史测试保留各自日期;页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


用途与实际影响
如果需求文档、演示和表格各自制作,或写进别的版本目录,资料和结论很容易混用;同一版事实要先过质量门,再按需生成。
我可以说:“事实已经确认,这一轮只要 PRD;评审演示和执行表以后再做。”项目只生成本轮需要的 PRD 与追溯材料,之后仍能从同一事实版本补齐其余交付物。
完整请求会交回PRD正文、来源与事实清单、追溯表、Word需求文档、评审演示和执行跟踪表六份文件;只要PRD时交回对应子集。每一版单独保存。若制作或写入中断,会逐个说明哪些文件已成、哪些仍缺,不能把部分完成说成整套成功。

用途与实际影响
如果需求文档、演示和表格各自制作,或写进别的版本目录,资料和结论很容易混用;同一版事实要先过质量门,再按需生成。
我可以说:“事实已经确认,这一轮只要 PRD;评审演示和执行表以后再做。”项目只生成本轮需要的 PRD 与追溯材料,之后仍能从同一事实版本补齐其余交付物。
完整请求会交回PRD正文、来源与事实清单、追溯表、Word需求文档、评审演示和执行跟踪表六份文件;只要PRD时交回对应子集。每一版单独保存。若制作或写入中断,会逐个说明哪些文件已成、哪些仍缺,不能把部分完成说成整套成功。

这一版事实已确认,来源清单与保存状态一致时,先准备请求的文件,再逐份写入这一版目录;全部写完才交回完整文件集。
来源清单与当前事实不一致,或文件写到别的版本目录时先停。制作或逐份写入中断后,逐个查看实际文件:可能有些已更新,有些仍是旧版。
制作 Word、演示或表格所需环境缺失时,保留已有 PRD、来源与追溯文件和待办,不把预览说成正式 Office 成品。

这一版事实已确认,来源清单与保存状态一致时,先准备请求的文件,再逐份写入这一版目录;全部写完才交回完整文件集。
来源清单与当前事实不一致,或文件写到别的版本目录时先停。制作或逐份写入中断后,逐个查看实际文件:可能有些已更新,有些仍是旧版。
制作 Word、演示或表格所需环境缺失时,保留已有 PRD、来源与追溯文件和待办,不把预览说成正式 Office 成品。

确认事实后,说这轮只要 PRD,或指定还需评审演示与跟踪表。
- 本轮要 PRD、Word、演示或执行表中的哪些文件
- 需要特别保留的内容或格式要求(如有)


确认事实后,说这轮只要 PRD,或指定还需评审演示与跟踪表。
- 本轮要 PRD、Word、演示或执行表中的哪些文件
- 需要特别保留的内容或格式要求(如有)





- DeliveryCompiler 依次写 PRD.md、manifest.json 和 traceability.csv,各用同目录临时文件替换;三文件与 SQLite 状态不构成一个跨文件事务。
- artifacts.py 先从 SQLite 重建清单并与磁盘上的 manifest(清单) 逐字段核对,再直接用这次读到的字节,在同目录临时区写一份清单副本;三个 builder 只读这份副本。核对之后即使磁盘上的原清单被换掉,这次生成也不会读到另一个内容(2026-09-24 起)。
- DOCX builder 使用 python-docx;PPTX/XLSX builder 使用 Node 包 @oai/artifact-tool。2026-10-11 只读查看:默认 Python 为 3.14.7、python-docx 1.2.0,PPTX/XLSX 所需的 Node 运行环境没有在这次核对里提供,当前完整运行情况未核实。
- 所请求 builder 在临时 staging 并行生成,全部返回后依次检查各文件非空并 os.replace 到所属 build 目录;没有跨文件事务或替换失败回滚。
- 两套合成 acceptance 和 tests 在构建后重新导入 Office,检查 PPT 几何、XLSX 公式和全部页面/工作表;公开 artifacts 命令本身不自动运行这整套验收。



- DeliveryCompiler 依次写 PRD.md、manifest.json 和 traceability.csv,各用同目录临时文件替换;三文件与 SQLite 状态不构成一个跨文件事务。
- artifacts.py 先从 SQLite 重建清单并与磁盘上的 manifest(清单) 逐字段核对,再直接用这次读到的字节,在同目录临时区写一份清单副本;三个 builder 只读这份副本。核对之后即使磁盘上的原清单被换掉,这次生成也不会读到另一个内容(2026-09-24 起)。
- DOCX builder 使用 python-docx;PPTX/XLSX builder 使用 Node 包 @oai/artifact-tool。2026-10-11 只读查看:默认 Python 为 3.14.7、python-docx 1.2.0,PPTX/XLSX 所需的 Node 运行环境没有在这次核对里提供,当前完整运行情况未核实。
- 所请求 builder 在临时 staging 并行生成,全部返回后依次检查各文件非空并 os.replace 到所属 build 目录;没有跨文件事务或替换失败回滚。
- 两套合成 acceptance 和 tests 在构建后重新导入 Office,检查 PPT 几何、XLSX 公式和全部页面/工作表;公开 artifacts 命令本身不自动运行这整套验收。





| 名词 | 意思 |
|---|---|
| ArtifactBuild(产物构建) | 绑定 package、事实修订、semantic hash(内容指纹)、状态、时间和唯一输出目录的一次正式构建。 |
| Canonical binding(规范绑定) | 内部 builder 只接受公开入口刚核对过的那份清单副本及其 SHA-256 和 build ID,用来防止误走实现脚本或读到被换过的清单。 |
| OOXML(Office 开放文档格式) | DOCX、PPTX 与 XLSX 的标准文件结构,可被 Microsoft Office 与 WPS 读取。 |

当前正式输出严格是三类追溯文件和三类 Office 文件;不存在项目计划、周报、汇报或调用方自行追加的第七个正式文件。



当前正式输出严格是三类追溯文件和三类 Office 文件;不存在项目计划、周报、汇报或调用方自行追加的第七个正式文件。

- 不提供任意模板商城
- 不支持现成计划/周报/汇报
- 预览QA留在正式目录外
- 每次builder不自动完成重导入/几何/公式/全页检查
- 内部环境绑定不是授权或安全证明
- 视觉合成不等于真实内容正确
- 正式目录指向另一个 build: 在写 Office 文件前拒绝,两个 build 都保持不变。

- 不提供任意模板商城
- 不支持现成计划/周报/汇报
- 预览QA留在正式目录外
- 每次builder不自动完成重导入/几何/公式/全页检查
- 内部环境绑定不是授权或安全证明
- 视觉合成不等于真实内容正确
- 正式目录指向另一个 build: 在写 Office 文件前拒绝,两个 build 都保持不变。

- 任一 builder 在生成阶段失败: 不晋升本轮暂存 Office;保留核心文件与精确错误。
- 生成完成后逐文件检查或替换失败: 之前已替换的文件不会自动撤销;核对所属 build 和各文件实际状态,再决定重生成,不能把部分输出称为完整包。
- 调用方只请求 docx: 只构建产品需求文档.docx,不启动或等待 PPTX/XLSX。

- 任一 builder 在生成阶段失败: 不晋升本轮暂存 Office;保留核心文件与精确错误。
- 生成完成后逐文件检查或替换失败: 之前已替换的文件不会自动撤销;核对所属 build 和各文件实际状态,再决定重生成,不能把部分输出称为完整包。
- 调用方只请求 docx: 只构建产品需求文档.docx,不启动或等待 PPTX/XLSX。

PRIVATE source · compiler.pycore files、quality和不可覆盖build
PRIVATE source · artifacts.py公开Office入口、核过字节的清单副本、staging与正式目录绑定
PRIVATE artifact buildersDOCX/PPTX/XLSX与视觉/重导入检查
- 三种输出从同一 manifest(清单) 生成并重新导入(2026-09-01 两套合成验收,之后未重新生成)。
- 已有 builder 失败回归证明生成阶段不晋升暂存文件,不证明逐文件替换失败能回滚。
- 跨 build 目录重定向被拒绝。
- 每个直接 builder 都要求 canonical binding;核对后换掉磁盘清单不影响本次生成有回归测试定义(2026-10-11 读源码确认,本轮未重跑)。
- 隔离 wheel 携带样本、schema(数据结构) 和 builder(2026-09-01 验证)。
本模块形成当前正式文件;来源一旦变化,下一模块决定哪些事实和旧 build 还能继续使用。

PRIVATE source · compiler.pycore files、quality和不可覆盖build
PRIVATE source · artifacts.py公开Office入口、核过字节的清单副本、staging与正式目录绑定
PRIVATE artifact buildersDOCX/PPTX/XLSX与视觉/重导入检查
- 三种输出从同一 manifest(清单) 生成并重新导入(2026-09-01 两套合成验收,之后未重新生成)。
- 已有 builder 失败回归证明生成阶段不晋升暂存文件,不证明逐文件替换失败能回滚。
- 跨 build 目录重定向被拒绝。
- 每个直接 builder 都要求 canonical binding;核对后换掉磁盘清单不影响本次生成有回归测试定义(2026-10-11 读源码确认,本轮未重跑)。
- 隔离 wheel 携带样本、schema(数据结构) 和 builder(2026-09-01 验证)。
本模块形成当前正式文件;来源一旦变化,下一模块决定哪些事实和旧 build 还能继续使用。
复制 AI 续作说明
项目:六个正式文件使用同一事实修订,不同构建不混用目录;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。







