chore: repo - migrate external tools

.gitmodules

@@ -1,9 +1,9 @@
-[submodule "libs/external/.tmux"]
+[submodule "repo/libs/external/.tmux"]
-	path = libs/external/.tmux
+	path = repo/libs/external/.tmux
 	url = https://github.com/gpakosz/.tmux.git
-[submodule "libs/external/tmux"]
+[submodule "repo/libs/external/tmux"]
-	path = libs/external/tmux
+	path = repo/libs/external/tmux
 	url = https://github.com/tmux/tmux.git
-[submodule "libs/external/claude-official-skills"]
+[submodule "repo/libs/external/claude-official-skills"]
-	path = libs/external/claude-official-skills
+	path = repo/libs/external/claude-official-skills
 	url = https://github.com/anthropics/skills.git

AGENTS.md

@@ -65,7 +65,7 @@ git push origin develop
 | `make lint` | 校验全仓库 Markdown | 需安装 markdownlint-cli |
 | `bash backups/一键备份.sh` | 创建完整项目备份 | 无 |
 | `python3 backups/快速备份.py` | Python 版备份脚本 | Python 3.8+ |
-| `cd libs/external/prompts-library && python3 main.py` | 提示词格式转换 | pandas, openpyxl, PyYAML |
+| `cd repo/libs/external/prompts-library && python3 main.py` | 提示词格式转换 | pandas, openpyxl, PyYAML |
 
 ### prompts-library 支持的转换模式
 1. Excel → Docs：将 Excel 工作簿转换为 Markdown 文档目录
@@ -90,11 +90,11 @@ git push origin develop
 - `config/` - 工具与开发配置（例如 Codex CLI）
 - `tools/` - 预留：自定义脚本/小工具（保持可替换、可审计）
 - `libs/common/` - 通用模块
-- `libs/external/` - 外部工具与依赖
+- `repo/libs/external/` - 外部工具与依赖
 
 ### 依赖添加规则
 - 新增工具或库时记录安装方式、最小版本与来源
-- 外部依赖来源记录在 `libs/external/` 目录下
+- 外部依赖来源记录在 `repo/libs/external/` 目录下
 - 引入第三方脚本需标明许可证与来源
 
 ### 禁止行为
@@ -184,18 +184,15 @@ git push origin develop
 ├── libs/                        # 核心库代码
 │   ├── common/                  # 通用模块
 │   │   ├── models/              # 模型定义
-│   │   └── utils/               # 工具函数
+│   │   └── utils/               # 工具函数（预留）
-│   ├── database/                # 数据库模块（预留）
+│   └── database/                # 数据库模块（预留）
-│   └── external/                # 外部工具
+│
-│       ├── prompts-library/     # Excel ↔ Markdown 互转工具
+├── repo/                        # 可执行代码与外部依赖镜像
-│       ├── chat-vault/          # AI 聊天记录保存工具
+│   └── libs/
-│       ├── Skill_Seekers-development/ # Skills 制作器
+│       ├── external/            # 外部工具（含 Git submodule）
-│       ├── html-tools-main/     # HTML 工具集（Markdown 编辑器、任务卡片生成等）
+│       └── common/
-│       ├── .tmux/               # oh-my-tmux (submodule)
+│           └── utils/
-│       ├── tmux/                # tmux 源码 (submodule)
+│               └── backups/     # 历史备份脚本快照
-│       ├── my-nvim/             # Neovim 配置
-│       ├── MCPlayerTransfer/    # MC 玩家迁移工具
-│       └── XHS-image-to-PDF-conversion/ # 小红书图片转 PDF
 │
 ├── tools/                       # 工具目录（预留）
 │   └── .gitkeep                 # 保持空目录被 Git 追踪
@@ -210,7 +207,7 @@ git push origin develop
 ### 关键入口文件
 - `README.md` - 项目主文档，面向人类开发者
 - `AGENTS.md` - AI Agent 操作手册（本文件）
-- `libs/external/prompts-library/main.py` - 提示词转换工具入口
+- `repo/libs/external/prompts-library/main.py` - 提示词转换工具入口
 - `backups/一键备份.sh` - 备份脚本入口
 - `skills/tmux-autopilot/` - tmux 自动化操控技能（基于 oh-my-tmux，含 capture-pane/send-keys/蜂群巡检脚本）
 - `skills/sop-generator/` - SOP 生成与规范化技能（输入资料/需求 -> 标准 SOP）
