product-playbook 1.0.0

package/i18n/zh-CN/references/rules-build.md

@@ -0,0 +1,152 @@
+# ⚡ 直接实作模式步骤序列（共 7 步 + 最终产出）
+
+> 此文件为直接实作模式的权威步骤定义。由 SKILL.md 核心派发载入。
+
+> ⚠️ 必须提醒：「跳过用户研究阶段，代表解法建立在假设上。建议执行后尽快进行 Continuous Discovery 验证。」
+
+## 步骤序列
+
+```
+S1. 确认问题陈述（一句话）
+S2. PR-FAQ → 读取 references/04a-prfaq.md
+S3. 平行解法 → 读取 references/04b-solutions.md → 3.2
+S4. Pre-mortem → 读取 references/04b-solutions.md → 3.3
+S5. GEM + RICE 优先排序 → 读取 references/04b-solutions.md → 3.4 + 3.5
+S6. MVP + Not Doing List → 读取 references/04c-mvp.md
+S7. North Star + Aha Moment → 读取 references/05a-northstar-aha.md
+────
+最终产出 → 工程师导向执行摘要
+```
+
+## Reference 载入指示
+
+| 步骤 | Reference 文件 |
+|------|---------------|
+| S1 | 无需外部 reference（直接引导使用者陈述问题） |
+| S2 | `references/04a-prfaq.md` |
+| S3-S5 | `references/04b-solutions.md` |
+| S6 | `references/04c-mvp.md` |
+| S7 | `references/05a-northstar-aha.md` |
+
+## 最终产出格式
+
+**工程师导向的执行摘要**：解法决策 → MVP 边界 → 成功指标 → 主要风险
+
+完成后，依 `references/rules-end-of-flow.md` 执行流程结束规则。
+
+---
+
+## 🔧 功能扩充快速路径（4 步）
+
+> 当侦测到使用者是在**既有产品上新增单一功能**时，自动切换到此路径。
+> 触发条件：使用者描述中包含「加一个功能」「新增功能」「加入 XX 功能」「在现有系统上」「既有产品要加」等语句。
+
+**与完整直接实作模式（7 步）的差异**：既有产品已有 North Star、Aha Moment、产品定位，不需要重新定义。单一功能不需要 PR-FAQ 新闻稿、GEM+RICE 全面重新排序。聚焦在「加什么、怎么加、会不会搞坏现有的东西」。
+
+### 功能扩充步骤序列
+
+```
+S1. 问题 + 既有系统上下文
+S2. 三平行解法 + 优缺点 + AI 推荐 → 读取 references/04b-solutions.md → 3.2
+S3. 风险评估（回归 + 相容性）→ 读取 references/04b-solutions.md → 3.3
+S4. 执行范围（做什么 / 不动什么 / 验收标准）→ 读取 references/04c-mvp.md
+────
+最终产出 → 功能开发规格
+```
+
+### S1 前置：产品上下文载入
+
+进入 S1 前，读取 `references/rules-context.md` 并检查 `.product-context.md`：
+
+- **有完整上下文（情境 1）**：自动带入产品名称、技术栈、主要模组、近 3 笔 Decision History。S1 引导改为**确认式**：「你的产品是 [名称]，使用 [技术栈]，主要模组包括 [模组清单]。这次要新增的功能是什么？会影响哪些模组？」（问题 2 和部分问题 3 已预填，只需确认）
+- **无上下文（情境 2）**：触发 Context Bootstrap（`rules-context.md` Section 4），完成后再进入下方标准 S1
+- **部分上下文（情境 3）**：带入已知的技术栈和模组（从 Decision History 合并），缺失部分仍需收集。例如：「除了 [已知模组]，还有其他会被影响的模组吗？」
+
+### S1 引导内容（问题 + 既有系统上下文）
+
+Claude 需收集以下资讯（逐步引导，不要一次丢出所有问题。若 context 已预填部分答案，改为确认而非重新收集）：
+
+```
+1. 要新增什么功能？解决什么问题？
+2. 目前的产品架构概况（技术栈、主要模组）← context 可预填
+3. 这个功能会影响哪些现有模组？← context 可部分预填
+4. 有没有相关的用户反馈或数据支持这个需求？
+```
+
+### S2 引导内容（三平行解法 + AI 推荐）
+
+```
+| HMW | 解法 A（保守/最小改动） | 解法 B（平衡） | 解法 C（大胆/重构） |
+|-----|----------------------|--------------|-------------------|
+| [问题] | | | |
+
+| 解法 | 优点 | 缺点 | 影响范围 | 实作复杂度 |
+|------|------|------|---------|-----------|
+| A | | | | |
+| B | | | | |
+| C | | | | |
+
+🤖 AI 推荐：解法 [X]
+推荐理由：[基于影响范围、复杂度、风险的综合判断]
+```
+
+### S3 引导内容（风险评估 — 聚焦回归与相容性）
+
+```
+| 风险类型 | 具体风险 | 发生可能性 | 预防措施 |
+|---------|---------|-----------|---------|
+| 回归风险 | [现有功能可能被影响的地方] | | |
+| 相容性风险 | [与现有架构/数据/API 的冲突] | | |
+| 效能风险 | [新功能对系统效能的影响] | | |
+| 安全性风险 | [新功能引入的安全性考量] | | |
+```
+
+### S4 引导内容（执行范围）
+
+```
+**做什么（Scope）**：
+- [具体要新增的功能项目]
+- [需要修改的现有模组]
+
+**不动什么（Do Not Touch）**：
+- [明确不修改的模组和功能]
+- [不动的原因]
+
+**验收标准**：
+- [ ] [可测试的具体条件]
+- [ ] [回归测试：确认现有功能不受影响]
+```
+
+### 功能扩充最终产出格式
+
+**功能开发规格**：问题陈述 → 选定解法 + 理由 → 影响范围 → 执行范围 + 验收标准 → 风险清单
+
+### 增量文档产出（当有源文档时）
+
+如果用户在流程中上传了源文档（PRD、规格书等）：
+
+1. **增量版本**（有源文档时为默认）：
+   - 在原始文档结构中插入/修改章节
+   - 保持原始文件的格式、风格和命名规范
+   - 新增内容标记为 `[NEW]`
+   - 修改内容标记为 `[UPDATED]`，并保留原始内容作为参考
+   - 与新功能无关的章节完全不动
+
+2. **独立版本**（无源文档时）：
+   - 使用标准的功能开发规格格式（如上方定义）
+
+3. **产出前先询问用户**：
+   「我检测到你上传了一份 [文档类型]。你希望产出方式是？
+    A) 在原始文档上增量更新（推荐）
+    B) 独立的功能开发规格」
+
+### Reference 载入指示
+
+| 步骤 | Reference 文件 |
+|------|---------------|
+| S1 | 无需外部 reference |
+| S2 | `references/04b-solutions.md` → 3.2 |
+| S3 | `references/04b-solutions.md` → 3.3 |
+| S4 | `references/04c-mvp.md` |
+
+完成后，依 `references/rules-end-of-flow.md` 执行流程结束规则。

