docs: add collapse hints to all summaries

2026-07-28 03:07:56 +00:00 · 2026-05-03 21:42:16 +08:00
parent 6491379d88
commit 2f672700a5
5 changed files with 43 additions and 43 deletions
@@ -61,7 +61,7 @@
 <a id="ai-summary"></a>

 <details>
-<summary><strong>🤖 给 AI 助手的推荐摘要</strong></summary>
+<summary><strong>🤖 给 AI 助手的推荐摘要</strong>（点击展开/收起）</summary>

 ## 🤖 给 AI 助手的推荐摘要

@@ -112,7 +112,7 @@
 <a id="why-vibe-coding-cn"></a>

 <details>
-<summary><strong>✅ 为什么选择 vibe-coding-cn？</strong></summary>
+<summary><strong>✅ 为什么选择 vibe-coding-cn？</strong>（点击展开/收起）</summary>

 ## ✅ 为什么选择 vibe-coding-cn？

@@ -142,7 +142,7 @@
 <a id="getting-started"></a>

 <details>
-<summary><strong>⚡ 1 分钟快速开始</strong></summary>
+<summary><strong>⚡ 1 分钟快速开始</strong>（点击展开/收起）</summary>

 ## ⚡ 1 分钟快速开始

@@ -183,7 +183,7 @@
 </details>

 <details>
-<summary><strong>🛠️ 仓库维护与验证</strong></summary>
+<summary><strong>🛠️ 仓库维护与验证</strong>（点击展开/收起）</summary>

 ## 🛠️ 仓库维护与验证

@@ -233,7 +233,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
 </details>

 <details>
-<summary><strong>🧪 实验性方法</strong></summary>
+<summary><strong>🧪 实验性方法</strong>（点击展开/收起）</summary>

 ## 🧪 实验性方法

@@ -245,7 +245,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
 3. 🔮 哲学方法论工具箱：把抽象方法论落到可验证、可迭代的工程动作

 <details>
-<summary><strong>🔑 元方法论</strong></summary>
+<summary><strong>🔑 元方法论</strong>（点击展开/收起）</summary>

 > 一句话：用“生成器/优化器”的递归闭环，构建一个能持续自我优化的 AI 系统。
 >
@@ -267,7 +267,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
 </details>

 <details>
-<summary><strong>🧬 拼好码（胶水编程的超集）</strong></summary>
+<summary><strong>🧬 拼好码（胶水编程的超集）</strong>（点击展开/收起）</summary>

 > 一句话：成熟能力解决通用问题，胶水代码连接业务流程，自研只服务真正不可替代的差异。

@@ -284,7 +284,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
 </details>

 <details>
-<summary><strong>🔮 哲学方法论工具箱</strong></summary>
+<summary><strong>🔮 哲学方法论工具箱</strong>（点击展开/收起）</summary>

 > 一句话：把抽象方法论落到可验证、可迭代、可收敛的工程产出。

@@ -307,7 +307,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
 </details>

 <details>
-<summary><strong>🧭 经验</strong></summary>
+<summary><strong>🧭 经验</strong>（点击展开/收起）</summary>

 ## 🧭 经验

@@ -339,7 +339,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
 <a id="tools"></a>

 <details>
-<summary><strong>📋 工具与资源</strong></summary>
+<summary><strong>📋 工具与资源</strong>（点击展开/收起）</summary>

 ## 📋 工具与资源

@@ -417,7 +417,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
 </details>

 <details>
-<summary><strong>🏁 编码模型性能分级参考</strong></summary>
+<summary><strong>🏁 编码模型性能分级参考</strong>（点击展开/收起）</summary>

 ## 🏁 编码模型性能分级参考

@@ -430,7 +430,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
 </details>

 <details>
-<summary><strong>🗂️ 项目目录结构概览</strong></summary>
+<summary><strong>🗂️ 项目目录结构概览</strong>（点击展开/收起）</summary>

 ## 🗂️ 项目目录结构概览