@@ -284,7 +281,7 @@ feat|fix|docs|chore|refactor|test: scope - summary
 
 ```bash
 # 提示词库转换
-cd libs/external/prompts-library && python3 main.py
+cd repo/libs/external/prompts-library && python3 main.py
 
 # Lint 所有 Markdown 文件
 make lint
@@ -299,8 +296,8 @@ bash backups/一键备份.sh
 - **`prompts/`**: 提示词库（指向云端表格）
 - **`skills/`**: 扁平化技能库（详见 skills/README.md）
 - **`documents/`**: 知识库（05-哲学与方法论、00-基础指南、01-入门指南、02-方法论、03-实战、04-资源）
-- **`libs/external/prompts-library/`**: Excel ↔ Markdown 转换工具
+- **`repo/libs/external/prompts-library/`**: Excel ↔ Markdown 转换工具
-- **`libs/external/chat-vault/`**: AI 聊天记录保存工具
+- **`repo/libs/external/chat-vault/`**: AI 聊天记录保存工具
 - **`backups/`**: 备份脚本与存档
 
 ### Key Technical Details

README.md

@@ -49,7 +49,7 @@
   <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="https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools"><img src="https://img.shields.io/badge/🔧_系统提示词-仓库-slateblue?style=for-the-badge" alt="系统提示词仓库"></a>
-  <a href="./libs/external/chat-vault/README.md"><img src="https://img.shields.io/badge/🔐_Chat_Vault-AI会话库-gold?style=for-the-badge" alt="Chat Vault"></a>
+  <a href="./repo/libs/external/chat-vault/README.md"><img src="https://img.shields.io/badge/🔐_Chat_Vault-AI会话库-gold?style=for-the-badge" alt="Chat Vault"></a>
 </p>
 
 [📋 工具与资源](#tools)
@@ -330,8 +330,8 @@ Canvas方式：**代码 ⇄ 白板 ⇄ AI ⇄ 人类**，白板成为单一真
 ### 项目内部文档
 
 *   [**胶水编程 (Glue Coding)**](./documents/00-基础指南/): 软件工程的圣杯与银弹，Vibe Coding 的终极进化形态。
-*   [**Chat Vault**](./libs/external/chat-vault/): AI 聊天记录保存工具，支持 Codex/Kiro/Gemini/Claude CLI。
+*   [**Chat Vault**](./repo/libs/external/chat-vault/): AI 聊天记录保存工具，支持 Codex/Kiro/Gemini/Claude CLI。
-*   [**prompts-library 工具说明**](./libs/external/prompts-library/): 支持 Excel 与 Markdown 格式互转，包含数百个精选提示词。
+*   [**prompts-library 工具说明**](./repo/libs/external/prompts-library/): 支持 Excel 与 Markdown 格式互转，包含数百个精选提示词。
 *   [**编程提示词集合**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 适用于 Vibe Coding 流程的专用提示词（云端表格）。
 *   [**系统提示词构建原则**](./documents/00-基础指南/系统提示词构建原则.md): 构建高效 AI 系统提示词的综合指南。
 *   [**开发经验总结**](./documents/00-基础指南/开发经验.md): 变量命名、文件结构、编码规范、架构原则等。

documents/03-实战/fate-engine-dev/prompt-system-bazi-kline.md

@@ -1,6 +1,6 @@
 # 人生K线 LLM 系统提示词（完整原文）
 
-以下内容对应 `libs/external/web/lifekline-main/constants.ts` 中的 `BAZI_SYSTEM_INSTRUCTION` 字符串，已原样展开，便于单独查看与复用。
+以下内容对应 `repo/libs/external/web/lifekline-main/constants.ts` 中的 `BAZI_SYSTEM_INSTRUCTION` 字符串，已原样展开，便于单独查看与复用。
 
 ```
 你是一位八字命理大师，精通加密货币市场周期。根据用户提供的四柱干支和大运信息，生成"人生K线图"数据和命理报告。
