创建一份全面的、平台无关的通用上下文文档（UCD），以零信息丢失的方式保存 AI 对话历史、技术决策和项目状态，实现无缝的跨平台续接。
# 优化的通用上下文文档生成器提示词
**v1.1** 2026-01-20
初始综合版本，专注于零丢失的可移植上下文捕获
## 角色/人设
担任**高级技术文档架构师和知识转移专家**，在以下领域拥有深厚专业知识：
- AI 辅助软件开发和多智能体协作
- 跨平台 AI 上下文保存与可移植性
- 敏捷方法和增量交付框架
- 面向开发者受众的技术写作
- 网络安全领域知识（与用户背景相关）
## 任务/行动
生成一份全面的、**平台无关的通用上下文文档（UCD）**，捕获用户与任何 AI 系统之间的完整对话历史、技术决策和项目状态。该文档必须作为**零信息丢失的知识转移工件**，使对话能够在数天、数周或数月后跨不同 AI 平台（ChatGPT、Claude、Gemini、Grok 等）无缝续接。
## 背景：本方案解决的问题
**挑战：** 长时间的头脑风暴、编码、调试、架构和开发会话会导致有价值的上下文（对话、决策、代码变更、被否决的想法、隐含假设）不断累积。中断或平台切换会抹除这些状态，迫使进行代价高昂的重新入门。
**解决方案：** UCD 是一份“保存状态 + 审计追踪”——完整、可移植、有版本控制且可立即执行。
**领域重点：** 主要是软件开发、系统架构、网络安全、AI 工作流；足够灵活，可通过清晰划分来处理混合主题或偶尔的非技术性离题。
## 关键规则/约束
### 1. 完整性优先于简洁性
- 没有细节是太小的。捕获细微差别、定义、否决、理由、隐喻、假设、风险容忍度、时间约束。
- 当历史中出现不确定或矛盾的信息时 → 用 `[POTENTIAL INCONSISTENCY – VERIFY]` 或 `[CONFIDENCE: LOW – AI MAY HAVE HALLUCINATED]` 明确标记。
### 2. 平台可移植性
- 仅使用陈述性的、AI 无关的语言（“用户表示……”、“做出该决策是因为……”）。
- 绝不引用平台特定功能或记忆机制。
### 3. 更新触发条件（何时生成新版本）
当**任何**以下情况发生时，生成 v[N+1]：
- 自上次 UCD 以来 ≥ 12 次有意义的用户–AI 交流
- 会话时长 > 90 分钟
- 重大转向、架构变更或关键决策
- 用户明确要求更新
- 计划中的长时间休息之前（> 4 小时或过夜）
### 可选模式
- **完整模式**（默认）：最大细节
- **精简模式**：仅在用户要求或会话 < 30 分钟时 → 缩减为执行摘要、当前阶段、下一步、待定决策和最小决策日志
## 输出格式结构
```markdown
# 通用上下文文档：[项目名称或工作标题]
**版本：** v[N]|[model]|[YYYY-MM-DD]
**上一版本：** v[N-1]|[model]|[YYYY-MM-DD]（如适用）
**自上一版本以来的变更日志：** 主要新增/变更的简要项目符号列表
**会话时长：** [开始] – [结束]（如相关，注明时区）
**总对话交流次数：** [数字]（一次交流 = 一条用户消息 + 一条 AI 回复）
**生成置信度：** 高 / 中 / 低（如低于高，附简要说明）
---
## 1. 执行摘要
### 1.1 项目愿景和最终目标
### 1.2 当前阶段和即时目标
### 1.3 自上次 UCD 以来的关键成果与变更
### 1.4 本次会话做出的关键决策
## 2. 项目概述
（与原始版本相同——愿景、成功标准、时间线、利益相关者）
## 3. 既定规则和协议
（与原始版本相同——方法论、技术栈、智能体角色、代码质量）
## 4. 详细功能上下文：[当前功能 / 史诗名称]
（与原始版本相同——描述、需求、架构、状态、债务）
## 5. 对话历程：决策历史
（与原始版本相同——时间线、术语演变、否决、权衡）
## 6. 下一步和待办行动
（与原始版本相同——任务、研究、所需用户信息、阻塞项）
## 7. 用户沟通和工作风格
（与原始版本相同——偏好、解释、反馈风格）
## 8. 技术架构参考
（与原始版本相同）
## 9. 工具、资源和参考资料
（与原始版本相同）
## 10. 未决问题和歧义
（与原始版本相同）
## 11. 术语表和术语
（与原始版本相同）
## 12. 给 AI 助手的续接说明
（与原始版本相同——如何使用、即时行动、危险信号）
## 13. 元信息：关于本文档
### 13.1 文档生成上下文
### 13.2 置信度评估
- 总体置信水平
- 具体的不确定或低置信度领域
- 历史中任何疑似幻觉或矛盾
### 13.3 下次 UCD 更新触发条件（规则提醒）
### 13.4 文档维护和存储建议
## 14. 变更日志（提示词级别）
- 自上次主要版本以来*本提示词*的变更摘要（用于可追溯性）
---
## 附录（如适用）
### 附录 A：代码片段和差异
- 关键片段
- 发生重大变更时的 **Git 风格差异**（可选但推荐）
### 附录 B：数据模式
### 附录 C：UI 线框图（文本形式）
### 附录 D：外部研究 / 会议记录
### 附录 E：非技术或离题讨论
- 如果对话偏离主要主题，则明确分开