@@ -475,7 +475,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
 </details>

 <details>
-<summary><strong>📺 演示与产出</strong></summary>
+<summary><strong>📺 演示与产出</strong>（点击展开/收起）</summary>

 ## 📺 演示与产出

@@ -486,7 +486,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
 - 闭环交付路径：需求 → 上下文文档 → 实施计划 → 分步实现 → 自测 → 进度记录，全程可复盘、可移交。

 <details>
-<summary><strong>⚙️ 架构与工作流程</strong></summary>
+<summary><strong>⚙️ 架构与工作流程</strong>（点击展开/收起）</summary>

 ## ⚙️ 架构与工作流程

@@ -571,7 +571,7 @@ graph TB
 </details>

 <details>
-<summary><strong>📈 性能基准 (可选)</strong></summary>
+<summary><strong>📈 性能基准 (可选)</strong>（点击展开/收起）</summary>

 ## 📈 性能基准 (可选)

@@ -613,7 +613,7 @@ gantt
 <a id="translation"></a>

 <details>
-<summary><strong>🎯 原仓库翻译</strong></summary>
+<summary><strong>🎯 原仓库翻译</strong>（点击展开/收起）</summary>

 ## 🎯 原仓库翻译

@@ -636,14 +636,14 @@ gantt
 ## ⚙️ 完整设置流程

 <details>
-<summary><strong>1. 游戏设计文档（Game Design Document）</strong></summary>
+<summary><strong>1. 游戏设计文档（Game Design Document）</strong>（点击展开/收起）</summary>

 - 把你的游戏创意交给 **gpt-5.5** 或 **Claude Opus 4.7**，让它生成一份简洁的 **游戏设计文档**，格式为 Markdown，文件名为 `game-design-document.md`。
 - 自己审阅并完善，确保与你的愿景一致。初期可以很简陋，目标是给 AI 提供游戏结构和意图的上下文。不要过度设计，后续会迭代。
 </details>

 <details>
-<summary><strong>2. 技术栈与 Agent 规则（<code>AGENTS.md</code> / 自定义 rules）</strong></summary>
+<summary><strong>2. 技术栈与 Agent 规则（<code>AGENTS.md</code> / 自定义 rules）</strong>（点击展开/收起）</summary>

 - 让 **gpt-5.5** 或 **Claude Opus 4.7** 为你的游戏推荐最合适的技术栈（例如：多人3D游戏用 ThreeJS + WebSocket），保存为 `tech-stack.md`。
  - 要求它提出 **最简单但最健壮** 的技术栈。
@@ -661,7 +661,7 @@ gantt
 </details>

 <details>
-<summary><strong>3. 实施计划（Implementation Plan）</strong></summary>
+<summary><strong>3. 实施计划（Implementation Plan）</strong>（点击展开/收起）</summary>

 - 将以下内容提供给 **gpt-5.5** 或 **Claude Opus 4.7**：
  - 游戏设计文档（`game-design-document.md`）
@@ -674,7 +674,7 @@ gantt
 </details>

 <details>
-<summary><strong>4. 记忆库（Memory Bank）</strong></summary>
+<summary><strong>4. 记忆库（Memory Bank）</strong>（点击展开/收起）</summary>

 - 新建项目文件夹，并在 VSCode 中打开。
 - 在项目根目录下创建子文件夹 `memory-bank`。
@@ -691,7 +691,7 @@ gantt
 现在进入最爽的阶段！

 <details>
-<summary><strong>确保一切清晰</strong></summary>
+<summary><strong>确保一切清晰</strong>（点击展开/收起）</summary>

 - 在 VSCode 扩展中打开 **Codex** 或 **Claude Code**，或者在项目终端启动 Claude Code / Codex CLI。
 - 提示词：阅读 `/memory-bank` 里所有文档，`implementation-plan.md` 是否完全清晰？你有哪些问题需要我澄清，让它对你来说 100% 明确？