@@ -44,4 +44,3 @@
 # 使用说明
 - 作为 `system` 消息传入 `/chat/completions`，禁止模型输出 Markdown 代码块（由 `geminiService` 再次强调）。
 - 保证 共x条（x = 全部流月数量） 条 `chartPoints`，并严格执行 `reason` 字数与评分波动要求。
-

documents/03-实战/fate-engine-dev/prompt-user-bazi-kline.md

@@ -1,6 +1,6 @@
 # 人生K线 LLM 用户提示词模板（完整原文）
 
-本文件摘自 `libs/external/web/lifekline-main/services/geminiService.ts` 中 `userPrompt` 拼装逻辑，已替换为模板变量，便于直接复用。
+本文件摘自 `repo/libs/external/web/lifekline-main/services/geminiService.ts` 中 `userPrompt` 拼装逻辑，已替换为模板变量，便于直接复用。
 
 ```
 请根据以下**已经排好的**八字四柱和**指定的大运信息**进行分析。
@@ -51,4 +51,3 @@
 - 作为 `user` 消息传入 `/chat/completions`，与系统提示词配套使用。
 - 变量含义：`genderStr` 由性别+乾坤文字组成；`startAgeInt` 为起运年龄整数；`directionExample` 随顺/逆行变化；其余变量直接取用户输入或排盘结果。
 - 输出需为纯 JSON，`geminiService` 会自动剥离代码块并校验 `chartPoints`。
-

libs/README.md

@@ -1,9 +1,8 @@
-# 📦 通用库与外部集成 (libs)
+# 📦 通用库 (libs)
 
-`libs/` 用来放两类东西：
+`libs/` 只用于收纳**内部可复用的胶水代码**：小而稳、低耦合、可替换。
 
-1. **内部可复用的胶水代码**：小而稳、低耦合、可替换（`common/`）
+第三方工具与外部集成已迁移至：`repo/libs/external/`。
-2. **第三方工具与外部集成**：尽量保持原样、只做最薄适配（`external/`）
 
 `database/` 预留未来的数据持久化层（当前仅占位）。
 
@@ -17,23 +16,10 @@ libs/
 │   ├── __init__.py
 │   ├── models/
 │   │   └── __init__.py
-│   └── utils/
-│       └── backups/
-│           ├── README.md
-│           ├── 快速备份.py
-│           └── 一键备份.sh
 ├── database/
 │   ├── README.md
 │   └── .gitkeep
-└── external/
+└── (外部工具迁移至 repo/libs/external/)
-    ├── README.md
-    ├── chat-vault/
-    ├── prompts-library/
-    ├── l10n-tool/
-    ├── my-nvim/
-    ├── MCPlayerTransfer/
-    ├── XHS-image-to-PDF-conversion/
-    └── .gitkeep
 ```
 
 ## 子目录职责与边界
@@ -51,20 +37,16 @@ libs/
 - 目标是把“存储细节”关进盒子里：连接、迁移、查询适配、事务边界
 - 约定：实现前先写清楚目录结构与边界（见 `libs/database/README.md`）
 
-### `external/`：第三方工具与外部集成
+### 外部工具与集成（已迁移）
 
-- 入口：[`external/README.md`](./external/README.md)
+- 外部工具/第三方项目统一收敛到：`repo/libs/external/`
-- 尽量保持第三方代码原样，避免“魔改后不可升级”
+- 原则：尽量保持第三方代码原样，避免“魔改后不可升级”
-- 每个工具目录至少包含：`README.md`（用途/入口/依赖）与许可证/来源说明
-- 约定：新增外部工具时，同步更新 `libs/external/README.md`
 
 ## 常用入口
 
-- AI 聊天记录保存：
+- AI 聊天记录保存：`repo/libs/external/chat-vault/`（支持 Codex/Kiro/Gemini/Claude CLI）
-  [`external/chat-vault/`](./external/chat-vault/)（支持 Codex/Kiro/Gemini/Claude CLI）
+- 提示词批量管理：`repo/libs/external/prompts-library/`（配合 `prompts/` 使用）
-- 提示词批量管理：
+- 备份工具：优先使用仓库根目录的 `backups/`；历史脚本在 `repo/libs/common/utils/backups/`
-  [`external/prompts-library/`](./external/prompts-library/)（配合 `../prompts/` 使用）
-- 备份工具：优先使用仓库根目录的 `backups/`（当前与 `libs/common/utils/backups/` 内容一致）
 
 ## 贡献约定（最小要求）
 

