chore: migrate repository to standard knowledge base layout

2026-08-13 02:48:05 +00:00 · 2026-05-02 03:29:06 +08:00
parent 40a721c24d
commit 628a3bc832
565 changed files with 687 additions and 711 deletions
@@ -29,22 +29,22 @@
 <!-- 资源直达 - 按重要性分组 -->
 <!-- 🔴 核心理念 (红色系) -->
 <p>
-	  <a href="./assets/documents/guides/getting-started/学习地图.md"><img src="https://img.shields.io/badge/🗺️_学习地图-路线导航-orange?style=for-the-badge" alt="学习地图"></a>
-	  <a href="./assets/documents/guides/getting-started/README.md"><img src="https://img.shields.io/badge/🚀_从零开始-新手入门-red?style=for-the-badge" alt="从零开始"></a>
-	  <a href="./assets/documents/principles/fundamentals/问题求解能力.md"><img src="https://img.shields.io/badge/🧩_问题求解-必读-purple?style=for-the-badge" alt="问题求解能力"></a>
-	  <a href="./assets/documents/guides/getting-started/Vibe%20Coding%20经验.md"><img src="https://img.shields.io/badge/🧠_Vibe经验-必读-crimson?style=for-the-badge" alt="Vibe Coding 经验"></a>
-	  <a href="./assets/documents/principles/philosophy/README.md"><img src="https://img.shields.io/badge/🔮_哲学方法论-底层协议-purple?style=for-the-badge" alt="哲学与方法论"></a>
-	  <a href="./assets/documents/principles/fundamentals/强前置条件约束.md"><img src="https://img.shields.io/badge/🚫_硬约束-铁律-darkred?style=for-the-badge" alt="强前置条件约束"></a>
-	  <a href="./assets/documents/principles/fundamentals/常见坑汇总.md"><img src="https://img.shields.io/badge/🕳️_常见坑-避坑指南-yellow?style=for-the-badge" alt="常见坑汇总"></a>
-	  <a href="./assets/documents/principles/fundamentals/语言层要素.md"><img src="https://img.shields.io/badge/📊_语言层要素-12层框架-gold?style=for-the-badge" alt="语言层要素"></a>
-  <a href="./assets/skills/"><img src="https://img.shields.io/badge/⚡_Skills-技能大全-forestgreen?style=for-the-badge" alt="skills技能大全"></a>
+	  <a href="./docs/getting-started/学习地图.md"><img src="https://img.shields.io/badge/🗺️_学习地图-路线导航-orange?style=for-the-badge" alt="学习地图"></a>
+	  <a href="./docs/getting-started/README.md"><img src="https://img.shields.io/badge/🚀_从零开始-新手入门-red?style=for-the-badge" alt="从零开始"></a>
+	  <a href="./docs/concepts/问题求解能力.md"><img src="https://img.shields.io/badge/🧩_问题求解-必读-purple?style=for-the-badge" alt="问题求解能力"></a>
+	  <a href="./docs/getting-started/Vibe%20Coding%20经验.md"><img src="https://img.shields.io/badge/🧠_Vibe经验-必读-crimson?style=for-the-badge" alt="Vibe Coding 经验"></a>
+	  <a href="./docs/concepts/philosophy/README.md"><img src="https://img.shields.io/badge/🔮_哲学方法论-底层协议-purple?style=for-the-badge" alt="哲学与方法论"></a>
+	  <a href="./docs/references/强前置条件约束.md"><img src="https://img.shields.io/badge/🚫_硬约束-铁律-darkred?style=for-the-badge" alt="强前置条件约束"></a>
+	  <a href="./docs/references/常见坑汇总.md"><img src="https://img.shields.io/badge/🕳️_常见坑-避坑指南-yellow?style=for-the-badge" alt="常见坑汇总"></a>
+	  <a href="./docs/concepts/语言层要素.md"><img src="https://img.shields.io/badge/📊_语言层要素-12层框架-gold?style=for-the-badge" alt="语言层要素"></a>
+  <a href="./skills/"><img src="https://img.shields.io/badge/⚡_Skills-技能大全-forestgreen?style=for-the-badge" alt="skills技能大全"></a>
  <a href="https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203"><img src="https://img.shields.io/badge/📋_提示词-在线表格-blue?style=for-the-badge" alt="提示词在线表格"></a>
 	  <a href="./assets/README.md"><img src="https://img.shields.io/badge/📡_资源-聚合-teal?style=for-the-badge" alt="资源聚合"></a>
 </p>

 [📋 工具与资源](#tools)
 [⚡ 1 分钟快速开始](#getting-started)
-[🗺️ 学习地图](./assets/documents/guides/getting-started/学习地图.md)
+[🗺️ 学习地图](docs/getting-started/学习地图.md)
 [🤖 AI 推荐摘要](#ai-summary)
 [✅ 为什么选择](#why-vibe-coding-cn)
 [🎯 原仓库翻译](#translation)
@@ -173,12 +173,12 @@

 完全新手？按顺序完成以下步骤：

-0. [学习地图](./assets/documents/guides/getting-started/学习地图.md) - 按目标选择新手、开发者、团队、Prompt、Skill、Workflow 或 GEO/SEO 路线
-1. [问题求解能力](./assets/documents/principles/fundamentals/问题求解能力.md) - “目标-现状-差距-标准”与“目标-约束-对象-路径”的极简框架
-2. [Vibe Coding 经验](./assets/documents/guides/getting-started/Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环
-3. [网络环境配置](./assets/documents/guides/getting-started/网络环境配置.md) - 配置网络访问
-4. [Codex-CLI配置](./assets/documents/guides/getting-started/Codex-CLI配置.md) - 默认 AI CLI 路线，使用 gpt-5.5 与仓库配置基线
-5. [开发环境搭建](./assets/documents/guides/getting-started/开发环境搭建.md) - 安装 Git、Node.js、Python、编辑器等基础环境
+0. [学习地图](docs/getting-started/学习地图.md) - 按目标选择新手、开发者、团队、Prompt、Skill、Workflow 或 GEO/SEO 路线
+1. [问题求解能力](docs/concepts/问题求解能力.md) - “目标-现状-差距-标准”与“目标-约束-对象-路径”的极简框架
+2. [Vibe Coding 经验](docs/getting-started/Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环
+3. [网络环境配置](docs/getting-started/网络环境配置.md) - 配置网络访问
+4. [Codex-CLI配置](docs/getting-started/Codex-CLI配置.md) - 默认 AI CLI 路线，使用 gpt-5.5 与仓库配置基线
+5. [开发环境搭建](docs/getting-started/开发环境搭建.md) - 安装 Git、Node.js、Python、编辑器等基础环境

 </details>

@@ -187,7 +187,7 @@

 ## 🛠️ 仓库维护与验证

-本仓库是文档与资源型项目，不提供可验证的 dev server、Docker/K8s 部署入口或固定服务端口。当前可验证的自动化入口来自 `Makefile`、`.github/workflows/ci.yml`、`assets/repos/prompts-library/` 与 `assets/repos/backups/`。
+本仓库是文档与资源型项目，不提供可验证的 dev server、Docker/K8s 部署入口或固定服务端口。当前可验证的自动化入口来自 `Makefile`、`.github/workflows/ci.yml`、`tools/prompts-library/` 与 `scripts/backups/`。

 ### 环境要求

@@ -199,13 +199,13 @@

 ```bash
 git submodule update --init --recursive
-pip install -r assets/repos/prompts-library/requirements.txt
+pip install -r tools/prompts-library/requirements.txt
 ```

 如需运行 prompts-library 的 Google API / JSONL 辅助脚本，再安装脚本依赖：

 ```bash
-pip install -r assets/repos/prompts-library/scripts/requirements.txt
+pip install -r tools/prompts-library/scripts/requirements.txt
 ```

 ### 常用命令
@@ -214,16 +214,16 @@ pip install -r assets/repos/prompts-library/scripts/requirements.txt
 |:---|:---|:---|
 | 查看 Make 任务 | `make help` | `Makefile` |
 | 全仓 Markdown lint | `make lint` | `Makefile` + `.github/lint_config.json` |
-| 提示词格式转换 | `cd assets/repos/prompts-library && python3 main.py` | `assets/repos/prompts-library/main.py` |
-| 完整备份 | `bash assets/repos/backups/一键备份.sh` | `assets/repos/backups/README.md` |
-| Python 备份 | `python3 assets/repos/backups/快速备份.py` | `assets/repos/backups/README.md` |
-| Skill 严格校验示例 | `assets/skills/auto-skill/scripts/validate-skill.sh assets/skills/auto-skill --strict` | `assets/skills/auto-skill/scripts/validate-skill.sh` |
+| 提示词格式转换 | `cd tools/prompts-library && python3 main.py` | `tools/prompts-library/main.py` |
+| 完整备份 | `bash scripts/backups/一键备份.sh` | `scripts/backups/README.md` |
+| Python 备份 | `python3 scripts/backups/快速备份.py` | `scripts/backups/README.md` |
+| Skill 严格校验示例 | `skills/auto-skill/scripts/validate-skill.sh skills/auto-skill --strict` | `skills/auto-skill/scripts/validate-skill.sh` |

 ### 配置与 CI

 - Markdown lint 配置：`.github/lint_config.json`
 - CI 配置：`.github/workflows/ci.yml`，在 `main` 分支的 push / pull_request 上运行 markdown-lint 与 link-checker
- Codex 配置基线：`assets/config/.codex/config.toml`
+- Codex 配置基线：`tools/config/.codex/config.toml`
 - Submodule 来源：`.gitmodules`

 ### 部署
@@ -249,7 +249,7 @@ TODO：仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署

 > 一句话：用“生成器/优化器”的递归闭环，构建一个能持续自我优化的 AI 系统。
 >
-> 延伸阅读：[A Formalization of Recursive Self-Optimizing Generative Systems](./assets/documents/principles/fundamentals/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md)
+> 延伸阅读：[A Formalization of Recursive Self-Optimizing Generative Systems](docs/concepts/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md)

 ### 核心角色
 - **α-提示词（生成器）**：一个“母体”提示词，其唯一职责是生成其他提示词或技能。
@@ -279,7 +279,7 @@ TODO：仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署
 | 🧩 复杂性爆炸 | ✅ 通用复杂度交给成熟生态 |
 | 🎓 交付不稳定 | ✅ 胶水代码只负责连接、编排、适配和业务规则 |

-👉 [深入了解拼好码](./assets/documents/principles/fundamentals/拼好码.md)
+👉 [深入了解拼好码](docs/concepts/拼好码.md)

 </details>

@@ -300,7 +300,7 @@ TODO：仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署

 **核心理念**：哲学不是空谈，是可落地的工程方法。

-👉 [深入了解哲学方法论工具箱](./assets/documents/principles/philosophy/README.md)
+👉 [深入了解哲学方法论工具箱](docs/concepts/philosophy/README.md)

 </details>

@@ -346,7 +346,7 @@ TODO：仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署
 ### 集成开发环境 (IDE) & 终端

 *   [**Visual Studio Code**](https://code.visualstudio.com/): 一款功能强大的集成开发环境，适合代码阅读与手动修改。其 `Local History` 插件对项目版本管理尤为便捷。
-*   [**Codex CLI**](./assets/documents/guides/getting-started/Codex-CLI配置.md): 本教程默认 AI CLI 路线，用于需求拆解、代码修改、命令执行、测试验证与 Git 迭代。
+*   [**Codex CLI**](docs/getting-started/Codex-CLI配置.md): 本教程默认 AI CLI 路线，用于需求拆解、代码修改、命令执行、测试验证与 Git 迭代。
 *   **虚拟环境 (.venv)**: 强烈推荐使用，可实现项目环境的一键配置与隔离，特别适用于 Python 开发。
 *   [**Cursor**](https://cursor.com/): 已经占领用户心智高地，人尽皆知。
 *   [**Warp**](https://www.warp.dev/): 集成 AI 功能的现代化终端，能有效提升命令行操作和错误排查的效率。
@@ -384,17 +384,17 @@ TODO：仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署
 ### 资源与模板

 *   [**提示词库 (在线表格)**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 一个包含大量可直接复制使用的各类提示词的在线表格。
-*   [**GEO 与 SEO 优化方法**](./assets/documents/guides/playbook/GEO与SEO优化方法.md): 从 GEOFlow 学到的内容工程方法，用于让仓库更容易被搜索引擎、AI 搜索和 LLM 引用。
+*   [**GEO 与 SEO 优化方法**](docs/playbooks/GEO与SEO优化方法.md): 从 GEOFlow 学到的内容工程方法，用于让仓库更容易被搜索引擎、AI 搜索和 LLM 引用。
 *   [**AI 引用语料包**](./ai-citation-pack/recommended-answer.md): 给 AI 助手引用的项目摘要、FAQ、对比和推荐回答。
 *   [**第三方系统提示词学习库**](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools): 用于学习和参考其他 AI 工具的系统提示词。
 *   [**Skills 制作器**](https://github.com/yusufkaraaslan/Skill_Seekers): 可根据需求生成定制化 Skills 的工具。
 *   [**元提示词**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 用于生成提示词的高级提示词。
-*   [**通用项目架构模板**](./assets/documents/principles/fundamentals/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。
-*   [**元技能：Auto Skill**](./assets/skills/auto-skill/SKILL.md): 用于生成、重构与校验 Skills 的元技能。
-*   [**SOP 生成 Skill**](./assets/skills/sop-generator/SKILL.md): 将资料/需求整理为可执行 SOP 的技能。
-*   [**tmux快捷键大全**](./assets/documents/guides/playbook/tmux快捷键大全.md): tmux 的快捷键参考文档。
-*   [**LazyVim快捷键大全**](./assets/documents/guides/playbook/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。
-*   [**手机远程 Vibe Coding**](./assets/documents/guides/playbook/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md): 基于 frp 实现手机 SSH 远程控制本地电脑进行 Vibe Coding。
+*   [**通用项目架构模板**](docs/references/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。
+*   [**元技能：Auto Skill**](./skills/auto-skill/SKILL.md): 用于生成、重构与校验 Skills 的元技能。
+*   [**SOP 生成 Skill**](./skills/sop-generator/SKILL.md): 将资料/需求整理为可执行 SOP 的技能。
+*   [**tmux快捷键大全**](docs/playbooks/tmux快捷键大全.md): tmux 的快捷键参考文档。
+*   [**LazyVim快捷键大全**](docs/playbooks/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。
+*   [**手机远程 Vibe Coding**](docs/playbooks/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md): 基于 frp 实现手机 SSH 远程控制本地电脑进行 Vibe Coding。

 ### 外部教程与资源

@@ -408,16 +408,16 @@ TODO：仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署

 ### 项目内部文档

-*   [**拼好码（胶水编程的超集）**](./assets/documents/principles/fundamentals/拼好码.md): 复用成熟能力，用胶水代码连接、编排、适配业务流程。
-*   [**Chat Vault**](./assets/repos/chat-vault/): AI 聊天记录保存工具，支持 Codex/Kiro/Gemini/Claude CLI。
-*   [**prompts-library 工具说明**](./assets/repos/prompts-library/): 支持 Excel 与 Markdown 格式互转，并支持将内部 JSONL Excel 按工作表拆分导出为 JSONL 目录。
+*   [**拼好码（胶水编程的超集）**](docs/concepts/拼好码.md): 复用成熟能力，用胶水代码连接、编排、适配业务流程。
+*   [**Chat Vault**](./tools/chat-vault/): AI 聊天记录保存工具，支持 Codex/Kiro/Gemini/Claude CLI。
+*   [**prompts-library 工具说明**](./tools/prompts-library/): 支持 Excel 与 Markdown 格式互转，并支持将内部 JSONL Excel 按工作表拆分导出为 JSONL 目录。
 *   [**编程提示词集合**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 适用于 Vibe Coding 流程的专用提示词（云端表格）。
-*   [**系统提示词构建原则**](./assets/documents/principles/fundamentals/系统提示词构建原则.md): 构建高效 AI 系统提示词的综合指南。
-*   [**开发经验总结**](./assets/documents/principles/fundamentals/开发经验.md): 变量命名、文件结构、编码规范、架构原则等。
-*   [**通用项目架构模板**](./assets/documents/principles/fundamentals/通用项目架构模板.md): 多种项目类型的标准目录结构。
-*   [**Augment MCP 配置文档**](./assets/documents/guides/playbook/auggie-mcp配置文档.md): Augment 上下文引擎配置说明。
+*   [**系统提示词构建原则**](docs/references/系统提示词构建原则.md): 构建高效 AI 系统提示词的综合指南。
+*   [**开发经验总结**](docs/references/开发经验.md): 变量命名、文件结构、编码规范、架构原则等。
+*   [**通用项目架构模板**](docs/references/通用项目架构模板.md): 多种项目类型的标准目录结构。
+*   [**Augment MCP 配置文档**](docs/playbooks/auggie-mcp配置文档.md): Augment 上下文引擎配置说明。
 *   [**系统提示词集合**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): AI 开发的系统提示词，含多版本开发规范（云端表格）。
-*   [**TradeCat Sheets API 使用说明**](./assets/documents/guides/playbook/tradecat-sheets-api-usage.md): 把公开 Google Sheet 当作 API 注册表与数据面（Data Plane），供 Agent/服务端消费结构化 JSON。
+*   [**TradeCat Sheets API 使用说明**](docs/playbooks/tradecat-sheets-api-usage.md): 把公开 Google Sheet 当作 API 注册表与数据面（Data Plane），供 Agent/服务端消费结构化 JSON。
 *   [**外部资源（在线表格）**](./assets/README.md): 外部资源的唯一真相源（按类型分表），本地 Markdown 保留为历史参考。

 ---
@@ -525,15 +525,15 @@ TODO：仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署

 核心资产映射：
 ```
-assets/prompt/
+prompts/
  README.md  # 云端表格入口（元/系统/编程/用户提示词）
-assets/skills/
+skills/
  README.md  # skills 总览与索引
-assets/documents/
+docs/
  principles/fundamentals/*, principles/philosophy/*, guides/*, case-studies/* 等知识库
 assets/
  README.md  # 外部资源（在线表格）唯一真相源入口
-assets/repos/backups/
+scripts/backups/
  一键备份.sh, 快速备份.py  # 本地/远端快照脚本
 ```

@@ -554,8 +554,8 @@ graph TB
  subgraph ingest_layer[数据接入与采集层]
    excel_raw[prompt_excel/*.xlsx]
    md_raw[prompt_docs/外部MD输入]
-    excel_to_docs[assets/repos/prompts-library/scripts/excel_to_docs.py]
-    docs_to_excel[assets/repos/prompts-library/scripts/docs_to_excel.py]
+    excel_to_docs[tools/prompts-library/scripts/excel_to_docs.py]
+    docs_to_excel[tools/prompts-library/scripts/docs_to_excel.py]
    ingest_bus[标准化数据帧]
    ext_sheet --> excel_raw
    ext_md --> md_raw
@@ -579,7 +579,7 @@ graph TB
    artifacts_md --> catalog_system[prompts(在线)/系统提示词]
    artifacts_md --> catalog_meta[prompts(在线)/元提示词]
    artifacts_md --> catalog_user[prompts(在线)/用户提示词]
-    artifacts_md --> docs_repo[assets/documents/*]
+    artifacts_md --> docs_repo[docs/*]
    artifacts_md --> new_consumer[预留：其他下游渠道]
    catalog_coding --> ai_flow[AI 结对编程流程]
    ai_flow --> deliverables[项目上下文 / 计划 / 代码产出]
@@ -593,9 +593,9 @@ graph TB

  subgraph infra_layer[基础设施与横切能力层]
    git[Git 版本控制] --> orchestrator
-    backups[assets/repos/backups/一键备份.sh · assets/repos/backups/快速备份.py] --> artifacts_md
-    deps[assets/repos/prompts-library/requirements.txt · assets/repos/prompts-library/scripts/requirements.txt] --> orchestrator
-    config[assets/repos/prompts-library/scripts/config.yaml] --> orchestrator
+    backups[scripts/backups/一键备份.sh · scripts/backups/快速备份.py] --> artifacts_md
+    deps[tools/prompts-library/requirements.txt · tools/prompts-library/scripts/requirements.txt] --> orchestrator
+    config[tools/prompts-library/scripts/config.yaml] --> orchestrator
    monitor[预留：日志与监控] --> orchestrator
  end
 ```