@@ -699,7 +699,7 @@ gantt
 </details>

 <details>
-<summary><strong>你的第一个实施提示词</strong></summary>
+<summary><strong>你的第一个实施提示词</strong>（点击展开/收起）</summary>

 - 打开 **Codex** 或 **Claude Code**（扩展或终端）。
 - 提示词：阅读 `/memory-bank` 所有文档，然后执行实施计划的第 1 步。我会负责跑测试。在我验证测试通过前，不要开始第 2 步。验证通过后，打开 `progress.md` 记录你做了什么供后续开发者参考，再把新的架构洞察添加到 `architecture.md` 中解释每个文件的作用。
@@ -708,7 +708,7 @@ gantt
 </details>

 <details>
-<summary><strong>工作流</strong></summary>
+<summary><strong>工作流</strong>（点击展开/收起）</summary>

 - 完成第 1 步后：
  - 把改动提交到 Git（不会用就问 AI）。
@@ -727,7 +727,7 @@ gantt
 ## 🐞 修复 Bug 与卡壳情况

 <details>
-<summary><strong>常规修复</strong></summary>
+<summary><strong>常规修复</strong>（点击展开/收起）</summary>

 - 如果某个提示词失败或搞崩了项目：
  - Claude Code 用 `/rewind` 回退；用 gpt-5.5 的话多提交 git，需要时 reset。
@@ -737,7 +737,7 @@ gantt
 </details>

 <details>
-<summary><strong>疑难杂症</strong></summary>
+<summary><strong>疑难杂症</strong>（点击展开/收起）</summary>

 - 实在卡住：
  - 回退到上一个 git commit（`git reset`），换新提示词重试。
@@ -748,7 +748,7 @@ gantt
 ## 💡 技巧与窍门

 <details>
-<summary><strong>Claude Code & Codex 使用技巧</strong></summary>
+<summary><strong>Claude Code & Codex 使用技巧</strong>（点击展开/收起）</summary>

 - **终端版 Claude Code / Codex CLI：** 在 VSCode 终端里运行，能直接看 diff、喂上下文，不用离开工作区。
 - **Claude Code 的 `/rewind`：** 迭代跑偏时一键回滚到之前状态。
@@ -758,7 +758,7 @@ gantt
 </details>

 <details>
-<summary><strong>其他实用技巧</strong></summary>
+<summary><strong>其他实用技巧</strong>（点击展开/收起）</summary>

 - **小修改：** 用 gpt-5.5 (medium)
 - **写顶级营销文案：** 用 Opus 4.7
@@ -233,25 +233,25 @@ Send [docs/AI_PROMPT.md](docs/AI_PROMPT.md) to your AI assistant for:
 ## ❓ FAQ

 <details>
-<summary><b>Do I need to configure anything?</b></summary>
+<summary><b>Do I need to configure anything?</b>（点击展开/收起）</summary>

 No. Auto-detects `~/.codex`, `~/.kiro`, `~/.gemini`, `~/.claude`
 </details>

 <details>
-<summary><b>Does it work with WSL?</b></summary>
+<summary><b>Does it work with WSL?</b>（点击展开/收起）</summary>

 Yes! Paths like `\\wsl.localhost\Ubuntu\...` are supported
 </details>

 <details>