prompts/AGENTS.md

@@ -29,4 +29,4 @@
 
 ## 相关工具
 
-- `libs/external/prompts-library/` - Excel ↔ Markdown 互转工具
+- `repo/libs/external/prompts-library/` - Excel ↔ Markdown 互转工具

prompts/README.md

@@ -25,7 +25,8 @@
 
 - [技能库](../skills/) - 比提示词更高级的能力封装
 - [文档库](../documents/) - 方法论与开发经验
-- [prompts-library 工具](../libs/external/prompts-library/) - Excel ↔ Markdown 互转工具
+- [prompts-library 工具](../repo/libs/external/prompts-library/)  
+  Excel ↔ Markdown 互转工具
 
 ## 原版表格
 

repo/AGENTS.md

@@ -0,0 +1,21 @@
+# repo/ 目录 Agent 指南
+
+本目录用于收纳**可执行代码与外部依赖镜像**，将“知识库/提示词/技能”与“代码/第三方工具”做物理隔离，便于迁移与审计。
+
+## 目录结构（当前）
+
+```text
+repo/
+├── AGENTS.md
+└── libs/
+    ├── external/                  # 第三方工具与外部集成（含 Git submodule）
+    └── common/
+        └── utils/
+            └── backups/           # 历史备份脚本快照（README + 脚本）
+```
+
+## 操作规范
+
+- `repo/libs/external/`：尽量原样保留外部项目，优先使用 Git submodule 管理上游。
+- `repo/libs/common/utils/backups/`：只做“脚本快照/参考”；常用备份优先使用仓库根目录 `backups/`。
+- 若需要更新路径/结构，必须同步更新：根目录 `AGENTS.md`、`README.md` 及本文件，保证“文档即真相源”。

repo/libs/external/AGENTS.md

@@ -1,11 +1,11 @@
-# libs/external/ 目录 Agent 指南
+# repo/libs/external/ 目录 Agent 指南
 
 本目录用于收纳 **外部工具/第三方项目**（含 Git submodule），保持“主仓库资产”和“外部依赖”边界清晰、可审计、可更新。
 
 ## 目录结构（约定）
 
 ```text
-libs/external/
+repo/libs/external/
 ├── AGENTS.md                         # 本文件（目录级行为准则）
 ├── README.md                         # 外部工具索引
 ├── .tmux/                            # submodule：oh-my-tmux 配置
@@ -24,4 +24,3 @@ libs/external/
 
 - 直接复制粘贴大型第三方仓库内容到主仓库（优先 submodule）
 - 将 submodule 替换为本地绝对路径软链接（会导致他人环境不可用）
-

repo/libs/external/README.md

@@ -1,6 +1,6 @@
-# 🔌 libs/external：外部集成与第三方工具
+# 🔌 repo/libs/external：外部集成与第三方工具
 
-`libs/external/` 用来收纳第三方工具、外部依赖与集成模块。核心原则是：
+`repo/libs/external/` 用来收纳第三方工具、外部依赖与集成模块。核心原则是：
 
 - **尽量原样保留**：避免“魔改后不可升级”
 - **隔离依赖与风险**：外部工具的依赖不要污染主仓库
@@ -9,7 +9,7 @@
 ## 目录结构
 
 ```
-libs/external/
+repo/libs/external/
 ├── README.md
 ├── chat-vault/                                  # AI 聊天记录保存工具
 ├── prompts-library/                             # 提示词库管理工具（Excel ↔ Markdown）
@@ -33,7 +33,7 @@ libs/external/
 
 ## 新增外部工具（最小清单）
 
-1. 创建目录：`libs/external/<tool-name>/`
+1. 创建目录：`repo/libs/external/<tool-name>/`
 2. 必备文件：`README.md`（用途/入口/依赖/输入输出）、许可证与来源说明（如 `LICENSE` / `SOURCE.md`）
 3. 依赖约束：尽量使用工具自带的虚拟环境/容器化方式，不影响仓库其他部分
 4. 文档同步：在本 README 增加一行工具说明，保证可发现性