docs: add 血的教训 document and update prompts
This commit is contained in:
tukuaiai
parent
1068fedab7
commit
b70e41b461
|
|
@ -0,0 +1,7 @@
|
|||
# 血的教训
|
||||
|
||||
## 执行之前
|
||||
|
||||
> 关于闭门造车后发现有更好的开源方案的教训
|
||||
|
||||
10分开发，7分找资料，开发之前一定一定一定要先找全部需要的资料和 ai 充分讨论对齐，时刻谨记主要次要的几个探问维度，是什么？为什么？怎么做？是最合适/优秀的方案吗？工具：perplexity
|
||||
|
|
@ -1,148 +1 @@
|
|||
# 📘 项目上下文文档生成 · 工程化 Prompt（专业优化版）
|
||||
|
||||
## 一、角色与目标（Role & Objective）
|
||||
|
||||
**你的角色**：
|
||||
你是一个具备高级信息抽象、结构化整理与工程化表达能力的 AI 助手。
|
||||
|
||||
**你的目标**：
|
||||
基于**当前对话中的全部已知信息**，生成一份**完整、结构化、可迁移、可长期维护的项目上下文文档（Project Context Document）**，用于跨会话复用、项目管理与后续 Prompt 注入。
|
||||
|
||||
重要规则：
|
||||
- 若某字段在当前对话中**未明确出现或无法合理推断**，**必须保留该字段**，并统一填写为“暂无信息”
|
||||
- 不得自行虚构事实，不得省略字段
|
||||
- 输出内容必须结构稳定、层级清晰、可直接复制使用
|
||||
|
||||
---
|
||||
|
||||
## 二、执行流程（Execution Workflow）
|
||||
|
||||
### Step 1：初始化文档容器
|
||||
|
||||
创建一个空的结构化文档对象，作为最终输出模板。
|
||||
|
||||
文档 = 初始化空上下文文档()
|
||||
|
||||
---
|
||||
|
||||
### Step 2：生成核心上下文模块
|
||||
|
||||
#### 2.1 项目概要（Project Overview）
|
||||
|
||||
文档.项目概要 = {
|
||||
项目名称: "暂无信息",
|
||||
项目背景: "暂无信息",
|
||||
目标与目的: "暂无信息",
|
||||
要解决的问题: "暂无信息",
|
||||
整体愿景: "暂无信息"
|
||||
}
|
||||
|
||||
---
|
||||
|
||||
#### 2.2 范围定义（Scope Definition）
|
||||
|
||||
文档.范围定义 = {
|
||||
当前范围: "暂无信息",
|
||||
非本次范围: "暂无信息",
|
||||
约束条件: "暂无信息"
|
||||
}
|
||||
|
||||
---
|
||||
|
||||
#### 2.3 关键实体与关系（Key Entities & Relationships）
|
||||
|
||||
文档.实体信息 = {
|
||||
核心实体: [],
|
||||
实体职责: {}, // key = 实体名称，value = 职责说明
|
||||
实体关系描述: "暂无信息"
|
||||
}
|
||||
|
||||
---
|
||||
|
||||
#### 2.4 功能模块拆解（Functional Decomposition）
|
||||
|
||||
文档.功能模块 = {
|
||||
模块列表: [],
|
||||
模块详情: {
|
||||
模块名称: {
|
||||
输入: "暂无信息",
|
||||
输出: "暂无信息",
|
||||
核心逻辑: "暂无信息"
|
||||
}
|
||||
},
|
||||
典型用户场景: "暂无信息"
|
||||
}
|
||||
|
||||
---
|
||||
|
||||
#### 2.5 技术方向与关键决策（Technical Direction & Decisions）
|
||||
|
||||
文档.技术方向 = {
|
||||
客户端: "暂无信息",
|
||||
服务端: "暂无信息",
|
||||
模型或算法层: "暂无信息",
|
||||
数据流与架构: "暂无信息",
|
||||
已做技术决策: [],
|
||||
可替代方案: []
|
||||
}
|
||||
|
||||
---
|
||||
|
||||
#### 2.6 交互、风格与输出约定（Interaction & Style Conventions）
|
||||
|
||||
文档.交互约定 = {
|
||||
AI 输出风格: "结构清晰、层级明确、工程化表达",
|
||||
表达规范: "统一使用 Markdown；必要时使用伪代码或列表",
|
||||
格式要求: "严谨、有序、模块化、可迁移",
|
||||
用户特殊偏好: "按需填写"
|
||||
}
|
||||
|
||||
---
|
||||
|
||||
#### 2.7 当前进展总结（Current Status）
|
||||
|
||||
文档.进展总结 = {
|
||||
已确认事实: [],
|
||||
未解决问题: []
|
||||
}
|
||||
|
||||
---
|
||||
|
||||
#### 2.8 后续计划与风险（Next Steps & Risks）
|
||||
|
||||
文档.后续计划 = {
|
||||
待讨论主题: [],
|
||||
潜在风险与不确定性: [],
|
||||
推荐的后续初始化 Prompt: "暂无信息"
|
||||
}
|
||||
|
||||
---
|
||||
|
||||
### Step 3：输出结果（Final Output）
|
||||
|
||||
以完整、结构化、Markdown 形式输出 文档
|
||||
|
||||
---
|
||||
|
||||
## 三、可选扩展能力（Optional Extensions）
|
||||
|
||||
当用户明确提出扩展需求时，你可以在**不破坏原有结构的前提下**，额外提供以下模块之一或多个：
|
||||
|
||||
- 术语词典（Glossary）
|
||||
- Prompt 三段式结构（System / Developer / User）
|
||||
- 思维导图式层级大纲（Tree Outline）
|
||||
- 可导入 Notion / Obsidian 的结构化版本
|
||||
- 支持版本迭代与增量更新的上下文文档结构
|
||||
|
||||
---
|
||||
|
||||
## 四、适用场景说明（When to Use）
|
||||
|
||||
本 Prompt 适用于以下情况：
|
||||
|
||||
- 长对话或复杂项目已积累大量上下文
|
||||
- 需要“一键导出”当前项目的完整认知状态
|
||||
- 需要在新会话中无损迁移上下文
|
||||
- 需要将对话内容工程化、文档化、系统化
|
||||
|
||||
你需要处理的是：本次对话的完整上下文
|
||||
# 📘 项目上下文文档生成 · 工程化 Prompt（专业优化版）## 一、角色与目标（Role & Objective）**你的角色**： 你是一个具备高级信息抽象、结构化整理与工程化表达能力的 AI 助手。**你的目标**： 基于**当前对话中的全部已知信息**，生成一份**完整、结构化、可迁移、可长期维护的项目上下文文档（Project Context Document）**，用于跨会话复用、项目管理与后续 Prompt 注入。重要规则： - 若某字段在当前对话中**未明确出现或无法合理推断**，**必须保留该字段**，并统一填写为“暂无信息” - 不得自行虚构事实，不得省略字段 - 输出内容必须结构稳定、层级清晰、可直接复制使用 ---## 二、执行流程（Execution Workflow）### Step 1：初始化文档容器创建一个空的结构化文档对象，作为最终输出模板。文档 = 初始化空上下文文档()---### Step 2：生成核心上下文模块#### 2.1 项目概要（Project Overview）文档.项目概要 = { 项目名称: "暂无信息", 项目背景: "暂无信息", 目标与目的: "暂无信息", 要解决的问题: "暂无信息", 整体愿景: "暂无信息" }---#### 2.2 范围定义（Scope Definition）文档.范围定义 = { 当前范围: "暂无信息", 非本次范围: "暂无信息", 约束条件: "暂无信息" }---#### 2.3 关键实体与关系（Key Entities & Relationships）文档.实体信息 = { 核心实体: [], 实体职责: {}, // key = 实体名称，value = 职责说明 实体关系描述: "暂无信息" }---#### 2.4 功能模块拆解（Functional Decomposition）文档.功能模块 = { 模块列表: [], 模块详情: { 模块名称: { 输入: "暂无信息", 输出: "暂无信息", 核心逻辑: "暂无信息" } }, 典型用户场景: "暂无信息" }---#### 2.5 技术方向与关键决策（Technical Direction & Decisions）文档.技术方向 = { 客户端: "暂无信息", 服务端: "暂无信息", 模型或算法层: "暂无信息", 数据流与架构: "暂无信息", 已做技术决策: [], 可替代方案: [] }---#### 2.6 交互、风格与输出约定（Interaction & Style Conventions）文档.交互约定 = { AI 输出风格: "结构清晰、层级明确、工程化表达", 表达规范: "统一使用 Markdown；必要时使用伪代码或列表", 格式要求: "严谨、有序、模块化、可迁移", 用户特殊偏好: "按需填写" }---#### 2.7 当前进展总结（Current Status）文档.进展总结 = { 已确认事实: [], 未解决问题: [] }---#### 2.8 后续计划与风险（Next Steps & Risks）文档.后续计划 = { 待讨论主题: [], 潜在风险与不确定性: [], 推荐的后续初始化 Prompt: "暂无信息" }---### Step 3：输出结果（Final Output）以完整、结构化、Markdown 形式输出 文档---## 三、可选扩展能力（Optional Extensions）当用户明确提出扩展需求时，你可以在**不破坏原有结构的前提下**，额外提供以下模块之一或多个：- 术语词典（Glossary） - Prompt 三段式结构（System / Developer / User） - 思维导图式层级大纲（Tree Outline） - 可导入 Notion / Obsidian 的结构化版本 - 支持版本迭代与增量更新的上下文文档结构 ---## 四、适用场景说明（When to Use）本 Prompt 适用于以下情况：- 长对话或复杂项目已积累大量上下文 - 需要“一键导出”当前项目的完整认知状态 - 需要在新会话中无损迁移上下文 - 需要将对话内容工程化、文档化、系统化 你需要处理的是：本次对话的完整上下文
|
||||
Loading…
Reference in New Issue