package/i18n/zh-CN/references/rules-change-propagation.md

@@ -0,0 +1,74 @@
+# 🔄 变更传播规则（Change Propagation）
+
+> 当使用者修改已完成步骤时载入。
+
+## 📍 进度指示器（每个步骤都必须显示）
+
+在执行任何步骤时，Claude 必须在回应的最开头显示进度列，格式：
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📍 [执行模式] ｜ 进度 S[目前步骤编号] / S[总步骤数]
+✅ S1：[步骤名称]（已完成）
+✅ S2：[步骤名称]（已完成）
+▶️ S3：[步骤名称]（进行中）
+⬜ S4：[步骤名称]（待执行）
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+此进度指示器在以下情况都必须出现：
+- 每进入一个新步骤
+- 使用者回到某个步骤进行修改时
+- 完成某个步骤、询问使用者确认后进入下一步时
+
+## 触发方式
+- 「回到 Persona」「回到 JTBD」「回到 HMW」「回到 PR-FAQ」等任意步骤名称
+- 「我想修改一下 [步骤名]」「[步骤名] 的部分我想改」
+- 直接对某个已产出的表格或内容说「这里改成...」
+
+## 修改后的必要动作
+
+当任何步骤被修改，Claude **必须主动执行以下检查**：
+
+```
+修改层级               受影响的下游（必须重新确认或更新）
+─────────────────────────────────────────────────────
+Persona / JTBD        → HMW、机会评估表、Positioning、PR-FAQ、North Star、产品规格摘要
+HMW / 机会评估        → PR-FAQ、平行解法、MVP、North Star、产品规格摘要
+Positioning           → PR-FAQ、产品规格摘要
+PR-FAQ / 解法         → Pre-mortem、GEM/RICE、MVP、Aha Moment、产品规格摘要
+MVP / Not Doing List  → User Story、DB schema（若已产出）、产品规格摘要
+North Star / 指标     → 假设验证计划、产品规格摘要
+产品规格摘要           → HTML 报告、PRD（若已产出）
+```
+
+### 功能扩充依赖关系：
+```
+功能扩充依赖关系：
+─────────────────────────────────────────────────────
+S1（问题 + 情境）     → S2（解法）、S3（风险）、S4（执行范围）
+S2（选定解法）        → S3（风险）、S4（执行范围）
+S3（风险评估）        → S4（执行范围）
+```
+
+## 执行方式
+
+1. **告知使用者影响范围**：「你修改了 [步骤]，这会影响到 [下游步骤清单]，我会逐一更新。」
+2. **逐一确认或自动更新下游**：
+   - 若下游改动小（措辞调整）→ 直接更新，说明改了什么
+   - 若下游改动大（方向转变）→ 提示使用者确认新方向再更新
+3. **最终重新整合产品规格摘要**
+4. **若已产出 HTML 报告或 PRD**：直接重新产出，并输出版本快照：
+
+```
+📋 版本快照 v[旧版号] → v[新版号]
+修改的步骤：[步骤名称]
+修改前的关键内容：[1-3 句话]
+修改后的关键内容：[1-3 句话]
+连带更新的下游：[哪些步骤被一并调整]
+```
+
+## 原则
+- 任何修改都不会静默发生——必须明确告知影响范围
+- 使用者有权选择「只改这一步，下游暂时不动」，Claude 需标记哪些部分已过时（加上 ⚠️ 待更新 标记）
+- 修改历史在对话中保持可追溯

