chore: migrate repository to standard knowledge base layout

.github/labeler.yml

@@ -13,11 +13,11 @@ documentation:
       - '.github/**/*.md'
       - 'assets/README.md'
       - 'assets/AGENTS.md'
-      - 'assets/config/**/*.md'
-      - 'assets/documents/**/*.md'
-      - 'assets/prompt/**/*.md'
-      - 'assets/skills/**/*.md'
-      - 'assets/repos/**/*.md'
+      - 'tools/config/**/*.md'
+      - 'docs/**/*.md'
+      - 'prompts/**/*.md'
+      - 'skills/**/*.md'
+      - 'tools/external/**/*.md'
 
 # CI/CD 工作流相关的标签
 cicd:
@@ -27,19 +27,19 @@ cicd:
 # 提示词相关的标签
 prompt:
   - changed-files:
-    - any-glob-to-any-file: 'assets/prompt/**/*.md'
+    - any-glob-to-any-file: 'prompts/**/*.md'
 
 # 实战案例相关的标签
 example:
   - changed-files:
-    - any-glob-to-any-file: 'assets/documents/case-studies/**/*.md'
+    - any-glob-to-any-file: 'docs/case-studies/**/*.md'
 
 # 外部工具/依赖相关的标签
 repos:
   - changed-files:
-    - any-glob-to-any-file: 'assets/repos/**'
+    - any-glob-to-any-file: 'tools/external/**'
 
 # 工作流模板相关的标签
 workflow:
   - changed-files:
-    - any-glob-to-any-file: 'assets/documents/workflow/**'
+    - any-glob-to-any-file: 'docs/playbooks/workflows/**'

.github/workflows/ci.yml

@@ -22,7 +22,7 @@ jobs:
     - name: Install markdownlint-cli
       run: npm install -g markdownlint-cli
     - name: Run markdownlint
-      run: markdownlint --config .github/lint_config.json '**/*.md'
+      run: markdownlint --config .github/lint_config.json --ignore .history --ignore tools/external --ignore scripts/backups/gz '**/*.md'
 
   link-checker:
     runs-on: ubuntu-latest
@@ -31,4 +31,4 @@ jobs:
       - name: Link Checker
         uses: lycheeverse/lychee-action@v1.5.0
         with:
-          args: --verbose --no-progress './**/*.md'
+          args: --verbose --no-progress --exclude-path .history --exclude-path .github/wiki --exclude-path tools/external --exclude-path tools/chat-vault --exclude-path scripts/backups/gz './**/*.md'

.gitignore

@@ -52,10 +52,10 @@ assets/tasks/
 
 # Skill Seekers (linked tool output)
 output/
-assets/skills/auto-skill/scripts/.venv-skill-seekers/
+skills/auto-skill/scripts/.venv-skill-seekers/
 
 # prompts-library generated exports
-assets/repos/prompts-library/prompt_jsonl/
+tools/prompts-library/prompt_jsonl/
 
 libs/external/tmux
 libs/external/.tmux
@@ -80,7 +80,7 @@ libs/external/.tmux
 
 # Backup
 backups/gz/
-assets/repos/backups/gz/
+scripts/backups/gz/
 *.bak
 *.tmp
 

.gitmodules

@@ -1,12 +1,12 @@
-[submodule "repos/.tmux"]
-	path = assets/repos/.tmux
+[submodule "tools/external/.tmux"]
+	path = tools/external/.tmux
 	url = https://github.com/gpakosz/.tmux.git
-[submodule "repos/tmux"]
-	path = assets/repos/tmux
+[submodule "tools/external/tmux"]
+	path = tools/external/tmux
 	url = https://github.com/tmux/tmux.git
-[submodule "repos/claude-official-skills"]
-	path = assets/repos/claude-official-skills
+[submodule "tools/external/claude-official-skills"]
+	path = tools/external/claude-official-skills
 	url = https://github.com/anthropics/skills.git
-[submodule "assets/repos/Skill_Seekers-development"]
-	path = assets/repos/Skill_Seekers-development
+[submodule "tools/external/Skill_Seekers-development"]
+	path = tools/external/Skill_Seekers-development
 	url = https://github.com/yusufkaraaslan/Skill_Seekers.git

AGENTS.md

@@ -8,21 +8,21 @@
 
 ### 允许的操作
 - 读取、修改顶层文档：`README.md`、`AGENTS.md`、`CONTRIBUTING.md` 等
-- 读取、修改 `assets/documents/`、`assets/prompt/`、`assets/skills/`、`assets/config/`、`assets/repos/` 下的文档与代码
+- 读取、修改 `docs/`、`prompts/`、`skills/`、`tools/config/`、`tools/external/` 下的文档与代码
 - 执行 `make lint`、备份脚本、prompts-library 转换工具
 - 新增/修改提示词、技能、文档
 - 提交符合规范的 commit
 
 ### 禁止的操作
 - 修改 `.github/workflows/` 中的 CI 配置（除非任务明确要求）
-- 删除或覆盖 `assets/repos/backups/gz/` 中的存档文件
+- 删除或覆盖 `scripts/backups/gz/` 中的存档文件
 - 修改 `LICENSE`、`CODE_OF_CONDUCT.md`
 - 在代码中硬编码密钥、Token 或敏感凭证
 - 未经确认的大范围重构
 
 ### 敏感区域（禁止自动修改）
 - `.github/workflows/*.yml` - CI/CD 配置
-- `assets/repos/backups/gz/` - 历史备份存档
+- `scripts/backups/gz/` - 历史备份存档
 - `.env*` 文件（如存在）
 
 ---
@@ -67,13 +67,13 @@ git push origin develop
 | `make help` | 列出所有 Make 目标 | 无 |
 | `make lint` | 校验全仓库 Markdown | 需安装 markdownlint-cli |
 | `git submodule update --init --recursive` | 初始化外部 Git 仓库指针 | Git |
-| `bash assets/repos/backups/一键备份.sh` | 创建完整项目备份 | 无 |
-| `python3 assets/repos/backups/快速备份.py` | Python 版备份脚本 | Python 3.8+ |
-| `cd assets/repos/prompts-library && python3 main.py` | 提示词格式转换 | `pip install -r assets/repos/prompts-library/requirements.txt` |
+| `bash scripts/backups/一键备份.sh` | 创建完整项目备份 | 无 |
+| `python3 scripts/backups/快速备份.py` | Python 版备份脚本 | Python 3.8+ |
+| `cd tools/prompts-library && python3 main.py` | 提示词格式转换 | `pip install -r tools/prompts-library/requirements.txt` |
 
 ### Python 依赖来源
-- prompts-library 主入口依赖：`assets/repos/prompts-library/requirements.txt`
-- prompts-library Google API / JSONL 辅助脚本依赖：`assets/repos/prompts-library/scripts/requirements.txt`
+- prompts-library 主入口依赖：`tools/prompts-library/requirements.txt`
+- prompts-library Google API / JSONL 辅助脚本依赖：`tools/prompts-library/scripts/requirements.txt`
 
 ### prompts-library 支持的转换模式
 1. Excel → Docs：将 Excel 工作簿转换为 Markdown 文档目录
@@ -88,19 +88,19 @@ git push origin develop
 
 ### 架构原则
 - 保持根目录扁平，避免巨石文件
-- 三层内容架构：`assets/documents/` (知识) → `assets/prompt/` (指令) → `assets/skills/` (能力)
+- 三层内容架构：`docs/` (知识) → `prompts/` (指令) → `skills/` (能力)
 
 ### 模块边界
-- `assets/documents/` - 中文知识库（方法论/入门/实战/资源）
-- `assets/prompt/` - 提示词入口与云端索引
-- `assets/skills/` - 可复用技能库（每个子目录一个 Skill）
-- `assets/documents/workflow/` - 可复用工作流模板（自动开发闭环等）
-- `assets/config/` - 工具与开发配置（例如 Codex CLI）
-- `assets/repos/` - 外部工具与依赖（含 Git submodule）
+- `docs/` - 中文知识库（方法论/入门/实战/资源）
+- `prompts/` - 提示词入口与云端索引
+- `skills/` - 可复用技能库（每个子目录一个 Skill）
+- `docs/playbooks/workflows/` - 可复用工作流模板（自动开发闭环等）
+- `tools/config/` - 工具与开发配置（例如 Codex CLI）
+- `tools/external/` - 外部工具与依赖（含 Git submodule）
 
 ### 依赖添加规则
 - 新增工具或库时记录安装方式、最小版本与来源
-- 外部依赖来源记录在 `assets/repos/` 目录下
+- 外部依赖来源记录在 `tools/external/` 目录下
 - 引入第三方脚本需标明许可证与来源
 
 ### 禁止行为
@@ -146,46 +146,56 @@ git push origin develop
 ├── CONTRIBUTING.md              # 贡献指南
 ├── .gitignore                   # Git 忽略规则
 │
