diff --git a/i18n/zh/documents/00-基础指南/血的教训.md b/i18n/zh/documents/00-基础指南/血的教训.md new file mode 100644 index 0000000..7370517 --- /dev/null +++ b/i18n/zh/documents/00-基础指南/血的教训.md @@ -0,0 +1,7 @@ +# 血的教训 + +## 执行之前 + +> 关于闭门造车后发现有更好的开源方案的教训 + +10分开发，7分找资料，开发之前一定一定一定要先找全部需要的资料和 ai 充分讨论对齐，时刻谨记主要次要的几个探问维度，是什么？为什么？怎么做？是最合适/优秀的方案吗？工具：perplexity \ No newline at end of file diff --git a/i18n/zh/prompts/02-编程提示词/项目上下文文档生成.md b/i18n/zh/prompts/02-编程提示词/项目上下文文档生成.md index fac4010..c577a1d 100644 --- a/i18n/zh/prompts/02-编程提示词/项目上下文文档生成.md +++ b/i18n/zh/prompts/02-编程提示词/项目上下文文档生成.md @@ -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 适用于以下情况： - -- 长对话或复杂项目已积累大量上下文 -- 需要“一键导出”当前项目的完整认知状态 -- 需要在新会话中无损迁移上下文 -- 需要将对话内容工程化、文档化、系统化 - -你需要处理的是：本次对话的完整上下文 \ No newline at end of file +# 📘 项目上下文文档生成 · 工程化 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 适用于以下情况：- 长对话或复杂项目已积累大量上下文 - 需要“一键导出”当前项目的完整认知状态 - 需要在新会话中无损迁移上下文 - 需要将对话内容工程化、文档化、系统化 你需要处理的是：本次对话的完整上下文 \ No newline at end of file