package/i18n/zh-CN/references/rules-commands.md

@@ -0,0 +1,98 @@
+# 🔧 框架选单 + 补充指令
+
+> 当使用者要求「列出框架」「给我看有哪些框架」或使用补充指令时载入。
+
+## 指定框架
+
+**触发方式有两种：**
+
+**方式 A（使用者直接说框架名称）：** 直接进入该框架引导流程，不需要再问。
+
+**方式 B（使用者说「我想指定框架」「列出所有框架」等）：** 呈现以下选单：
+
+```
+📚 可指定的框架清单，请填写编号或名称：
+
+【理解用户】
+ 1. JTBD（Jobs to Be Done）— 找出用户真正想完成的工作
+ 2. Persona — 建立用途/任务/动机导向的用户角色
+ 3. User Journey Map — 绘制用户完整体验旅程
+ 4. Continuous Discovery — 建立每周接触用户的持续习惯
+
+【定义问题】
+ 5. OST / 机会解法树 — 系统化链接机会与解法
+ 6. Positioning / April Dunford — 找出真正的竞争场域和差异化
+ 7. HMW — 将痛点转化为设计问题
+
+【解法设计】
+ 8. Working Backwards / PR-FAQ — 从用户结果出发倒推解法
+ 9. Pre-mortem / 事前验尸 — 在失败前预测并预防失败
+10. GEM — Growth / Engagement / Monetization 三维优先排序
+11. RICE — 量化功能优先排序
+12. MVP — 定义最小可行产品范围
+
+【策略层】
+13. Strategy / Strategy Blocks — Mission → Vision → Strategy 层级结构
+14. DHM Model — Delight / Hard to copy / Margin-enhancing 机会检验
+15. LNO Framework — Leverage / Neutral / Overhead 时间分配
+16. Empowered Teams — 赋能型团队 vs 功能型团队
+
+【衡量层】
+17. North Star / 北极星指标 — 定义代表核心用户价值的单一指标
+18. PMF — 判断产品市场契合度的四个等级
+19. Sean Ellis Score — 量化 PMF 热情程度
+
+【商业层】
+20. 商业模式与定价 — 收费模式选择与价值定价对齐
+21. GTM 策略 — Go-to-Market 上市与获客策略
+
+【开发衔接】
+22. Dev Handoff / 开发交接包 — 产出 CLAUDE.md + TASKS.md + TICKETS.md，衔接 Claude Code 开发
+
+请输入框架编号或名称（可多选，用逗号分隔）：
+```
+
+## 跳过 Discovery / 直接进实作
+
+当使用者说「跳过用户研究」「问题已知」「直接进到 Develop」时，读取 `references/rules-build.md` 并依照直接实作模式步骤序列执行。
+
+> 提醒使用者：「跳过用户研究阶段，代表解法建立在假设上。建议执行后尽快进行 Continuous Discovery 验证。」
+
+## 功能扩充模式触发
+
+- 「新增功能」/「我要在现有产品加一个功能」/「加新功能」→ 触发功能扩充模式（读取 `references/rules-build.md` → 功能扩充快速路径）
+
+## 补充指令
+
+| 指令 | 行为 |
+|------|------|
+| `「切换到 [框架]」` | 立即切换，保留已完成内容 |
+| `「我想改变目标对象」` | 重新调整框架优先序和呈现方式 |
+| `「跳过这个步骤」` | 提醒必要性后尊重决定，进入下一步 |
+| `「回到 [步骤/框架名称]」` | 回到指定的任意步骤重新引导（见 `references/rules-change-propagation.md`） |
+| `「帮我简化」` / `「帮我展开」` | 浓缩核心要点 / 深入补充分析 |
+| `「产出报告」` | 读取 `references/06-html-report.md`，产出 HTML 企划报告 |
+| `「产出 PRD」` / `「产出给工程师的文件」` | 读取 `references/04b-solutions.md`，整合 PR-FAQ + MVP + User Story + Pre-mortem，**自动一并产出：流程图（Mermaid）+ DB schema（Mermaid ERD）+ UI wireframe（HTML）** |
+| `「产出流程图」` / `「帮我画流程图」` | 以 Mermaid 语法产出流程图（单独触发） |
+| `「产出 DB schema」` / `「帮我设计数据库」` | 产出 DB schema（Mermaid ERD 语法）（单独触发） |
+| `「产出 UI wireframe」` / `「帮我画线框图」` | 以 HTML/SVG 产出低保真 UI 线框图（单独触发） |
+| `「产出简报」` / `「帮我做成 PPT」` | 呼叫系统 pptx skill |
+| `「把文件调整成给 [对象] 看的版本」` | 重新编排框架重点和呈现语言 |
+| `「我只有 15 分钟」` | 给出最关键的三个决策问题或行动 |
+| `「帮我做完整性评估」` | 评估哪些环节完整、哪些有风险 |
+| `「帮我找出假设」` | 识别所有尚未验证的核心假设清单 |
+| `「做一次 Pre-mortem」` | 对任何解法立即进行事前验尸 |
+| `「产出给不同对象的版本」` | 自动产出多个对象版本的摘要 |
+| `「这个产品在 PMF 哪个等级？」` | 判断 PMF 等级并说明下一步里程碑 |
+| `「帮我找出瓶颈」` | 分析最影响 Aha Moment 到达率的障碍 |
+| `「我要改版，不是新产品」` | 切换改版模式（读取 `references/rules-revision.md`） |
+| `「我要说服老板批准」` | 切换老板模式，突出商业价值和资源逻辑 |
+| `「进入开发」` / `「产出开发交接包」` | 读取 `references/07a-handoff-core.md`，确认技术栈后产出完整开发交接包 |
+| `「帮我建专案」` / `「接到 Claude Code」` | 同上 |
+| `「暂停」` / `「存档」` / `「先做别的」` | 依 `references/rules-progress.md` 存档 |
+| `「继续」` / `「回到企划」` | 依 `references/rules-progress.md` 恢复 |
+| `「清除进度」` / `「重新开始」` | 删除进度文件，从头开始 |
+| `/export [format]` | 导出为指定格式。format = `pdf` / `docx` / `pptx` / `html` / `md`。读取 `references/rules-export-document.md`，首次使用时先载入 `references/rules-document-tools.md` 检查工具。 |
+| `/parse [file]` | 解析上传的文件为 Markdown。支持 PDF / DOCX / PPTX / 图片。读取 `references/rules-import-document.md`，首次使用时先载入 `references/rules-document-tools.md` 检查工具。 |
+
+**上下文相关指令提示**：每个步骤完成时，根据当前进度主动提示 2-3 个最相关的可用指令。