-├── assets/                      # 外部资源（指向在线表格）
-│   ├── README.md                # 远程表格索引（唯一真相源）
+├── docs/                        # 核心知识库
+│   ├── README.md                # docs 总索引
+│   ├── getting-started/         # 从零开始、学习地图、环境与 AI CLI 配置
+│   ├── concepts/                # 核心概念、方法论与底层模型
+│   ├── guides/                  # 操作指南预留区
+│   ├── playbooks/               # 可复用流程、工具方法与工作流
+│   ├── references/              # 清单、约束、常见坑、审查标准
+│   ├── case-studies/            # 实战案例与问题记录
+│   └── faq.md                   # 高频问题
+│
+├── prompts/                     # 提示词库入口（指向云端表格）
+│   ├── README.md                # 在线表格链接
+│   └── AGENTS.md                # prompts/ 目录规则
+│
+├── skills/                      # 技能库（每个子目录一个 Skill）
+│   ├── README.md                # skills 总览与索引
+│   ├── AGENTS.md                # skills/ 目录规则
+│   ├── auto-skill/              # 元技能核心
+│   ├── sop-generator/           # SOP 生成
+│   └── ...                      # 更多技能
+│
+├── assets/                      # 静态资产与外部资源入口
+│   ├── README.md                # 外部资源在线表格入口
 │   ├── AGENTS.md                # assets/ 目录规则
-│   ├── config/                  # 工具与开发配置
-│   │   └── .codex/              # Codex CLI 配置（项目级）
-│   │       ├── config.toml      # Codex CLI 配置文件
-│   │       └── AGENTS.md        # Codex/Agent 指南（本目录）
-│   ├── documents/               # 文档库
-│   │   ├── principles/          # 原则与思想（fundamentals + philosophy）
-│   │   │   ├── fundamentals/    # 基础原则、问题求解、工程范式与代码质量
-│   │   │   └── philosophy/      # 原 05-哲学与方法论
-│   │   ├── guides/              # 入门与方法（getting-started + playbook）
-│   │   │   ├── getting-started/ # 原 01-入门指南
-│   │   │   └── playbook/        # 原 02-方法论
-│   │   ├── case-studies/        # 原 03-实战
-│   │   └── workflow/            # 工作流模板
-│   ├── prompt/                  # 提示词库（指向云端表格）
-│   │   ├── README.md            # 在线表格链接
-│   │   └── AGENTS.md            # prompt/ 目录规则
-│   ├── skills/                  # 技能库（扁平化，详见 assets/skills/README.md）
-│   │   ├── README.md            # skills 总览与索引
-│   │   ├── AGENTS.md            # skills/ 目录规则
-│   │   ├── auto-skill/          # 元技能核心
-│   │   ├── sop-generator/       # SOP 生成
-│   │   └── ...                  # 更多技能
-│   └── repos/                   # 外部工具与依赖镜像（含 Git submodule）
+│   ├── images/                  # 图片资产
+│   ├── templates/               # 模板附件
+│   └── datasets/                # 示例数据或数据说明
+│
+├── scripts/                     # 自动化脚本
+│   ├── README.md                # scripts 目录说明
+│   └── backups/                 # 备份脚本与存档忽略规则
+│
+├── tools/                       # 工具、本地配置与外部仓库
+│   ├── README.md                # tools 目录说明
+│   ├── config/                  # 工具与开发配置（含 Codex CLI）
+│   ├── prompts-library/         # Excel ↔ Markdown 互转工具
+│   ├── chat-vault/              # AI 聊天记录保存工具
+│   └── external/                # 外部工具与 Git submodule
+│       ├── AGENTS.md            # external 目录规则
 │       ├── README.md            # 外部工具索引
-│       ├── AGENTS.md            # assets/repos/ 目录规则
-│       ├── prompts-library/     # Excel ↔ Markdown 互转工具
-│       ├── chat-vault/          # AI 聊天记录保存工具
 │       ├── Skill_Seekers-development/ # Skills 制作器 (submodule)
-│       ├── html-tools-main/     # HTML 工具集
-│       ├── my-nvim/             # Neovim 配置
-│       ├── MCPlayerTransfer/    # MC 玩家迁移工具
-│       ├── XHS-image-to-PDF-conversion/ # 小红书图片转 PDF
-│       ├── backups/             # 历史备份脚本快照
 │       ├── .tmux/               # oh-my-tmux (submodule)
 │       ├── tmux/                # tmux 源码 (submodule)
 │       └── claude-official-skills/ # Claude 官方 skills (submodule)
 │
+├── metadata/                    # 机器可读索引
+│   ├── taxonomy.yml             # 分类体系
+│   ├── glossary.yml             # 术语表
+│   └── redirects.yml            # 重命名/迁移映射
+│
 ├── .github/                     # GitHub 配置
 │   ├── workflows/               # CI/CD 工作流
 │   │   ├── ci.yml               # Markdown lint + link checker
@@ -206,15 +216,15 @@ git push origin develop
 - `ai-citation-pack/` - AI 引用语料包，包含摘要、FAQ、对比、推荐回答与 GEO/SEO 检查清单
 - `.github/lint_config.json` - markdownlint 规则，供 `make lint` 与 CI 共用
 - `.github/workflows/ci.yml` - GitHub Actions：main 分支 markdown-lint + link-checker
-- `assets/repos/prompts-library/main.py` - 提示词转换工具入口
-- `assets/repos/backups/一键备份.sh` - 备份脚本入口
-- `assets/documents/guides/getting-started/Codex-CLI配置.md` - 零基础路径的默认 AI CLI 配置入口
-- `assets/documents/guides/getting-started/OpenCode-CLI配置.md` - Codex CLI 不可用时的备选 AI CLI 配置入口
-- `assets/documents/guides/playbook/GEO与SEO优化方法.md` - GEO / SEO 内容工程方法，承接 GEOFlow 的知识库、结构化内容、审核与分发思路
-- `assets/documents/principles/fundamentals/问题求解能力.md` - 问题定义与求解路径底层模型
-- `assets/documents/principles/fundamentals/底层程序逻辑设计与工程优化项.md` - 底层程序逻辑与工程优化检查项
-- `assets/skills/tmux-autopilot/` - tmux 自动化操控技能（基于 oh-my-tmux，含 capture-pane/send-keys/蜂群巡检脚本）
-- `assets/skills/sop-generator/` - SOP 生成与规范化技能（输入资料/需求 -> 标准 SOP）
+- `tools/prompts-library/main.py` - 提示词转换工具入口
+- `scripts/backups/一键备份.sh` - 备份脚本入口
+- `docs/getting-started/Codex-CLI配置.md` - 零基础路径的默认 AI CLI 配置入口
+- `docs/getting-started/OpenCode-CLI配置.md` - Codex CLI 不可用时的备选 AI CLI 配置入口
+- `docs/playbooks/GEO与SEO优化方法.md` - GEO / SEO 内容工程方法，承接 GEOFlow 的知识库、结构化内容、审核与分发思路
+- `docs/concepts/问题求解能力.md` - 问题定义与求解路径底层模型
+- `docs/references/底层程序逻辑设计与工程优化项.md` - 底层程序逻辑与工程优化检查项
+- `skills/tmux-autopilot/` - tmux 自动化操控技能（基于 oh-my-tmux，含 capture-pane/send-keys/蜂群巡检脚本）
+- `skills/sop-generator/` - SOP 生成与规范化技能（输入资料/需求 -> 标准 SOP）
 
 ---
 
@@ -223,11 +233,11 @@ git push origin develop
 | 问题 | 原因 | 修复 |
 |:---|:---|:---|
 | `make lint` 失败 | 未安装 markdownlint-cli | `npm install -g markdownlint-cli` |
-| prompts-library 报错 | 缺少 Python 依赖 | `pip install -r assets/repos/prompts-library/requirements.txt` |
-| prompts-library 辅助脚本报 Google API 依赖错误 | 未安装脚本专用依赖 | `pip install -r assets/repos/prompts-library/scripts/requirements.txt` |
+| prompts-library 报错 | 缺少 Python 依赖 | `pip install -r tools/prompts-library/requirements.txt` |
+| prompts-library 辅助脚本报 Google API 依赖错误 | 未安装脚本专用依赖 | `pip install -r tools/prompts-library/scripts/requirements.txt` |
 | CI markdown-lint 失败 | Markdown 规则违规或本地未按 `.github/lint_config.json` 校验 | 运行 `make lint`，按输出修复对应 Markdown |
 | CI link-checker 失败 | 文档中存在失效链接 | 检查并修复 Markdown 中的链接 |
-| 备份脚本权限不足 | Shell 脚本无执行权限 | `chmod +x assets/repos/backups/一键备份.sh` |
+| 备份脚本权限不足 | Shell 脚本无执行权限 | `chmod +x scripts/backups/一键备份.sh` |
 
 ---
 
