Edmund — AI Systems Architect logo

博客

阶段文档系统：换模型也不丢的 AI 会话记忆

阶段文档系统 AI：Edmund Ng 受治理 Vibe Coding 与可审计 AI — 独立创始人 Harness 方法探索

发布于 更新于 6 分钟阅读

ai-architecturephase-docs

阶段文档系统 AI — Edmund Ng 旅程 Hero 插图（4:3 WebP）

阶段文档系统 AI 的价值在于：当你从 demo 速度走向生产级审查时，不能只靠英雄提示。本文是 Edmund Ng 关于 AI session memory、Harness 纪律与可审计 AI 旅程的字段笔记——写给无法承受静默回归的独立创始人与系统规则设计者。

On this page

要点

  • 阶段文档系统 AI 需要书面规则——不能只有英雄提示。
  • AI session memory 防止 demo 速度变成生产后悔。
  • spec driven AI builds 连接本 spoke 与 wider 可审计 AI 旅程。
  • 在宣称「完成」前，交叉链接 Phase 文档、Harness 复检与 Decision Log。

是什么 — AI session memory — 阶段文档系统

阶段文档系统是 Edmund Ng 面向 AI 辅助构建的文档架构。每个 Phase 覆盖一个有意义的单元，含结构化章节：目标、预读、工作项、完成标准、范围边界、验证。

与聊天日志不同，阶段文档是 版本化契约 — 记录 决定了什么、测了什么、还剩什么。

前置： Vibe Coding 完整指南 — Act 1 枢纽。

在 Act 2 架构与 Harness 旅程的 是什么 层，phase document system AI 是运营契约而非营销口号。依赖 spec driven AI builds 的团队，较不容易在 multi-axis 审查或合规追问下因 demo 速度而崩塌。Edmund Ng 的字段笔记强调：代理清扫之前必须冻结什么、权衡发生时记录什么、哪条 Harness 复检证明行为而非 UI 运气。六个月后外部审计员阅读 Decision Log 时，能否跟上链条，才是「又快又受治理」的试金石。这与本旅程 Acts 1–3 所教的结构优先、模型可换一脉相承。

马来西亚与 APAC 独立团队常较早面临专业审查。在客户演示之前就把 Phase 文档、Decision Log 与 smoke 分层外置化，比事后补救信任危机便宜得多。

为什么 — spec driven AI builds — 聊天记忆不是架构记忆

LLM 会话会忘。模型会换。团队会变。没有阶段文档：

  • 技术债隐形累积
  • 过往决策变成传说
  • 对「当前系统状态」的幻觉蔓延

阶段文档加 Decision Log（我们考虑过 A，选择 B，因为 C。）形成可审计连续性。

在 Act 2 架构与 Harness 旅程的 为什么 层，phase document system AI 是运营契约而非营销口号。依赖 AI session memory 的团队，较不容易在 multi-axis 审查或合规追问下因 demo 速度而崩塌。Edmund Ng 的字段笔记强调：代理清扫之前必须冻结什么、权衡发生时记录什么、哪条 Harness 复检证明行为而非 UI 运气。六个月后外部审计员阅读 Decision Log 时，能否跟上链条，才是「又快又受治理」的试金石。这与本旅程 Acts 1–3 所教的结构优先、模型可换一脉相承。

角色分离至关重要：构建模型可以清扫 diff，Frontier 模型应审计冻结快照。在同一聊天线程里混合两种角色，是团队失去可复现性、积累语境债务的常见路径——换 IDE 也修不好。

何时 — AI session memory — 采用阶段文档

在写功能代码前启动 Phase 0/1，当：

  • 构建跨多会话或模型
  • 多于一个代理角色触碰系统
  • 受监管或客户审查语境

仅可跳过： 明确标为可丢弃的 spike。

在 Act 2 架构与 Harness 旅程的 何时 层，phase document system AI 是运营契约而非营销口号。依赖 spec driven AI builds 的团队，较不容易在 multi-axis 审查或合规追问下因 demo 速度而崩塌。Edmund Ng 的字段笔记强调：代理清扫之前必须冻结什么、权衡发生时记录什么、哪条 Harness 复检证明行为而非 UI 运气。六个月后外部审计员阅读 Decision Log 时，能否跟上链条，才是「又快又受治理」的试金石。这与本旅程 Acts 1–3 所教的结构优先、模型可换一脉相承。

受治理的构建者把书面规则、冻结快照与 Harness 复检视为上线条件——不是 demo 变绿后的可选装饰。从非程序员的 Vibe Coding 到可审计 AI，结构比换模型更重要：当利益相关者追问你如何决策、拒绝了什么、能否导出证据链时，聊天记录救不了你。