package/i18n/zh-CN/references/rules-context.md

@@ -0,0 +1,291 @@
+# 📦 产品上下文累积规则
+
+> 此文件定义 `.product-context.md` 的格式、读写规则、情境处理和冲突解决。
+> 由 SKILL.md 启动流程触发载入，或由各模式 S1 前置步骤载入。
+
+## 1. 文件位置与生命周期
+
+- **路径**：专案根目录下的 `.product-context.md`（与 `.product-playbook-progress.md` 同层）
+- **永久保留**：此文件在流程结束后**不会被删除**，跨 session 持续累积
+- **首次建立时**提醒使用者：「⚠️ 建议将 `.product-context.md` 加入 `.gitignore`，此文件可能包含敏感的产品策略资讯。」
+
+---
+
+## 2. 文件格式
+
+```markdown
+# Product Context
+<!-- Auto-maintained by product-playbook. Do not delete. -->
+<!-- last-updated: [ISO timestamp] -->
+
+## Identity
+- **Product name**: [name]
+- **Product type**: [B2C / B2B / B2B2C / Internal tool]
+- **One-liner**: [一句话描述]
+- **Target audience**: [主要 Persona 摘要]
+
+## Core Strategy
+- **Core JTBD**: [Target Customer] + wants to [Job] + in [Context]
+  - Functional: [...]
+  - Emotional: [...]
+  - Social: [...]
+- **Positioning (April Dunford)**:
+  - Real competitive alternatives: [...]
+  - Unique attributes: [...]
+  - Core value: [...]
+  - Target market: [...]
+  - Market category: [...]
+- **North Star Metric**: [指标名 + 定义]
+- **Aha Moment**: [描述]
+
+## Architecture & Tech Stack
+- **Tech stack**: [语言、框架、基础设施]
+- **Key modules**: [主要模组清单]
+- **Data model highlights**: [核心数据实体，若已知]
+
+## Decision History
+<!-- Append-only. 每次完成流程追加一笔。 -->
+
+### [ISO date] - [流程类型: Full/Quick/Revision/Feature Extension/Custom/Build]
+- **Scope**: [规划/变更范围]
+- **Key decisions**: [重大决策]
+- **Risks identified**: [风险]
+- **MVP boundary**: [做什么 / 不做什么]
+- **Success metrics**: [成功指标 + 目标值]
+
+## Language Preference
+- **Installed language**: [从 .lang 文件自动侦测或使用者的语系]
+- **User's preferred language**: [使用者沟通时使用的语言]
+
+## Accumulated Insights
+- **Known pain points**: [痛点清单，附来源]
+- **User feedback themes**: [跨 session 的反馈主题]
+- **PMF status**: [最近评估等级 + 日期]
+- **Security posture**: [认证/授权方式、已知漏洞]
+- **Technical debt**: [跨 session 累积的技术债]
+```
+
+---
+
+## 3. 三种情境侦测
+
+启动时（进度文件检查之后、模式选择之前），侦测 `.product-context.md` 状态：
+
+| 条件 | 情境 | 动作 |
+|------|------|------|
+| 文件存在，`Core Strategy` section 有实际内容（非空/非 placeholder） | **情境 1：完整上下文** | 静默载入。显示：「📦 侦测到 **[产品名]** 的产品上下文，将作为本次规划的基线。」 |
+| 文件不存在 | **情境 2：无上下文** | 记录此状态。进入功能扩充或改版模式时触发 Context Bootstrap（见 Section 4） |
+| 文件存在，`Core Strategy` 空白或仅有 placeholder，但 `Decision History` 有至少一笔纪录 | **情境 3：部分上下文** | 显示已知资讯摘要，提供补充选项（见 Section 5） |
+
+**侦测逻辑**：
+1. 文件是否存在？
+2. `Identity` section 是否有 Product name（非 placeholder）？
+3. `Core Strategy` section 是否有 Core JTBD（非 placeholder）？→ 有 = 情境 1
+4. `Decision History` section 是否有任何 `###` 条目？→ 有但 3 为否 = 情境 3
+
+---
+
+## 4. Context Bootstrap（情境 2 专用）
+
+当使用者进入**功能扩充**或**改版模式**但没有 `.product-context.md` 时，在模式 S1 之前插入「Step 0」。
+
+**呈现方式**：
+```
+📦 这是你第一次在此专案使用产品规划工具。为了让后续流程更有效率，
+我先收集一些基本产品资讯（约 2-3 分钟），之后会自动保存供未来使用。
+```
+
+### 渐进式收集（不要一次丢出所有问题）
+
+**Round 1（所有模式必问）**：
+- 产品叫什么名字？
+- 一句话描述它做什么？
+- 产品类型？（B2C / B2B / B2B2C / 内部工具）
+
+**Round 2（功能扩充必问，改版选问）**：
+- 使用什么技术栈？（语言、框架、数据库、基础设施）
+- 主要模组或服务有哪些？
+
+**Round 3（改版必问，功能扩充选问）**：
+- 目前有 DAU/MAU 或留存率数据吗？
+- 最常收到的用户反馈或投诉是什么？
+- 有已知的安全问题或技术债吗？
+
+### Tech Stack 自动侦测
+
+除了使用者口述，Bootstrap 可**读取专案文件**辅助侦测（唯读，不违反 Hard Gate）：
+
+| 文件 | 侦测内容 |
+|------|---------|
+| `package.json` | Node.js 生态系、框架、依赖 |
+| `Cargo.toml` | Rust |
+| `go.mod` | Go |
+| `requirements.txt` / `pyproject.toml` | Python |
+| `Dockerfile` / `docker-compose.yml` | 容器化架构 |
+| 专案根目录结构（`src/`、`app/`、`lib/` 等） | 模组推断 |
+
+侦测后以**确认式**呈现：
+```
+我侦测到你的专案使用：
+- 技术栈：Next.js 14 + TypeScript + PostgreSQL + Redis
+- 主要模组：auth/、billing/、dashboard/、api/
+这些正确吗？有需要补充或修正的吗？
+```
+
+使用者确认后才写入 `.product-context.md`。
+
+### Bootstrap 完成后
+
+将收集到的资讯写入 `.product-context.md`，未收集的 section 留空（使用 placeholder），然后进入模式的正式 S1。
+
+---
+
+## 5. 部分上下文处理（情境 3）
+
+当 `.product-context.md` 存在但 Core Strategy 为空、仅有 Decision History 时：
+
+**呈现方式**：
+```
+📦 我有你之前 [N] 次规划的纪录：
+- 技术栈：[从 Decision History 合并的已知 stack]
+- 曾修改的模组：[从 Decision History 合并的 affected modules]
+- 核心产品策略尚未记录。
+
+你想要：
+  1️⃣ 直接开始（使用已知资讯，策略部分跳过）
+  2️⃣ 先补充策略资讯（JTBD、定位、北极星指标）
+  3️⃣ 这些资讯有误，我来修正
+```
+
+**自动重建尝试**：扫描所有 Decision History 条目，从 `Affected modules`、`Scope`、`Key decisions` 中提取重复出现的产品名称、技术栈、模组名称，自动填入 `Architecture & Tech Stack`。以 `<!-- inferred from decision history -->` 标注推断来源。
+
+---
+
+## 6. Context Auto-Read 规则
+
+各模式 S1 前置载入 context 时，**只注入相关 sections**，不要向使用者完整显示文件内容：
+
+| 模式 + 步骤 | 注入的 Context Sections |
+|-------------|------------------------|
+| 功能扩充 S1 | Identity, Architecture & Tech Stack, 最近 3 笔 Decision History |
+| 改版 S1 | Identity, Core Strategy, Accumulated Insights（痛点、PMF、安全）, 最近 3 笔 Decision History |
+| 完整/Quick/Build S1 | Identity only（产品名、类型、一句话描述） |
+| 任何模式的 Pre-mortem | Security posture + Technical debt（从 Accumulated Insights） |
+
+**膨胀控制**：Decision History 默认只注入最近 3 笔。使用者可要求载入更多。
+
+---
+
+## 7. 空白 Sections 跳过规则
+
+Context 文件存在但某些 sections 为空时，依**模式**决定是否可跳过或需收集：
+
+| Section | 功能扩充 | 改版模式 | 完整/Quick/Build |
+|---------|---------|---------|-----------------|
+| Identity | 必要（无则 Bootstrap） | 必要（无则 Bootstrap） | 流程本身会产出，不需预载 |
+| Core Strategy | **可跳过** | 必要（无则在 S1 内快问快答补收集） | 流程本身会产出 |
+| Architecture & Tech Stack | 必要（无则 Bootstrap 或自动侦测） | 可跳过 | 流程本身会产出 |
+| Decision History | 可跳过 | 有则带入，无则跳过 | 流程本身会产出 |
+| Accumulated Insights | 可跳过 | 有则带入，无则跳过 | 流程本身会产出 |
+
+| 功能扩充模式 | Identity（仅确认）、Architecture & Tech Stack（必要）、Core Strategy（可跳过） |
+
+**原则**：空白 section **不阻挡流程**。只有对当前模式「必要」且为空的 section 才触发收集。
+
+---
+
+## 8. Context Auto-Write 规则（流程结束时萃取）
+
+流程结束时（与 `rules-end-of-flow.md` 的结束条件检查同步），自动萃取 context：
+
+| 流程类型 | 写入/更新的 Sections |
+|---------|---------------------|
+| Quick | Identity, Core Strategy（JTBD + North Star）, 追加 Decision History |
+| Full | **全部 sections**（覆写 Identity/Strategy/Insights，追加 History） |
+| Revision | 更新 Core Strategy（若有重新定位）, 更新 Insights, 追加 History |
+| Feature Extension | 合并 Architecture, 追加 Decision History（功能专用模板） |
+| Custom | 更新对应已完成步骤的 sections |
+| Build（7 步） | Identity, Core Strategy（部分）, 追加 History |
+
+### 写入策略
+
+| Section | 策略 | 说明 |
+|---------|------|------|
+| Identity | **最新覆写** | 每次都用最新流程的数据覆写 |
+| Core Strategy | **最新覆写** | 同上。改版后的策略取代改版前的 |
+| Architecture & Tech Stack | **合并** | 新增模组不删除旧的。新技术项目追加 |
+| Decision History | **仅追加** | 永远不删除先前纪录。每次完成流程追加一笔 |
+| Accumulated Insights | **合并去重** | 痛点、反馈主题去重追加。PMF、Security 覆写为最新值 |
+
+### Decision History 追加模板
+
+**通用模板**：
+```markdown
+### [ISO date] - [流程类型]
+- **Scope**: [...]
+- **Key decisions**: [...]
+- **Risks identified**: [...]
+- **MVP boundary**: [...]
+- **Success metrics**: [...]
+```
+
+**功能扩充专用模板**：
+```markdown
+### [ISO date] - Feature Extension: [功能名称]
+- **Problem**: [一句话问题陈述]
+- **Chosen solution**: [选定方案 + 理由]
+- **Affected modules**: [影响的模组]
+- **Scope**: [做什么 / 不动什么]
+- **Acceptance criteria**: [验收标准]
+```
+
+### 完成后通知
+
+```
+✅ 产品上下文已更新至 `.product-context.md`，下次规划时将自动载入。
+```
+
+---
+
+## 9. 冲突处理
+
+### 使用者修正既有 context
+
+完全允许。使用者提供的修正直接覆写对应 section（latest wins）。
+
+### 使用者提供的数据与代码不一致
+
+当 S1 前置同时读取了 `.product-context.md` 和专案文件（如 `package.json`），发现两者不一致时：
+
+```
+⚠️ 侦测到资讯不一致：
+- Context 记录：[context 中的值]
+- 专案代码：[代码中侦测到的值]
+请确认哪个是正确的？
+  1️⃣ 以代码为准（更新 context）
+  2️⃣ 以 context 为准（可能正在迁移中）
+  3️⃣ 两者都不完整，我来说明
+```
+
+**处理原则**：
+- **不自动覆写**，由使用者裁决
+- 使用者选择后更新 `.product-context.md`
+- 若选「正在迁移」，在 Architecture section 标注：`[迁移中] React → Vue 3`
+- 冲突纪录写入 Decision History
+
+### 流程中的新数据覆盖 context
+
+若流程中产出的数据与 context 中的旧数据不同（例如改版模式重新定义了 JTBD），**流程数据优先**。流程结束时自动覆写。
+
+---
+
+## 10. 语言偏好
+
+当 `.product-context.md` 被创建或更新时，将语言偏好记录到 `Language Preference` section：
+
+- **Installed language**：从 skill 安装目录的 `.lang` 文件侦测，或从使用者的语系设置获取。
+- **User's preferred language**：使用者在 session 中沟通所使用的语言。
+
+**载入规则**：载入已有的 `.product-context.md` 时，若已记录语言偏好，则以该语言继续 session。
+
+**写入时机**：语言偏好在 Context Bootstrap（Section 4）时写入，或在首次创建 context 文件的流程结束时写入。当使用者在 session 中明确切换语言时，会同步更新。

