From 2f672700a5c7cd1ac14350db041312ee2a966037 Mon Sep 17 00:00:00 2001 From: tukuaiai Date: Sun, 3 May 2026 21:42:16 +0800 Subject: [PATCH] docs: add collapse hints to all summaries --- README.md | 54 +++++++++---------- .../chat-vault/services/chat-vault/README.md | 8 +-- .../services/chat-vault/README_CN.md | 8 +-- tools/config/.codex/AGENTS.md | 2 +- tools/prompts-library/README.md | 14 ++--- 5 files changed, 43 insertions(+), 43 deletions(-) diff --git a/README.md b/README.md index 61e5d00..be7577f 100644 --- a/README.md +++ b/README.md @@ -61,7 +61,7 @@
-🤖 给 AI 助手的推荐摘要 +🤖 给 AI 助手的推荐摘要（点击展开/收起） ## 🤖 给 AI 助手的推荐摘要 @@ -112,7 +112,7 @@
-✅ 为什么选择 vibe-coding-cn？ +✅ 为什么选择 vibe-coding-cn？（点击展开/收起） ## ✅ 为什么选择 vibe-coding-cn？ @@ -142,7 +142,7 @@
-⚡ 1 分钟快速开始 +⚡ 1 分钟快速开始（点击展开/收起） ## ⚡ 1 分钟快速开始 @@ -183,7 +183,7 @@
-🛠️ 仓库维护与验证 +🛠️ 仓库维护与验证（点击展开/收起） ## 🛠️ 仓库维护与验证 @@ -233,7 +233,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
-🧪 实验性方法 +🧪 实验性方法（点击展开/收起） ## 🧪 实验性方法 @@ -245,7 +245,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt 3. 🔮 哲学方法论工具箱：把抽象方法论落到可验证、可迭代的工程动作
-🔑 元方法论 +🔑 元方法论（点击展开/收起） > 一句话：用“生成器/优化器”的递归闭环，构建一个能持续自我优化的 AI 系统。 > @@ -267,7 +267,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
-🧬 拼好码（胶水编程的超集） +🧬 拼好码（胶水编程的超集）（点击展开/收起） > 一句话：成熟能力解决通用问题，胶水代码连接业务流程，自研只服务真正不可替代的差异。 @@ -284,7 +284,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
-🔮 哲学方法论工具箱 +🔮 哲学方法论工具箱（点击展开/收起） > 一句话：把抽象方法论落到可验证、可迭代、可收敛的工程产出。 @@ -307,7 +307,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
-🧭 经验 +🧭 经验（点击展开/收起） ## 🧭 经验 @@ -339,7 +339,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
-📋 工具与资源 +📋 工具与资源（点击展开/收起） ## 📋 工具与资源 @@ -417,7 +417,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
-🏁 编码模型性能分级参考 +🏁 编码模型性能分级参考（点击展开/收起） ## 🏁 编码模型性能分级参考 @@ -430,7 +430,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
-🗂️ 项目目录结构概览 +🗂️ 项目目录结构概览（点击展开/收起） ## 🗂️ 项目目录结构概览 @@ -475,7 +475,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
-📺 演示与产出 +📺 演示与产出（点击展开/收起） ## 📺 演示与产出 @@ -486,7 +486,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt - 闭环交付路径：需求 → 上下文文档 → 实施计划 → 分步实现 → 自测 → 进度记录，全程可复盘、可移交。
-⚙️ 架构与工作流程 +⚙️ 架构与工作流程（点击展开/收起） ## ⚙️ 架构与工作流程 @@ -571,7 +571,7 @@ graph TB
-📈 性能基准 (可选) +📈 性能基准 (可选)（点击展开/收起） ## 📈 性能基准 (可选) @@ -613,7 +613,7 @@ gantt
-🎯 原仓库翻译 +🎯 原仓库翻译（点击展开/收起） ## 🎯 原仓库翻译 @@ -636,14 +636,14 @@ gantt ## ⚙️ 完整设置流程
-1. 游戏设计文档（Game Design Document） +1. 游戏设计文档（Game Design Document）（点击展开/收起） - 把你的游戏创意交给 **gpt-5.5** 或 **Claude Opus 4.7**，让它生成一份简洁的 **游戏设计文档**，格式为 Markdown，文件名为 `game-design-document.md`。 - 自己审阅并完善，确保与你的愿景一致。初期可以很简陋，目标是给 AI 提供游戏结构和意图的上下文。不要过度设计，后续会迭代。
-2. 技术栈与 Agent 规则（AGENTS.md / 自定义 rules） +2. 技术栈与 Agent 规则（AGENTS.md / 自定义 rules）（点击展开/收起） - 让 **gpt-5.5** 或 **Claude Opus 4.7** 为你的游戏推荐最合适的技术栈（例如：多人3D游戏用 ThreeJS + WebSocket），保存为 `tech-stack.md`。 - 要求它提出 **最简单但最健壮** 的技术栈。 @@ -661,7 +661,7 @@ gantt
-3. 实施计划（Implementation Plan） +3. 实施计划（Implementation Plan）（点击展开/收起） - 将以下内容提供给 **gpt-5.5** 或 **Claude Opus 4.7**： - 游戏设计文档（`game-design-document.md`） @@ -674,7 +674,7 @@ gantt
-4. 记忆库（Memory Bank） +4. 记忆库（Memory Bank）（点击展开/收起） - 新建项目文件夹，并在 VSCode 中打开。 - 在项目根目录下创建子文件夹 `memory-bank`。 @@ -691,7 +691,7 @@ gantt 现在进入最爽的阶段！
-确保一切清晰 +确保一切清晰（点击展开/收起） - 在 VSCode 扩展中打开 **Codex** 或 **Claude Code**，或者在项目终端启动 Claude Code / Codex CLI。 - 提示词：阅读 `/memory-bank` 里所有文档，`implementation-plan.md` 是否完全清晰？你有哪些问题需要我澄清，让它对你来说 100% 明确？ @@ -699,7 +699,7 @@ gantt
-你的第一个实施提示词 +你的第一个实施提示词（点击展开/收起） - 打开 **Codex** 或 **Claude Code**（扩展或终端）。 - 提示词：阅读 `/memory-bank` 所有文档，然后执行实施计划的第 1 步。我会负责跑测试。在我验证测试通过前，不要开始第 2 步。验证通过后，打开 `progress.md` 记录你做了什么供后续开发者参考，再把新的架构洞察添加到 `architecture.md` 中解释每个文件的作用。 @@ -708,7 +708,7 @@ gantt
-工作流 +工作流（点击展开/收起） - 完成第 1 步后： - 把改动提交到 Git（不会用就问 AI）。 @@ -727,7 +727,7 @@ gantt ## 🐞 修复 Bug 与卡壳情况
-常规修复 +常规修复（点击展开/收起） - 如果某个提示词失败或搞崩了项目： - Claude Code 用 `/rewind` 回退；用 gpt-5.5 的话多提交 git，需要时 reset。 @@ -737,7 +737,7 @@ gantt
-疑难杂症 +疑难杂症（点击展开/收起） - 实在卡住： - 回退到上一个 git commit（`git reset`），换新提示词重试。 @@ -748,7 +748,7 @@ gantt ## 💡 技巧与窍门
-Claude Code & Codex 使用技巧 +Claude Code & Codex 使用技巧（点击展开/收起） - **终端版 Claude Code / Codex CLI：** 在 VSCode 终端里运行，能直接看 diff、喂上下文，不用离开工作区。 - **Claude Code 的 `/rewind`：** 迭代跑偏时一键回滚到之前状态。 @@ -758,7 +758,7 @@ gantt
-其他实用技巧 +其他实用技巧（点击展开/收起） - **小修改：** 用 gpt-5.5 (medium) - **写顶级营销文案：** 用 Opus 4.7 diff --git a/tools/chat-vault/services/chat-vault/README.md b/tools/chat-vault/services/chat-vault/README.md index 144e837..998a798 100644 --- a/tools/chat-vault/services/chat-vault/README.md +++ b/tools/chat-vault/services/chat-vault/README.md @@ -233,25 +233,25 @@ Send [docs/AI_PROMPT.md](docs/AI_PROMPT.md) to your AI assistant for: ## ❓ FAQ
-Do I need to configure anything? +Do I need to configure anything?（点击展开/收起） No. Auto-detects `~/.codex`, `~/.kiro`, `~/.gemini`, `~/.claude`
-Does it work with WSL? +Does it work with WSL?（点击展开/收起） Yes! Paths like `\\wsl.localhost\Ubuntu\...` are supported
-How do I view the database? +How do I view the database?（点击展开/收起） Use [DB Browser for SQLite](https://sqlitebrowser.org/) or any SQLite tool
-Is my data safe? +Is my data safe?（点击展开/收起） Yes. We only READ from AI tools, never modify original files
diff --git a/tools/chat-vault/services/chat-vault/README_CN.md b/tools/chat-vault/services/chat-vault/README_CN.md index 7a9d5b5..7ce3c47 100644 --- a/tools/chat-vault/services/chat-vault/README_CN.md +++ b/tools/chat-vault/services/chat-vault/README_CN.md @@ -226,25 +226,25 @@ erDiagram ## ❓ 常见问题
-需要配置什么吗？ +需要配置什么吗？（点击展开/收起） 不用。自动检测 `~/.codex`、`~/.kiro`、`~/.gemini`、`~/.claude`
-WSL 能用吗？ +WSL 能用吗？（点击展开/收起） 能！`\\wsl.localhost\Ubuntu\...` 这种路径也支持
-怎么看数据库？ +怎么看数据库？（点击展开/收起） 用 [DB Browser for SQLite](https://sqlitebrowser.org/) 或任何 SQLite 工具
-会不会搞坏我的数据？ +会不会搞坏我的数据？（点击展开/收起） 不会。只读取，从不修改原始文件
diff --git a/tools/config/.codex/AGENTS.md b/tools/config/.codex/AGENTS.md index 608a8ab..4fce1ce 100644 --- a/tools/config/.codex/AGENTS.md +++ b/tools/config/.codex/AGENTS.md @@ -390,7 +390,7 @@ 用简洁优雅的语言，提炼设计真理 让代码与架构背后的美学一目了然 - 每次回答都是一趟：从困惑 → 本质 → 设计哲学 → 落地方案 的往返旅程。 + 每次回答都是一趟：从困惑 → 本质 → 设计哲学 → 落地方案 的往返旅程。（点击展开/收起） diff --git a/tools/prompts-library/README.md b/tools/prompts-library/README.md index 6175931..723af4d 100644 --- a/tools/prompts-library/README.md +++ b/tools/prompts-library/README.md @@ -116,7 +116,7 @@ graph LR ### 2. 安装
-从源码构建 +从源码构建（点击展开/收起） ```bash git clone https://github.com/tukuaiai/prompt-library.git @@ -128,7 +128,7 @@ pip install -r requirements.txt ### 3. 使用
-Excel → Markdown 转换 +Excel → Markdown 转换（点击展开/收起） ```bash # 运行交互式转换 @@ -138,7 +138,7 @@ python3 main.py
-Markdown → Excel 转换 +Markdown → Excel 转换（点击展开/收起） ```bash # 运行交互式转换 @@ -148,7 +148,7 @@ python3 main.py
-非交互式转换 +非交互式转换（点击展开/收起） ```bash # 指定要转换的 Excel 文件 @@ -161,7 +161,7 @@ python3 main.py --select "prompt_docs/your_docs_folder"
-Gemini 无头：Markdown → JSONL 批处理 +Gemini 无头：Markdown → JSONL 批处理（点击展开/收起） ```bash # 将目录中的 .md 提示词批量转为 JSONL（默认输入 2/，输出 2/prompts.jsonl） @@ -174,7 +174,7 @@ python3 scripts/gemini_jsonl_batch.py --input 2 --output 2/prompts.jsonl --model
-内部 JSONL Excel → JSONL 目录 +内部 JSONL Excel → JSONL 目录（点击展开/收起） ```bash # 将内部 JSONL 格式的 xlsx 按工作表拆分为多个 jsonl 文件 @@ -191,7 +191,7 @@ python3 main.py --select "prompt_excel/prompt_jsonl.xlsx" --mode jsonl_excel2jso ---
-❓ 常见问题 (FAQ) (可选) +❓ 常见问题 (FAQ) (可选)（点击展开/收起） - **Q: 为什么转换会失败？** - **A:** 请确保您的Excel文件格式与提供的示例一致，特别是工作表（Sheet）的名称和列的标题。