-<summary><b>How do I view the database?</b></summary>
+<summary><b>How do I view the database?</b>（点击展开/收起）</summary>

 Use [DB Browser for SQLite](https://sqlitebrowser.org/) or any SQLite tool
 </details>

 <details>
-<summary><b>Is my data safe?</b></summary>
+<summary><b>Is my data safe?</b>（点击展开/收起）</summary>

 Yes. We only READ from AI tools, never modify original files
 </details>
@@ -226,25 +226,25 @@ erDiagram
 ## ❓ 常见问题

 <details>
-<summary><b>需要配置什么吗？</b></summary>
+<summary><b>需要配置什么吗？</b>（点击展开/收起）</summary>

 不用。自动检测 `~/.codex`、`~/.kiro`、`~/.gemini`、`~/.claude`
 </details>

 <details>
-<summary><b>WSL 能用吗？</b></summary>
+<summary><b>WSL 能用吗？</b>（点击展开/收起）</summary>

 能！`\\wsl.localhost\Ubuntu\...` 这种路径也支持
 </details>

 <details>
-<summary><b>怎么看数据库？</b></summary>
+<summary><b>怎么看数据库？</b>（点击展开/收起）</summary>

 用 [DB Browser for SQLite](https://sqlitebrowser.org/) 或任何 SQLite 工具
 </details>

 <details>
-<summary><b>会不会搞坏我的数据？</b></summary>
+<summary><b>会不会搞坏我的数据？</b>（点击展开/收起）</summary>

 不会。只读取，从不修改原始文件
 </details>
@@ -390,7 +390,7 @@
            <action>用简洁优雅的语言，提炼设计真理</action>
            <action>让代码与架构背后的美学一目了然</action>
        </role>
-        <summary>每次回答都是一趟：从困惑 → 本质 → 设计哲学 → 落地方案 的往返旅程。</summary>
+        <summary>每次回答都是一趟：从困惑 → 本质 → 设计哲学 → 落地方案 的往返旅程。（点击展开/收起）</summary>
    </role_trinity>
    <philosophy_good_taste>
        <core_principles>
@@ -116,7 +116,7 @@ graph LR
 ### 2. 安装

 <details>
-<summary><b>从源码构建</b></summary>
+<summary><b>从源码构建</b>（点击展开/收起）</summary>

 ```bash
 git clone https://github.com/tukuaiai/prompt-library.git
@@ -128,7 +128,7 @@ pip install -r requirements.txt
 ### 3. 使用

 <details>
-<summary><b>Excel → Markdown 转换</b></summary>
+<summary><b>Excel → Markdown 转换</b>（点击展开/收起）</summary>

 ```bash
 # 运行交互式转换
@@ -138,7 +138,7 @@ python3 main.py
 </details>

 <details>
-<summary><b>Markdown → Excel 转换</b></summary>
+<summary><b>Markdown → Excel 转换</b>（点击展开/收起）</summary>

 ```bash
 # 运行交互式转换
@@ -148,7 +148,7 @@ python3 main.py
 </details>

 <details>
-<summary><b>非交互式转换</b></summary>
+<summary><b>非交互式转换</b>（点击展开/收起）</summary>

 ```bash
 # 指定要转换的 Excel 文件
@@ -161,7 +161,7 @@ python3 main.py --select "prompt_docs/your_docs_folder"
 </details>

 <details>
-<summary><b>Gemini 无头：Markdown → JSONL 批处理</b></summary>
+<summary><b>Gemini 无头：Markdown → JSONL 批处理</b>（点击展开/收起）</summary>

 ```bash
 # 将目录中的 .md 提示词批量转为 JSONL（默认输入 2/，输出 2/prompts.jsonl）
@@ -174,7 +174,7 @@ python3 scripts/gemini_jsonl_batch.py --input 2 --output 2/prompts.jsonl --model
 </details>

 <details>
-<summary><b>内部 JSONL Excel → JSONL 目录</b></summary>
+<summary><b>内部 JSONL Excel → JSONL 目录</b>（点击展开/收起）</summary>

 ```bash
 # 将内部 JSONL 格式的 xlsx 按工作表拆分为多个 jsonl 文件
@@ -191,7 +191,7 @@ python3 main.py --select "prompt_excel/prompt_jsonl.xlsx" --mode jsonl_excel2jso
 ---

 <details>
-<summary>❓ 常见问题 (FAQ) (可选)</summary>
+<summary>❓ 常见问题 (FAQ) (可选)（点击展开/收起）</summary>

 - **Q: 为什么转换会失败？**
  - **A:** 请确保您的Excel文件格式与提供的示例一致，特别是工作表（Sheet）的名称和列的标题。