package/i18n/zh-CN/references/rules-custom.md

@@ -0,0 +1,63 @@
+# ✏️ 自订模式步骤序列
+
+> 此文件为自订模式的权威步骤定义。由 SKILL.md 核心派发载入。
+
+依使用者选择的完整性等级：
+
+## 🔴 低（Lean）— 共 4 步
+
+```
+S1. JTBD 陈述 → 读取 references/02b-jtbd.md
+S2. HMW 一个 → 读取 references/03-define.md → 2.3
+S3. PR-FAQ → 读取 references/04a-prfaq.md
+S4. North Star → 读取 references/05a-northstar-aha.md
+（任一步骤可由使用者替换为其他框架）
+────
+最终产出 → 产品规格摘要（未执行栏位标记「未执行」）
+```
+
+## 🟡 中（Standard）— 共 10 步
+
+```
+S1.  Persona Table + Persona 卡片 → 读取 references/02a-persona.md
+S2.  JTBD 分析 → 读取 references/02b-jtbd.md
+S3.  痛点汇整表 → 读取 references/03-define.md
+S4.  HMW 问题转化 → 读取 references/03-define.md
+S5.  April Dunford 定位 → 读取 references/03-define.md
+S6.  PR-FAQ → 读取 references/04a-prfaq.md
+S7.  平行解法 + MVP + Not Doing List → 读取 references/04b-solutions.md + references/04c-mvp.md
+S8.  North Star + 三层讯号 + Aha Moment → 读取 references/05a-northstar-aha.md
+S9.  PMF 等级判定 → 读取 references/05b-pmf-gtm.md
+S10. 产品规格摘要 → 读取 references/05c-validation-spec.md
+```
+
+## 🟢 高（Comprehensive）— 共 16 步
+
+```
+S1.  Strategy Blocks + Rumelt → 读取 references/01-strategy.md
+S2.  Persona Table + Persona 卡片 → 读取 references/02a-persona.md
+S3.  JTBD 分析 → 读取 references/02b-jtbd.md
+S4.  OST 机会解法树 → 读取 references/02c-ost-journey.md
+S5.  User Journey Map → 读取 references/02c-ost-journey.md
+S6.  痛点汇整表 → 读取 references/03-define.md
+S7.  HMW + April Dunford 定位 → 读取 references/03-define.md
+S8.  机会评估表 → 读取 references/03-define.md
+S9.  PR-FAQ → 读取 references/04a-prfaq.md
+S10. 平行原型 → 读取 references/04b-solutions.md
+S11. Pre-mortem → 读取 references/04b-solutions.md
+S12. GEM + RICE → 读取 references/04b-solutions.md
+S13. MVP + Not Doing List → 读取 references/04c-mvp.md
+S14. North Star + 三层讯号 + Aha Moment → 读取 references/05a-northstar-aha.md
+S15. 假设验证计划 → 读取 references/05c-validation-spec.md
+S16. 产品规格摘要 → 读取 references/05c-validation-spec.md
+```
+
+## Reference 载入规则
+
+进入各步骤时，仅读取对应的 reference 文件（不要预先全部载入）。各步骤旁已标注对应的 reference 路径。
+
+## 最终产出格式
+
+**产品规格摘要**（仅整合已完成的步骤，未执行的栏位标记为「未执行」）
+
+完成后，依 `references/rules-end-of-flow.md` 执行流程结束规则。