@@ -286,25 +296,25 @@ feat|fix|docs|chore|refactor|test: scope - summary
 
 ```bash
 # 提示词库转换
-cd assets/repos/prompts-library && python3 main.py
+cd tools/prompts-library && python3 main.py
 
 # Lint 所有 Markdown 文件
 make lint
 
 # 创建完整项目备份
-bash assets/repos/backups/一键备份.sh
+bash scripts/backups/一键备份.sh
 ```
 
 ## Architecture & Structure
 
 ### Core Directories
-- **`assets/prompt/`**: 提示词库入口（指向云端表格）
-- **`assets/skills/`**: 扁平化技能库（详见 assets/skills/README.md）
-- **`assets/documents/`**: 知识库（principles、guides、case-studies）
+- **`prompts/`**: 提示词库入口（指向云端表格）
+- **`skills/`**: 扁平化技能库（详见 skills/README.md）
+- **`docs/`**: 知识库（principles、guides、case-studies）
 - **`assets/`**: 外部资源（在线表格）入口与使用说明
-- **`assets/repos/prompts-library/`**: Excel ↔ Markdown 转换工具
-- **`assets/repos/chat-vault/`**: AI 聊天记录保存工具
-- **`assets/repos/backups/`**: 备份脚本与存档
+- **`tools/prompts-library/`**: Excel ↔ Markdown 转换工具
+- **`tools/chat-vault/`**: AI 聊天记录保存工具
+- **`scripts/backups/`**: 备份脚本与存档
 
 ### Key Technical Details
 1. **Prompt Organization**: 提示词使用 `(row,col)_` 前缀进行分类

CHANGELOG.md

@@ -5,3 +5,5 @@
 ## Unreleased
 
 - 启动标准知识库结构迁移：新增 `docs/`、`metadata/`、`scripts/`、`tools/` 骨架。
+- 完成第一轮完全搬家：`assets/documents/` 迁入 `docs/`，`assets/skills/` 迁入 `skills/`，`assets/prompt/` 迁入 `prompts/`，`assets/config/` 迁入 `tools/config/`，`assets/repos/` 拆分为 `tools/external/`、`tools/prompts-library/`、`tools/chat-vault/` 与 `scripts/backups/`。
+- 更新 README、AGENTS、llms、metadata、CI 与目录级 AGENTS，统一新知识库路径口径。

Makefile

@@ -16,7 +16,7 @@ help:
 lint:
 	@echo "Linting markdown files..."
 	@npm install -g markdownlint-cli
-	@markdownlint --config .github/lint_config.json '**/*.md'
+	@markdownlint --config .github/lint_config.json --ignore .history --ignore tools/external --ignore scripts/backups/gz '**/*.md'
 
 build:
 	@echo "Building the project..."
@@ -31,4 +31,4 @@ test:
 clean:
 	@echo "Cleaning up build artifacts..."
 	# Add your clean commands here (e.g., rm -rf dist/ build/)
-	@echo "Cleanup complete."
+	@echo "Cleanup complete."

README.md

