提示词：架构愿景白皮书

用途：让 AI Agent 为新项目生成架构愿景白皮书 使用方式：将下方「提示词正文」复制给 Agent，填入 [] 占位符后使用

---

提示词正文

你需要为项目 [项目名] 写一份系统设计白皮书。

文档定位

• 受众：项目负责人、未来参与者、外部审计者
• 层级：架构愿景，不含实现细节，不含具体代码或命令
• 版本：从 v1.0 开始，后续审计驱动迭代
• 技术栈无关：白皮书描述「是什么、为什么」，不绑定具体语言或框架

必须包含的章节（顺序可根据项目调整）

1. 愿景与定位

• 用一句话说清楚「它是什么 / 不是什么」
• 写一个「一句实话」段落：坦诚承认当前实现与理想目标之间的差距，不粉饰
• 列出核心追求（按优先级排序）和明确「不追求」的内容
• 如果存在理论上更优但当前无法落地的路线，在此说明取舍

2. 设计原则（P1、P2… 编号）

• 每条原则一句话定义
• 新增或修订的原则标注版本（如「v1.4 新增」）
• 原则之间不允许相互矛盾，有冲突时说明优先级

3. 系统总体架构

• 用 ASCII 图呈现模块关系和信息流（不用 Mermaid 或其他外部渲染工具）
• 区分「永续底座」（数据资产和接口契约）和「前沿实验模块」（可随时重写）
• 描述主要信息流路径（至少区分：实时路径 / 异步路径）

4. 核心模块定义 每个模块需包含：

• 本体论澄清：它是什么 / 不是什么（区分「实现」和「本质」）
• 当前状态标注：✅已实现 / ⚠️需升级 / ❌待建设
• 已知局限：坦诚列出，不回避

5. 数据资产分层 按可重建性分级，至少区分：

• 规范真值层：丢失即不可恢复，必须最高保护级别
• 派生数据层：可从规范真值重建，重建成本高
• 工件层：可重新生成，但与规范真值同等备份标准

6. 治理制度 按维度（数据治理、身份治理、学习治理、行动治理等）列表：

• 各维度的机制描述
• 当前阶段是否在范围内（✅ / ❌ 推迟到后续阶段）

7. 阶段路线图

• 当前阶段：只列明确在范围内的任务，每项附验收标准
• 必须附「冷酷后移清单」：明确不属于本阶段的内容 + 推迟原因 + 目标阶段
• 后续阶段：粗粒度描述，不做承诺

8. 风险与约束 表格形式：风险 | 影响 | 缓解策略 不允许只列风险不列缓解，不允许用「未来解决」敷衍

9. 模块状态总览 表格：模块 | 当前状态 | 本阶段目标 | 层级（永续底座 / 前沿器官）

10. 附录

• 版本演化记录（版本 | 日期 | 关键变化）
• 引用文档清单
• 如有外部审计：对审计意见的回应摘要（接受 / 不接受 + 原因）

写作风格要求

• 对理论上更优但工程上不可落地的方案：承认其优越性，说明为何当前不采用，不用「未来会更好」掩盖当前局限
• 区分「系统能做什么」和「系统是什么」，不混用本体论层级
• 每个架构决策后面跟「为什么」，不只写「是什么」
• 新创术语在首次出现时给出定义
• 用「⚠️」标注存在争议或已知不足的地方
• 语气：坦诚、清醒、有主张，不写宣传稿

禁止

• 禁止将「派生数据」描述为「规范真值」
• 禁止只写愿景不写约束
• 禁止绑定具体技术栈（语言、框架、云服务商）——白皮书应在换技术栈后仍然成立
• 禁止在白皮书中写代码、DDL、命令行指令——这些属于工程规范
• 禁止用「尽量」「尽可能」等模糊表达描述架构约束