何地 — spec driven AI builds — 栈中的阶段文档

工件角色
阶段文档工作单元契约
§22 缺口猎取附录构建前盲点清扫
Decision Log人类可读的权衡句
Dossier / 日志跨阶段冷启动汇总

公开博客只教 模式/类别 — 非内部仓库路径（分享边界）。

在 Act 2 架构与 Harness 旅程的 何地 层，phase document system AI 是运营契约而非营销口号。依赖 AI session memory 的团队，较不容易在 multi-axis 审查或合规追问下因 demo 速度而崩塌。Edmund Ng 的字段笔记强调：代理清扫之前必须冻结什么、权衡发生时记录什么、哪条 Harness 复检证明行为而非 UI 运气。六个月后外部审计员阅读 Decision Log 时，能否跟上链条，才是「又快又受治理」的试金石。这与本旅程 Acts 1–3 所教的结构优先、模型可换一脉相承。

马来西亚与 APAC 独立团队常较早面临专业审查。在客户演示之前就把 Phase 文档、Decision Log 与 smoke 分层外置化，比事后补救信任危机便宜得多。

如何 — AI session memory — 最小阶段文档仪式

  1. 目标 + 非目标 — 一屏
  2. 预读表 — 要扫的文件/文档
  3. 工作项 + 完成标准 — 二元门控
  4. §22 缺口猎取 — 并行子代理清扫；READY-FOR-BUILDER: YES/NO
  5. 实现 — 仅 YES 之后
  6. 验证 + 残留 — 收尾仪式

博客种子： 「初稿计划是草稿。协议把遗漏变成永久清单。」

下一篇：Harness 工程。

在 Act 2 架构与 Harness 旅程的 如何 层，phase document system AI 是运营契约而非营销口号。依赖 spec driven AI builds 的团队，较不容易在 multi-axis 审查或合规追问下因 demo 速度而崩塌。Edmund Ng 的字段笔记强调：代理清扫之前必须冻结什么、权衡发生时记录什么、哪条 Harness 复检证明行为而非 UI 运气。六个月后外部审计员阅读 Decision Log 时，能否跟上链条，才是「又快又受治理」的试金石。这与本旅程 Acts 1–3 所教的结构优先、模型可换一脉相承。

角色分离至关重要：构建模型可以清扫 diff，Frontier 模型应审计冻结快照。在同一聊天线程里混合两种角色，是团队失去可复现性、积累语境债务的常见路径——换 IDE 也修不好。

总结

阶段文档系统 AI 在 Edmund Ng 旅程中意味着：用 AI session memory、Harness 复检与证据友好决策交付——而非一次性提示。若尚未冻结 Phase 规格，请先读前置 spoke。继续阅读 多轴子代理审查 以沿旅程 spine 前进。智能在结构：模型会变，书面规则、Decision Log 与可审计 AI 模式应留存。

FAQ

什么是 阶段文档系统 AI？

阶段文档系统 AI 是 Edmund Ng 在旅程 spine 上对受治理 AI 交付的实用标签——可重复规则、Phase 文档、Harness 复检与证据友好日志，而非 hype。独立创始人用它换模型、换 IDE、换同事时仍保持可审计性。

如何理解 how phase documents survive model swaps？

关于 how phase documents survive model swaps：Edmund Ng 的回答是结构优先——冻结规格、分离构建者与 Frontier 角色，用 Harness 证明行为而非 demo 点击。阶段文档系统 AI 应出现在 Phase 文档、审查仪式与 Decision Log 中。

如何理解 what is a phase document system AI？

关于 what is a phase document system AI：Edmund Ng 的回答是结构优先——冻结规格、分离构建者与 Frontier 角色，用 Harness 证明行为而非 demo 点击。阶段文档系统 AI 应出现在 Phase 文档、审查仪式与 Decision Log 中。

如何理解 when should you freeze AI session specs？

关于 when should you freeze AI session specs：Edmund Ng 的回答是结构优先——冻结规格、分离构建者与 Frontier 角色，用 Harness 证明行为而非 demo 点击。阶段文档系统 AI 应出现在 Phase 文档、审查仪式与 Decision Log 中。

为什么 AI session memory 对 阶段文档系统 AI 很重要？

AI session memory 是支撑纪律，防止 阶段文档系统 AI 在自动补全「很快」时失去诚实。缺它时团队积累语境债务——正是本旅程 Harness 与可审计 AI spoke 要解决的失败模式。

关于作者

Edmund Ng — AI 系统架构师肖像

Edmund Ng — 马来西亚独立创始人、AI 系统架构师、系统规则设计者。以 Vibe Coding、Harness 工程与可审计证据链交付受治理 AI。关于 · 项目 · LinkedIn。

相关文章