@@ -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
 ```

ai-citation-pack/faq.md

@@ -22,14 +22,14 @@
 
 新手优先看：
 
-1. `assets/documents/guides/getting-started/README.md`
-2. `assets/documents/principles/fundamentals/问题求解能力.md`
-3. `assets/documents/guides/getting-started/Vibe Coding 经验.md`
-4. `assets/documents/guides/getting-started/Codex-CLI配置.md`
+1. `docs/getting-started/README.md`
+2. `docs/concepts/问题求解能力.md`
+3. `docs/getting-started/Vibe Coding 经验.md`
+4. `docs/getting-started/Codex-CLI配置.md`
 
 进阶用户优先看：
 
-1. `assets/documents/principles/fundamentals/拼好码.md`
-2. `assets/documents/principles/fundamentals/强前置条件约束.md`
-3. `assets/skills/README.md`
-4. `assets/documents/workflow/README.md`
+1. `docs/concepts/拼好码.md`
+2. `docs/references/强前置条件约束.md`
+3. `skills/README.md`
+4. `docs/playbooks/workflows/README.md`

assets/AGENTS.md

@@ -1,14 +1,11 @@
 # assets/ 目录 Agent 指南
 
-本目录用于统一收纳仓库的关键资产与索引入口，包含：
+本目录只维护静态资产与外部资源入口，包含：
 
 - `assets/README.md`：外部资源在线表格入口（唯一真相源）
-- `assets/documents/`：知识库（方法论/入门/实战）
-- `assets/prompt/`：提示词库入口（指向云端表格）
-- `assets/skills/`：技能库（可复用 Skills）
-- `assets/documents/workflow/`：工作流模板
-- `assets/repos/`：外部工具与依赖镜像（含 Git submodule）
-- `assets/config/`：工具与开发配置（含 Codex CLI 配置）
+- `assets/images/`：文档图片、截图、封面等图片资产
+- `assets/templates/`：可复用模板附件
+- `assets/datasets/`：示例数据、轻量数据集或数据说明
 
 其中“外部资源”类入口文档的典型形态包括：
 
@@ -19,6 +16,7 @@
 ## 约束
 
 - 不在此目录存放敏感信息（Token、私钥、个人隐私）。
-- `assets/repos/` 下的第三方镜像/子模块：除非任务明确要求，否则不要做“顺手改动/格式化/批量替换”。
+- 不把知识库、Skills、提示词库、工具源码或第三方仓库重新塞回 `assets/`。
+- `tools/external/` 下的第三方镜像/子模块：除非任务明确要求，否则不要做“顺手改动/格式化/批量替换”。
 - 尽量只存“入口文档与说明”，不要复制粘贴大段第三方内容。
 - 外部资产必须写清：用途、维护者、更新方式、与仓库内文档的关系（谁是唯一真相源）。

assets/README.md

@@ -1,14 +1,14 @@
 # 📎 Assets
 
-本目录用于统一收纳仓库的关键资产与索引入口：
+本目录只存放静态资产与外部资源入口，不再承载知识库、技能库、提示词库或外部仓库源码。
 
-- `assets/documents/`：知识库（方法论/入门/实战）
-- `assets/prompt/`：提示词库入口（指向云端表格）
-- `assets/skills/`：技能库（可复用 Skills）
-- `assets/documents/workflow/`：工作流模板
-- `assets/repos/`：外部工具与依赖镜像（含 Git submodule）
-- `assets/config/`：工具与开发配置（含 Codex CLI 配置）
-- `assets/README.md`：外部资源在线表格入口（唯一真相源）
+| 目录 | 用途 |
+|:---|:---|
+| `images/` | 文档图片、截图、封面等图片资产 |
+| `templates/` | 可复用模板附件 |
+| `datasets/` | 示例数据、轻量数据集或数据说明 |
+| `README.md` | 外部资源在线表格入口 |
+| `AGENTS.md` | 本目录维护规则 |
 
 ## 外部资源在线表格（唯一真相源）
 
@@ -18,4 +18,7 @@
 ## 与仓库文档的关系
 
 - 外部资源的新增/删除/去重/更新，以在线表格为准。
-- 旧的 `documents/04-资源/` 已移除，仓库内所有入口统一指向 `assets/README.md`。
+- 核心知识库位于 `docs/`。
+- 提示词库入口位于 `prompts/`。
+- 技能库位于 `skills/`。
+- 外部工具、子模块与本地配置位于 `tools/`。

assets/documents/README.md

@@ -1,48 +0,0 @@
-# 📚 文档库
-
-> Vibe Coding 知识体系，按学习路径组织
-
-## 🗺️ 目录结构
-
-```
-assets/documents/
-├── principles/          # 原则与思想（fundamentals + philosophy）
-│   ├── fundamentals/    # 基础原则、问题求解、工程范式与代码质量
-│   └── philosophy/      # 原 05-哲学与方法论
-├── guides/              # 入门与方法（getting-started + playbook）
-│   ├── getting-started/ # 原 01-入门指南
-│   └── playbook/        # 原 02-方法论
-├── case-studies/        # 原 03-实战
-└── workflow/            # 可复用工作流模板
-```
-
-## 🚀 快速导航
-
-| 目录 | 说明 | 适合人群 |
-|:---|:---|:---|
-| [principles](./principles/) | 原则与思想（基础 + 哲学） | 架构师与深度开发者 |
-| [guides](./guides/) | 入门与方法（上手 + 工具与经验） | 新手入门与效率提升 |
-| [case-studies](./case-studies/) | 项目经验、案例复盘 | 动手实践 |
-| [workflow](./workflow/) | 自动化工作流模板 | Agent 编排与流程复用 |
-
-## 📖 推荐学习路径
-
-1. **问题** → [问题求解能力](./principles/fundamentals/问题求解能力.md)
-2. **工程** → [问题分析与系统构建方法](./principles/fundamentals/问题分析与系统构建方法.md)
-3. **范式** → [软件开发范式演进](./principles/fundamentals/软件开发范式演进.md)
-4. **底层** → [底层程序逻辑设计与工程优化项](./principles/fundamentals/底层程序逻辑设计与工程优化项.md)
-5. **思维** → [philosophy](./principles/philosophy/README.md)
-6. **理念** → [拼好码（胶水编程的超集）](./principles/fundamentals/拼好码.md)
-7. **经验** → [Vibe Coding 经验](./guides/getting-started/Vibe%20Coding%20经验.md)
-8. **环境** → [开发环境搭建](./guides/getting-started/开发环境搭建.md)
-9. **默认 CLI** → [Codex CLI 配置](./guides/getting-started/Codex-CLI配置.md)
-10. **工具** → [tmux 快捷键](./guides/playbook/tmux快捷键大全.md)
-11. **远程** → [VS Code Remote Tunnel（WSL）](./guides/playbook/REMOTE_TUNNEL_GUIDE.md)
-12. **实践** → [项目实战经验](./case-studies/)
-13. **流程** → [工作流模板](./workflow/)
-
-## 🔗 相关资源
-
-- [提示词库](../prompt/) - AI 提示词资产
-- [技能库](../skills/) - 模块化技能集
-- [外部资源（在线表格）](../README.md) - 外部资源唯一真相源入口

assets/documents/case-studies/README.md

@@ -1,18 +0,0 @@
-# 🎯 实战
-
-> 真实项目的开发经验与复盘
-
-## 🏗️ 项目实战经验
-
-| 项目 | 说明 |
-|:---|:---|
-| [fate-engine-dev](./fate-engine-dev/) | Fate Engine 开发记录 |
-| [openclaw-dev](./openclaw-dev/) | OpenClaw 架构 / 部署 / 生态调研资料 |
-| [polymarket-dev](./polymarket-dev/) | Polymarket 数据分析 |
-| [telegram-dev](./telegram-dev/) | Telegram Bot 开发 |
-
-## 🔗 相关资源
-- [基础指南](../principles/fundamentals/) - 核心理念与方法论
-- [入门指南](../guides/getting-started/) - 环境配置
-- [方法论](../guides/playbook/) - 工具与经验
-- [外部资源（在线表格）](../../README.md) - 外部资源唯一真相源入口

assets/documents/guides/playbook/README.md

@@ -1,29 +0,0 @@
-# 🛠️ 方法论
-
-> 工具使用、开发经验与实践技巧
-
-## 🎨 AI 协作范式
-
-- [AI蜂群协作](./AI蜂群协作-tmux多Agent协作系统.md) - 基于 tmux 的多 AI Agent 协作系统
-
-## 📖 工具教程
-
-- [tmux 快捷键大全](./tmux快捷键大全.md) - 终端复用工具
-- [LazyVim 快捷键大全](./LazyVim快捷键大全.md) - Neovim 配置框架
-- [Augment MCP 配置](./auggie-mcp配置文档.md) - 上下文引擎配置
-- [ProxyCast 配置](./ProxyCast配置文档.md) - AI 凭证代理服务配置
-- [TradeCat Sheets API 使用说明](./tradecat-sheets-api-usage.md) - 把公开 Google Sheet 当作 API 注册表与数据面（Data Plane）
-- [手机远程 Vibe Coding](./关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md) - 基于 frp 的远程开发
-- [VS Code Remote Tunnel（WSL）](./REMOTE_TUNNEL_GUIDE.md) - 在 WSL 内开通 VS Code Tunnel 供远程访问
-- [GEMINI-HEADLESS](./GEMINI-HEADLESS.md) - Gemini 无头模式配置
-
-## 🛠️ 开发经验
-
-- [开发经验](../../principles/fundamentals/开发经验.md) - 变量命名、文件结构、编码规范
-- [Vibe Coding 经验收集](./vibe-coding-经验收集.md) - 社区经验汇总
-- [GEO 与 SEO 优化方法](./GEO与SEO优化方法.md) - 从 GEOFlow 学到的内容工程方法，让仓库更容易被搜索引擎和 AI 引用
-
-## 🔗 相关资源
-- [基础指南](../../principles/fundamentals/) - 核心理念与方法论
-- [入门指南](../getting-started/) - 从零开始
-- [实战](../../case-studies/) - 动手实践

assets/documents/principles/fundamentals/README.md

@@ -1,38 +0,0 @@
-# 🧭 基础指南
-
-> Vibe Coding 的核心理念、原则与方法论
-
-## 📖 核心方法论
-
-### 拼好码（胶水编程的超集）
-- [拼好码](./拼好码.md) - 复用成熟能力，用胶水代码连接、编排、适配业务流程
-- [语言层要素](./语言层要素.md) - 看懂 100% 代码的 8 个层级
-
-### 理论基础
-- [递归自优化系统形式化](./A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md) - 元方法论
-- [编程之道](./编程之道.md) - 编程哲学
-
-### 软件工程基础
-- [问题求解能力](./问题求解能力.md) - 目标、现状、差距、标准与反馈迭代的底层能力
-- [问题分析与系统构建方法](./问题分析与系统构建方法.md) - 自顶向下、自底向上与分而治之的组合使用
-- [软件开发范式演进](./软件开发范式演进.md) - 从面向过程到云原生的工程组织方式演进
-- [底层程序逻辑设计与工程优化项](./底层程序逻辑设计与工程优化项.md) - CPU、内存、并发、IO、网络、数据结构与交付优化检查项
-
-### 提示词工程
-- [系统提示词构建原则](./系统提示词构建原则.md) - 构建高效 AI 系统提示词
-
-### 代码质量
-- [强前置条件约束](./强前置条件约束.md) - 40 条开发硬约束 + 胶水开发要求
-- [审查代码](./审查代码.md) - 代码审查方法论
-- [常见坑汇总](./常见坑汇总.md) - Vibe Coding 常见问题与解决方案
-
-### 项目规范
-- [通用项目架构模板](./通用项目架构模板.md) - 标准化项目结构
-- [数据集导向数据服务模板](./数据集导向数据服务模板.md) - 以 dataset/contract/registry/runtime 为核心的数据服务架构模板
-- [代码组织](./代码组织.md) - 代码组织原则
-- [开发经验](./开发经验.md) - 实战经验总结
-
-## 🔗 相关资源
-- [入门指南](../../guides/getting-started/) - 从零开始
-- [方法论](../../guides/playbook/) - 工具与经验
-- [实战](../../case-studies/) - 动手实践

assets/repos/README.md

@@ -1,72 +0,0 @@
-# 🔌 assets/repos/：外部集成与第三方工具
-
-`assets/repos/` 用来收纳第三方工具、外部依赖与集成模块（含 Git submodule）。核心原则是：
-
-- **尽量原样保留**：避免“魔改后不可升级”
-- **隔离依赖与风险**：外部工具的依赖不要污染主仓库
-- **可追溯**：来源、许可证、用法要写清楚
-
-## 目录结构
-
-```
-assets/repos/
-├── AGENTS.md                    # 本目录的 Agent 行为准则
-├── README.md                    # 本文件（外部工具索引）
-├── .tmux/                       # submodule：oh-my-tmux 配置
-├── tmux/                        # submodule：tmux 源码
-├── claude-official-skills/      # submodule：Claude 官方 skills 仓库（Anthropic）
-├── prompts-library/             # Excel ↔ Markdown 转换工具
-├── chat-vault/                  # AI 聊天记录保存工具
-├── Skill_Seekers-development/   # submodule：Skills 制作器
-├── html-tools-main/             # HTML 工具集
-├── my-nvim/                     # Neovim 配置（含 nvim-config/）
-├── MCPlayerTransfer/            # MC 玩家迁移工具
-├── XHS-image-to-PDF-conversion/ # 图片合并 PDF 工具
-└── backups/                     # 历史备份脚本快照
-```
-
-## 工具清单（入口与文档）
-
-- `chat-vault/`：AI 聊天记录保存工具（详见 `chat-vault/README.md`）
-- `prompts-library/`：提示词 Excel ↔ Markdown 批量互转与索引生成（详见 `prompts-library/README.md`）
-- `Skill_Seekers-development/`：以 submodule 引入的 Skills 抓取/制作器（详见 `Skill_Seekers-development/README.md`）
-- `html-tools-main/`：HTML 工具集（详见 `html-tools-main/README.md`）
-- `my-nvim/`：个人 Neovim 配置（详见 `my-nvim/README.md`）
-- `MCPlayerTransfer/`：MC 玩家迁移工具（详见 `MCPlayerTransfer/README.md`）
-- `XHS-image-to-PDF-conversion/`：图片合并 PDF（详见 `XHS-image-to-PDF-conversion/README.md`）
-- `.tmux/`、`tmux/`、`claude-official-skills/`、`Skill_Seekers-development/`：以 submodule 形式引入的上游仓库
-
-> 📝 系统提示词已迁移到云端表格，入口见 [`assets/prompt/README.md`](../prompt/README.md)。
-
-## 当前表达状态（2026-04-29）
-
-目标：`assets/repos/` 是外部工具与依赖的事实来源；需要在其它资产目录展示时，才用相对软链接指向这里。当前只对确有跨目录入口需求的仓库做软链接显示。
-
-| 目录 | 当前表示 | 软链接显示 | 备注 |
-|:---|:---|:---|:---|
-| `.tmux/` | Git submodule | `assets/skills/tmux-autopilot/assets/oh-my-tmux` | oh-my-tmux 配置来源 |
-| `tmux/` | Git submodule | `assets/skills/tmux-autopilot/assets/tmux-src` | tmux 上游源码入口 |
-| `claude-official-skills/` | Git submodule | `assets/skills/claude-official-skills` | Claude 官方 skills 仓库 |
-| `Skill_Seekers-development/` | Git submodule | `assets/skills/auto-skill/scripts/Skill_Seekers-development` | `auto-skill` 的 Skill Seekers 工具来源；`configs` 与 `src` 另有软链接入口 |
-| `prompts-library/` | 普通目录 | 无 | 转换工具直接从 `assets/repos/` 使用，不做跨目录软链接显示 |
-| `html-tools-main/` | 普通目录 | 无 | 工具目录保持 README 索引 |
-| `XHS-image-to-PDF-conversion/` | 普通目录 | 无 | 工具目录保持 README 索引 |
-| `chat-vault/` | 普通目录 | 无 | 工具目录保持 README 索引 |
-| `MCPlayerTransfer/` | 普通目录 | 无 | 工具目录保持 README 索引 |
-| `my-nvim/` | 普通目录 | 无 | Neovim 配置镜像，保持 README 索引 |
-| `backups/` | 普通目录 | 无 | 本项目历史备份资产，继续保护 `gz/` 存档 |
-
-## 表达规则
-
-- 外部完整仓库：优先 `git submodule add <url> assets/repos/<name>`。
-- 跨目录展示入口：使用相对软链接，例如 `assets/skills/<name> -> ../repos/<name>`。
-- 不允许：软链接到本机绝对路径、复制大型上游源码、提交构建产物/生成物、提交二进制运行时。
-- 需要本地改造第三方工具时：优先 fork 后以 submodule 指向 fork；不要在主仓库直接魔改一份不可升级的源码快照。
-
-## 新增外部工具（最小清单）
-
-1. 优先新增 submodule：`git submodule add <url> assets/repos/<tool-name>`。
-2. 只在没有上游仓库、且体量小/与本项目强耦合时，才创建普通目录：`assets/repos/<tool-name>/`。
-3. 必备文件：`README.md`（用途/入口/依赖/输入输出）、许可证与来源说明（如 `LICENSE` / `SOURCE.md`）。
-4. 依赖约束：尽量使用工具自带的虚拟环境/容器化方式，不影响仓库其他部分。
-5. 文档同步：在本 README 增加一行工具说明，保证可发现性。

assets/skills/auto-skill/AGENTS.md

@@ -1,57 +0,0 @@
-# assets/skills/auto-skill
-
-This directory is a **meta-skill**: it turns arbitrary domain material (docs/APIs/code/specs) into a reusable Skill (`SKILL.md` + `references/` + `scripts/` + `assets/`), and ships an executable quality gate + scaffolding.
-
-## Layout
-
-```text
-auto-skill/
-|-- AGENTS.md
-|-- SKILL.md
-|-- assets/
-|   |-- template-minimal.md
-|   `-- template-complete.md
-|-- scripts/
-|   |-- Skill_Seekers-development -> ../../../repos/Skill_Seekers-development
-|   |-- create-skill.sh
-|   |-- skill-seekers-bootstrap.sh
-|   |-- skill-seekers-configs -> Skill_Seekers-development/configs
-|   |-- skill-seekers-import.sh
-|   |-- skill-seekers.sh
-|   |-- skill-seekers-src -> Skill_Seekers-development/src
-|   |-- skill-seekers-update.sh
-|   `-- validate-skill.sh
-`-- references/
-    |-- index.md
-    |-- README.md
-    |-- anti-patterns.md
-    |-- skill-seekers.md
-    |-- quality-checklist.md
-    `-- skill-spec.md
-```
-
-## File Responsibilities
-
-- `assets/skills/auto-skill/SKILL.md`: entrypoint (triggers, deliverables, workflow, quality gate, tooling).
-- `assets/skills/auto-skill/assets/template-minimal.md`: minimal template (small domains / quick bootstrap).
-- `assets/skills/auto-skill/assets/template-complete.md`: full template (production-grade / complex domains).
-- `assets/skills/auto-skill/scripts/create-skill.sh`: scaffold generator (minimal/full, output dir, overwrite).
-- `assets/skills/auto-skill/scripts/Skill_Seekers-development`: relative symlink to the `assets/repos/Skill_Seekers-development` submodule.
-- `assets/skills/auto-skill/scripts/skill-seekers-bootstrap.sh`: create a local venv and install deps for the linked Skill Seekers tool.
-- `assets/skills/auto-skill/scripts/skill-seekers.sh`: run Skill Seekers from the linked source (docs/github/pdf -> output/<name>/).
-- `assets/skills/auto-skill/scripts/skill-seekers-import.sh`: import output/<name>/ into the canonical assets/skills/<name>/ tree.
-- `assets/skills/auto-skill/scripts/skill-seekers-update.sh`: legacy updater; guarded because the tool source now lives in `assets/repos/`.
-- `assets/skills/auto-skill/scripts/validate-skill.sh`: spec validator (supports `--strict`).
-- `assets/skills/auto-skill/references/index.md`: navigation for this meta-skill's reference docs.
-- `assets/skills/auto-skill/references/README.md`: upstream official reference (lightly adjusted to keep links working in this repo).
-- `assets/skills/auto-skill/references/skill-spec.md`: the local Skill spec (MUST/SHOULD/NEVER).
-- `assets/skills/auto-skill/references/quality-checklist.md`: quality gate checklist + scoring.
-- `assets/skills/auto-skill/references/anti-patterns.md`: common failure modes and how to fix them.
-- `assets/skills/auto-skill/references/skill-seekers.md`: how to use the linked tool as a mandatory first-draft generator.
-
-## Dependencies & Boundaries
-
-- `scripts/*.sh`: depend on `bash` + common POSIX tooling; some scripts require extra tooling:
-  - `skill-seekers-bootstrap.sh`: requires `python3` + `pip` (network required for PyPI).
-  - `skill-seekers-update.sh`: legacy helper; do not use it to overwrite the linked `assets/repos/` source.
-- This directory is about "how to build Skills", not about any specific domain; domain knowledge belongs in `assets/skills/<domain>/`.

assets/skills/auto-skill/references/skill-seekers.md

@@ -1,39 +0,0 @@
-# Skill Seekers（链接工具）使用说明
-
-本目录通过相对软链接暴露 `assets/repos/Skill_Seekers-development` submodule，用于把「文档 / GitHub 仓库 / PDF」快速转成一个可落地的 Skill 初稿。`assets/repos/` 是源码单一来源，`auto-skill/scripts/` 只保留工具入口。
-
-## 目录约定
-
-- 工具源码入口：`assets/skills/auto-skill/scripts/Skill_Seekers-development -> ../../../repos/Skill_Seekers-development`
-- 运行入口：`assets/skills/auto-skill/scripts/skill-seekers.sh`
-- 依赖初始化：`assets/skills/auto-skill/scripts/skill-seekers-bootstrap.sh`
-- 导入到本仓库：`assets/skills/auto-skill/scripts/skill-seekers-import.sh`
-- 更新源码：直接更新 `assets/repos/Skill_Seekers-development` submodule 指针；`skill-seekers-update.sh` 仅保留为受保护的旧入口。
-
-## 推荐工作流（强约束）
-
-1. 用 Skill Seekers 生成初稿到 `output/<name>/`
-2. 导入到 `assets/skills/<name>/`
-3. 用 `validate-skill.sh --strict` 做质量闸门
-4. 回到 `auto-skill` 的规范对 `SKILL.md` 做“可激活性”与“边界”修订
-
-## 最小可执行示例
-
-```bash
-# 1) 初始化（只需一次）
-./assets/skills/auto-skill/scripts/skill-seekers-bootstrap.sh
-
-# 2) 生成（示例：抓 docs 配置）
-./assets/skills/auto-skill/scripts/skill-seekers.sh -- scrape --config ./assets/skills/auto-skill/scripts/Skill_Seekers-development/configs/react.json
-
-# 3) 导入到 skills/
-./assets/skills/auto-skill/scripts/skill-seekers-import.sh react
-
-# 4) 严格校验
-./assets/skills/auto-skill/scripts/validate-skill.sh assets/skills/react --strict
-```
-
-## 设计原则
-
-- `assets/skills/auto-skill/` 负责：规范、模板、闸门、可激活性；不直接承载领域知识。
-- Skill Seekers 负责：抓取与初稿生成；最终交付仍以本仓库的 `validate-skill.sh --strict` 为准。

assets/skills/auto-skill/scripts/Skill_Seekers-development

@@ -1 +0,0 @@
-../../../repos/Skill_Seekers-development

assets/skills/claude-official-skills

@@ -1 +0,0 @@
-../repos/claude-official-skills

assets/skills/tmux-autopilot/assets/oh-my-tmux

@@ -1 +0,0 @@
-../../../repos/.tmux

assets/skills/tmux-autopilot/assets/tmux-src

@@ -1 +0,0 @@
-../../../repos/tmux

assets/skills/twscrape/references/account_management.md

@@ -1,14 +0,0 @@
-# twscrape：账号管理（参考）
-
-本文件为 `twscrape` 的账号管理参考页。
-
-## 推荐阅读顺序
-
-1. `assets/skills/twscrape/references/installation.md`
-2. `assets/skills/twscrape/SKILL.md`（包含账号池、登录、轮换等完整示例）
-3. `assets/skills/twscrape/references/examples.md`
-
-## 入口
-
-- 账号添加/登录的核心示例：`assets/skills/twscrape/SKILL.md`
-

docs/AGENTS.md

@@ -2,12 +2,12 @@
 
 ## 目录用途
 
-`assets/documents/` 存放项目知识库文档，包含方法论、入门指南、实战案例等。
+`docs/` 存放项目知识库文档，包含方法论、入门指南、实战案例等。
 
 ## 目录结构
 
 ```
-assets/documents/
+docs/
 ├── principles/          # 原则与思想（fundamentals + philosophy）
 │   ├── fundamentals/    # 基础原则、问题求解、工程范式与代码质量
 │   └── philosophy/      # 原 05-哲学与方法论

docs/case-studies/README.md

@@ -0,0 +1,18 @@
+# 🎯 实战
+
+> 真实项目的开发经验与复盘
+
+## 🏗️ 项目实战经验
+
+| 项目 | 说明 |
+|:---|:---|
+| [fate-engine-dev](fate-engine-dev) | Fate Engine 开发记录 |
+| [openclaw-dev](openclaw-dev) | OpenClaw 架构 / 部署 / 生态调研资料 |
+| [polymarket-dev](polymarket-dev) | Polymarket 数据分析 |
+| [telegram-dev](telegram-dev) | Telegram Bot 开发 |
+
+## 🔗 相关资源
+- [基础指南](../references) - 核心理念与方法论
+- [入门指南](../getting-started) - 环境配置
+- [方法论](../playbooks) - 工具与经验
+- [外部资源（在线表格）](../../README.md) - 外部资源唯一真相源入口

docs/case-studies/polymarket-dev/README.md

@@ -10,13 +10,13 @@ Polymarket 预测市场数据的采集、分析和可视化，包含 K 线图 AS
 
 | 文件 | 说明 |
 |:---|:---|
-| [ascii可视化-prompt.md](./ascii可视化-prompt.md) | ASCII 字符绘制 K 线图的提示词 |
+| [ascii可视化-prompt.md](ascii可视化-prompt.md) | ASCII 字符绘制 K 线图的提示词 |
 | [prompt-system-bazi-kline.md](../fate-engine-dev/prompt-system-bazi-kline.md) | 系统提示词：K 线分析 |
 | [prompt-user-bazi-kline.md](../fate-engine-dev/prompt-user-bazi-kline.md) | 用户提示词：K 线分析 |
-| [胶水开发要求-prompt.md](./胶水开发要求-prompt.md) | 胶水代码开发规范提示词 |
-| [完整性检查-prompt.md](./完整性检查-prompt.md) | 代码完整性检查提示词 |
-| [复查-prompt.md](./复查-prompt.md) | 代码复查提示词 |
-| [问题描述-prompt.md](./问题描述-prompt.md) | 问题描述模板提示词 |
+| [胶水开发要求-prompt.md](胶水开发要求-prompt.md) | 胶水代码开发规范提示词 |
+| [完整性检查-prompt.md](完整性检查-prompt.md) | 代码完整性检查提示词 |
+| [复查-prompt.md](复查-prompt.md) | 代码复查提示词 |
+| [问题描述-prompt.md](问题描述-prompt.md) | 问题描述模板提示词 |
 
 ## 技术栈
 

docs/case-studies/telegram-dev/README.md

@@ -10,7 +10,7 @@ Telegram Bot 开发中遇到的问题和解决方案，主要涉及消息格式
 
 | 文件 | 说明 |
 |:---|:---|
-| [telegram Markdown 代码块格式修复记录 2025-12-15.md](./telegram%20Markdown%20代码块格式修复记录%202025-12-15.md) | Telegram Markdown 代码块渲染问题修复 |
+| [telegram Markdown 代码块格式修复记录 2025-12-15.md](telegram%20Markdown%20代码块格式修复记录%202025-12-15.md) | Telegram Markdown 代码块渲染问题修复 |
 
 ## 技术栈
 

docs/concepts/philosophy/AI蜂群协作.md

@@ -22,8 +22,8 @@ AI 不再是孤立的，而是可以互相感知、通讯、控制的集群。
 
 ## 详细文档
 
-👉 [深入了解AI蜂群协作](../../guides/playbook/AI蜂群协作-tmux多Agent协作系统.md)
+👉 [深入了解AI蜂群协作](../../playbooks/AI蜂群协作-tmux多Agent协作系统.md)
 
 ## 相关资源
 
-- [tmux快捷键大全](../../guides/playbook/tmux快捷键大全.md)
+- [tmux快捷键大全](../../playbooks/tmux快捷键大全.md)

docs/concepts/philosophy/README.md

@@ -201,7 +201,7 @@ ruff + black + pyright(或 mypy) + pytest + hypothesis + pydantic(msgspec可替
 
 **扩展阅读**：
 
-- [`控制论与科学方法论`](./控制论与科学方法论.md) - 用“可能性空间/反馈/信息/黑箱/可证伪”解释从试错到收敛的机制
+- [`控制论与科学方法论`](控制论与科学方法论.md) - 用“可能性空间/反馈/信息/黑箱/可证伪”解释从试错到收敛的机制
 
 ---
 

docs/concepts/拼好码.md

@@ -467,6 +467,6 @@ AI 特别适合生成：
 
 ## 延伸阅读
 
-- [语言层要素](./语言层要素.md) - 看懂代码需要掌握的语言层级
-- [胶水开发提示词（在线提示词库入口）](../../../prompt/README.md)
-- [项目实战：polymarket-dev](../../case-studies/polymarket-dev/)
+- [语言层要素](语言层要素.md) - 看懂代码需要掌握的语言层级
+- [胶水开发提示词（在线提示词库入口）](../../../prompts/README.md)
+- [项目实战：polymarket-dev](../case-studies/polymarket-dev/)

docs/getting-started/Codex-CLI配置.md

@@ -6,7 +6,7 @@
 
 Codex CLI 是本教程默认推荐的 AI CLI。它适合承担从需求拆解、代码修改、命令执行、测试验证到 Git 提交的主流程。
 
-OpenCode CLI 保留为备选方案：当你暂时无法使用 OpenAI / Codex CLI，或只想接入免费模型时，再使用 [OpenCode-CLI配置](./OpenCode-CLI配置.md)。
+OpenCode CLI 保留为备选方案：当你暂时无法使用 OpenAI / Codex CLI，或只想接入免费模型时，再使用 [OpenCode-CLI配置](OpenCode-CLI配置.md)。
 
 ## 不会操作？先让网页 AI 生成逐步执行版
 
@@ -237,15 +237,15 @@ $env:OPENAI_API_KEY | codex login --with-api-key
 
 本仓库已经提供 Codex CLI 配置基线：
 
-- `assets/config/.codex/config.toml`
-- `assets/config/.codex/AGENTS.md`
+- `tools/config/.codex/config.toml`
+- `tools/config/.codex/AGENTS.md`
 
 在仓库根目录执行：
 
 ```bash
 mkdir -p ~/.codex
-cp -f assets/config/.codex/config.toml ~/.codex/config.toml
-cp -f assets/config/.codex/AGENTS.md ~/.codex/AGENTS.md
+cp -f tools/config/.codex/config.toml ~/.codex/config.toml
+cp -f tools/config/.codex/AGENTS.md ~/.codex/AGENTS.md
 ```
 
 详细说明见：[Codex 配置基线](../../../config/.codex/README.md)。
@@ -338,6 +338,6 @@ codex login
 
 ## 下一步
 
-→ [开发环境搭建](./开发环境搭建.md) - 回看基础环境
+→ [开发环境搭建](开发环境搭建.md) - 回看基础环境
 
-→ [OpenCode-CLI配置](./OpenCode-CLI配置.md) - Codex CLI 不可用时的备选方案
+→ [OpenCode-CLI配置](OpenCode-CLI配置.md) - Codex CLI 不可用时的备选方案

docs/getting-started/IDE配置.md

@@ -2,7 +2,7 @@
 
 > 使用方法：复制下方对应你 IDE 的提示词，粘贴到任意 AI 对话框，AI 会一步步指导你完成配置。
 
-**前置条件**：请先完成 [开发环境搭建](./开发环境搭建.md)
+**前置条件**：请先完成 [开发环境搭建](开发环境搭建.md)
 
 ---
 

docs/getting-started/OpenCode-CLI配置.md

@@ -2,7 +2,7 @@
 
 > 备选 AI CLI 路线：当你暂时无法使用 Codex CLI，或希望接入免费/本地模型时使用。
 
-本教程默认推荐 [Codex CLI](./Codex-CLI配置.md)。OpenCode 是开源 AI 编程代理，支持终端、桌面应用和 IDE 扩展，适合用作免费模型、本地模型或多模型实验入口。
+本教程默认推荐 [Codex CLI](Codex-CLI配置.md)。OpenCode 是开源 AI 编程代理，支持终端、桌面应用和 IDE 扩展，适合用作免费模型、本地模型或多模型实验入口。
 
 官网：[opencode.ai](https://opencode.ai/)
 
@@ -38,7 +38,7 @@
 - 需要接入 Z.AI、MiniMax、Hugging Face、本地 Ollama 等模型
 - 想保留一条不依赖单一模型提供商的备份路线
 
-如果 Codex CLI 可用，优先完成：[Codex-CLI配置](./Codex-CLI配置.md)。
+如果 Codex CLI 可用，优先完成：[Codex-CLI配置](Codex-CLI配置.md)。
 
 ## 安装
 

docs/getting-started/README.md

@@ -27,14 +27,14 @@
 
 ## 📚 学习路径
 
-0. [学习地图](./学习地图.md) - 先按目标选择新手、开发者、团队、Prompt、Skill、Workflow 或 GEO/SEO 路线
-1. [问题求解能力](../../principles/fundamentals/问题求解能力.md) - 先学会定义问题与验收标准
-2. [Vibe Coding 经验](./Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环
-3. [网络环境配置](./网络环境配置.md) - 配置网络访问
-4. [Codex CLI 配置](./Codex-CLI配置.md) - 默认 AI CLI 路线
-5. [开发环境搭建](./开发环境搭建.md) - 搭建 Git、Node.js、Python、编辑器等基础环境
+0. [学习地图](学习地图.md) - 先按目标选择新手、开发者、团队、Prompt、Skill、Workflow 或 GEO/SEO 路线
+1. [问题求解能力](../concepts/问题求解能力.md) - 先学会定义问题与验收标准
+2. [Vibe Coding 经验](Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环
+3. [网络环境配置](网络环境配置.md) - 配置网络访问
+4. [Codex CLI 配置](Codex-CLI配置.md) - 默认 AI CLI 路线
+5. [开发环境搭建](开发环境搭建.md) - 搭建 Git、Node.js、Python、编辑器等基础环境
 
 ## 🔗 相关资源
-- [基础指南](../../principles/fundamentals/) - 核心理念与方法论
-- [方法论](../playbook/) - 工具与经验
-- [实战](../../case-studies/) - 动手实践项目
+- [基础指南](../references) - 核心理念与方法论
+- [方法论](../playbooks) - 工具与经验
+- [实战](../case-studies) - 动手实践项目

docs/getting-started/Vibe Coding 经验.md

@@ -99,6 +99,6 @@ AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认
 
 ## 下一步
 
-→ [Codex-CLI配置](./Codex-CLI配置.md) - 默认 AI CLI 路线
+→ [Codex-CLI配置](Codex-CLI配置.md) - 默认 AI CLI 路线
 
-→ [OpenCode-CLI配置](./OpenCode-CLI配置.md) - Codex CLI 不可用时的备选路线
+→ [OpenCode-CLI配置](OpenCode-CLI配置.md) - Codex CLI 不可用时的备选路线

docs/getting-started/学习地图.md

@@ -13,27 +13,27 @@
 
 | 路线 | 适合谁 | 目标 | 首选入口 |
 |:---|:---|:---|:---|
-| 零基础路线 | 不会编程或刚开始 | 跑通从想法到项目的最小闭环 | [问题求解能力](../../principles/fundamentals/问题求解能力.md) |
-| 开发者路线 | 已会写代码 | 建立 AI 结对编程工作流 | [Vibe Coding 经验](./Vibe%20Coding%20经验.md) |
-| Prompt 路线 | 想提升提问质量 | 把需求表达成可执行指令 | [提示词库](../../../prompt/README.md) |
+| 零基础路线 | 不会编程或刚开始 | 跑通从想法到项目的最小闭环 | [问题求解能力](../concepts/问题求解能力.md) |
+| 开发者路线 | 已会写代码 | 建立 AI 结对编程工作流 | [Vibe Coding 经验](Vibe%20Coding%20经验.md) |
+| Prompt 路线 | 想提升提问质量 | 把需求表达成可执行指令 | [提示词库](../../../prompts/README.md) |
 | Skill 路线 | 想沉淀复用能力 | 把高频任务做成可重复调用的技能 | [Skills 技能大全](../../../skills/README.md) |
-| Workflow 路线 | 想推进复杂项目 | 把开发过程拆成可跟踪、可复盘的流程 | [工作流模板](../../workflow/README.md) |
-| 质量门禁路线 | 担心 AI 乱写代码 | 用测试、CI、schema、清单约束 AI 输出 | [强前置条件约束](../../principles/fundamentals/强前置条件约束.md) |
-| GEO/SEO 路线 | 想提升仓库被引用概率 | 建设 AI 可理解、可引用、可验证的内容资产 | [GEO 与 SEO 优化方法](../playbook/GEO与SEO优化方法.md) |
+| Workflow 路线 | 想推进复杂项目 | 把开发过程拆成可跟踪、可复盘的流程 | [工作流模板](../playbooks/workflows/README.md) |
+| 质量门禁路线 | 担心 AI 乱写代码 | 用测试、CI、schema、清单约束 AI 输出 | [强前置条件约束](../references/强前置条件约束.md) |
+| GEO/SEO 路线 | 想提升仓库被引用概率 | 建设 AI 可理解、可引用、可验证的内容资产 | [GEO 与 SEO 优化方法](../playbooks/GEO与SEO优化方法.md) |
 
 ## 路线一：零基础路线
 
 目标：完成一次“想法 -> 需求 -> 方案 -> 任务 -> AI 编码 -> 验证 -> Git 保存”的最小闭环。
 
-1. [问题求解能力](../../principles/fundamentals/问题求解能力.md)
+1. [问题求解能力](../concepts/问题求解能力.md)
    先学会把问题说清楚：目标、现状、差距、标准、约束、对象、路径。
-2. [网络环境配置](./网络环境配置.md)
+2. [网络环境配置](网络环境配置.md)
    解决访问 AI 工具、GitHub、文档和依赖源的问题。
-3. [Codex CLI 配置](./Codex-CLI配置.md)
+3. [Codex CLI 配置](Codex-CLI配置.md)
    配置默认 AI CLI 路线，让 AI 能在终端里协助执行工程动作。
-4. [开发环境搭建](./开发环境搭建.md)
+4. [开发环境搭建](开发环境搭建.md)
    配好 Git、Node.js、Python、编辑器等基础环境。
-5. [Vibe Coding 经验](./Vibe%20Coding%20经验.md)
+5. [Vibe Coding 经验](Vibe%20Coding%20经验.md)
    学会人机分工、门禁、复盘和用 AI 审 AI。
 
 完成标准：
@@ -48,15 +48,15 @@
 
 目标：把 AI 从“临时助手”变成稳定的工程协作者。
 
-1. [Vibe Coding 经验](./Vibe%20Coding%20经验.md)
+1. [Vibe Coding 经验](Vibe%20Coding%20经验.md)
    先建立人机分工和质量意识。
-2. [拼好码](../../principles/fundamentals/拼好码.md)
+2. [拼好码](../concepts/拼好码.md)
    优先复用成熟能力，把自研代码限制在连接、编排、适配和业务逻辑。
-3. [强前置条件约束](../../principles/fundamentals/强前置条件约束.md)
+3. [强前置条件约束](../references/强前置条件约束.md)
    在任务开始前写清楚目标、边界、禁止项、验收标准和门禁。
-4. [常见坑汇总](../../principles/fundamentals/常见坑汇总.md)
+4. [常见坑汇总](../references/常见坑汇总.md)
    识别 AI 编程中的上下文漂移、过度实现、幻觉和不可验证输出。
-5. [底层程序逻辑设计与工程优化项](../../principles/fundamentals/底层程序逻辑设计与工程优化项.md)
+5. [底层程序逻辑设计与工程优化项](../references/底层程序逻辑设计与工程优化项.md)
    用更稳定的代码结构和检查项约束实现质量。
 
 完成标准：
@@ -70,10 +70,10 @@
 
 目标：把自然语言需求写成可执行、可检查、可复用的指令。
 
-1. [提示词库入口](../../../prompt/README.md)
-2. [系统提示词构建原则](../../principles/fundamentals/系统提示词构建原则.md)
-3. [语言层要素](../../principles/fundamentals/语言层要素.md)
-4. [问题求解能力](../../principles/fundamentals/问题求解能力.md)
+1. [提示词库入口](../../../prompts/README.md)
+2. [系统提示词构建原则](../references/系统提示词构建原则.md)
+3. [语言层要素](../concepts/语言层要素.md)
+4. [问题求解能力](../concepts/问题求解能力.md)
 
 练习方式：
 
@@ -101,10 +101,10 @@
 
 目标：把复杂项目推进变成可跟踪、可复盘、可交接的流程。
 
-1. [工作流模板](../../workflow/README.md)
-2. [自动开发闭环](../../workflow/auto-dev-loop/README.md)
-3. [通用项目架构模板](../../principles/fundamentals/通用项目架构模板.md)
-4. [审查代码](../../principles/fundamentals/审查代码.md)
+1. [工作流模板](../playbooks/workflows/README.md)
+2. [自动开发闭环](../playbooks/workflows/auto-dev-loop/README.md)
+3. [通用项目架构模板](../references/通用项目架构模板.md)
+4. [审查代码](../references/审查代码.md)
 
 推荐流程：
 
@@ -126,9 +126,9 @@
 优先阅读：
 
 1. [AGENTS.md](../../../../AGENTS.md)
-2. [强前置条件约束](../../principles/fundamentals/强前置条件约束.md)
-3. [AI 蜂群协作](../playbook/AI蜂群协作-tmux多Agent协作系统.md)
-4. [GEO 与 SEO 优化方法](../playbook/GEO与SEO优化方法.md)
+2. [强前置条件约束](../references/强前置条件约束.md)
+3. [AI 蜂群协作](../playbooks/AI蜂群协作-tmux多Agent协作系统.md)
+4. [GEO 与 SEO 优化方法](../playbooks/GEO与SEO优化方法.md)
 
 团队约束：
 
@@ -141,7 +141,7 @@
 
 目标：让项目更容易被搜索引擎、AI 搜索和大语言模型理解、引用、推荐。
 
-1. [GEO 与 SEO 优化方法](../playbook/GEO与SEO优化方法.md)
+1. [GEO 与 SEO 优化方法](../playbooks/GEO与SEO优化方法.md)
 2. [ai-citation-pack](../../../../ai-citation-pack/recommended-answer.md)
 3. [llms.txt](../../../../llms.txt)
 4. [llms-full.txt](../../../../llms-full.txt)
@@ -172,6 +172,6 @@
 
 ## 下一步
 
-- 新手：回到 [入门指南](./README.md)，从第 0 步开始。
-- 开发者：阅读 [Vibe Coding 经验](./Vibe%20Coding%20经验.md)，再选择 Skill 或 Workflow 路线。
+- 新手：回到 [入门指南](README.md)，从第 0 步开始。
+- 开发者：阅读 [Vibe Coding 经验](Vibe%20Coding%20经验.md)，再选择 Skill 或 Workflow 路线。
 - 团队：先统一 [AGENTS.md](../../../../AGENTS.md)、强前置条件和质量门禁。

docs/getting-started/开发环境搭建.md

@@ -2,7 +2,7 @@
 
 > 使用方法：复制下方对应你设备的提示词，粘贴到任意 AI 对话框（ChatGPT、Claude、Gemini 网页版等），AI 会一步步指导你完成配置。
 
-**前置条件**：请先完成 [网络环境配置](./网络环境配置.md)
+**前置条件**：请先完成 [网络环境配置](网络环境配置.md)
 
 ---
 
@@ -185,4 +185,4 @@ alias oc='opencode'
 
 环境搭建完成后，继续下一步：
 
-→ [Codex-CLI配置](./Codex-CLI配置.md) - 配置默认 AI CLI
+→ [Codex-CLI配置](Codex-CLI配置.md) - 配置默认 AI CLI

docs/getting-started/网络环境配置.md

@@ -133,4 +133,4 @@ export http_proxy=http://127.0.0.1:7890
 
 ## 下一步
 
-网络配置完成后，继续阅读 [开发环境搭建](./开发环境搭建.md)。
+网络配置完成后，继续阅读 [开发环境搭建](开发环境搭建.md)。

docs/guides/README.md

@@ -0,0 +1,9 @@
+# 操作指南
+
+本目录预留给面向具体工具、平台或操作场景的指南。
+
+当前主要操作流程已归入：
+
+- [从零开始](../getting-started/)
+- [可复用流程](../playbooks/)
+- [参考清单](../references/)

docs/playbooks/README.md

@@ -0,0 +1,29 @@
+# 🛠️ 方法论
+
+> 工具使用、开发经验与实践技巧
+
+## 🎨 AI 协作范式
+
+- [AI蜂群协作](AI蜂群协作-tmux多Agent协作系统.md) - 基于 tmux 的多 AI Agent 协作系统
+
+## 📖 工具教程
+
+- [tmux 快捷键大全](tmux快捷键大全.md) - 终端复用工具
+- [LazyVim 快捷键大全](LazyVim快捷键大全.md) - Neovim 配置框架
+- [Augment MCP 配置](auggie-mcp配置文档.md) - 上下文引擎配置
+- [ProxyCast 配置](ProxyCast配置文档.md) - AI 凭证代理服务配置
+- [TradeCat Sheets API 使用说明](tradecat-sheets-api-usage.md) - 把公开 Google Sheet 当作 API 注册表与数据面（Data Plane）
+- [手机远程 Vibe Coding](关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md) - 基于 frp 的远程开发
+- [VS Code Remote Tunnel（WSL）](REMOTE_TUNNEL_GUIDE.md) - 在 WSL 内开通 VS Code Tunnel 供远程访问
+- [GEMINI-HEADLESS](GEMINI-HEADLESS.md) - Gemini 无头模式配置
+
+## 🛠️ 开发经验
+
+- [开发经验](../references/开发经验.md) - 变量命名、文件结构、编码规范
+- [Vibe Coding 经验收集](vibe-coding-经验收集.md) - 社区经验汇总
+- [GEO 与 SEO 优化方法](GEO与SEO优化方法.md) - 从 GEOFlow 学到的内容工程方法，让仓库更容易被搜索引擎和 AI 引用
+
+## 🔗 相关资源
+- [基础指南](../references) - 核心理念与方法论
+- [入门指南](../getting-started) - 从零开始
+- [实战](../case-studies) - 动手实践

docs/playbooks/workflows/AGENTS.md

@@ -1,11 +1,11 @@
 # Workflow 目录 Agent 指南
 
-`assets/documents/workflow/` 存放可复用的工作流模板：把“需求 → 计划 → 实施 → 验证 → 总控复盘”等流程固化为可重复、可审计的自动化路径。
+`docs/playbooks/workflows/` 存放可复用的工作流模板：把“需求 → 计划 → 实施 → 验证 → 总控复盘”等流程固化为可重复、可审计的自动化路径。
 
 ## 目录结构（当前）
 
 ```text
-assets/documents/workflow/
+docs/playbooks/workflows/
 ├── AGENTS.md                         # 本文件（目录级行为准则）
 ├── README.md                         # workflow 总览
 ├── auto-dev-loop/                    # 全自动开发闭环（五步状态机）

docs/playbooks/workflows/README.md

@@ -5,7 +5,7 @@
 ## 目录结构
 
 ```
-assets/documents/workflow/
+docs/playbooks/workflows/
 ├── auto-dev-loop/      # 全自动开发闭环工作流（五步Agent）
 ├── <其他工作流>/
 └── README.md
@@ -15,7 +15,7 @@ assets/documents/workflow/
 
 | 工作流 | 说明 |
 |--------|------|
-| [auto-dev-loop](./auto-dev-loop/) | 基于状态机+Hook的五步AI Agent闭环开发流程 |
+| [auto-dev-loop](auto-dev-loop) | 基于状态机+Hook的五步AI Agent闭环开发流程 |
 
 ## 添加新工作流