chore: repo - flatten tool mirrors

This commit is contained in:
tukuaiai 2026-02-26 08:05:07 +08:00
parent 675211c864
commit 33b39f6757
402 changed files with 131 additions and 266 deletions

12
.gitmodules vendored
View File

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

View File

@ -8,7 +8,7 @@
### 允许的操作
- 读取、修改顶层文档:`README.md`、`AGENTS.md`、`CLAUDE.md`、`GEMINI.md` 等
- 读取、修改 `documents/`、`prompts/`、`skills/`、`workflow/`、`config/`、`tools/`、`libs/` 下的文档与代码
- 读取、修改 `documents/`、`prompts/`、`skills/`、`workflow/`、`config/`、`tools/`、`repo/` 下的文档与代码
- 执行 `make lint`、备份脚本、prompts-library 转换工具
- 新增/修改提示词、技能、文档
- 提交符合规范的 commit
@ -65,7 +65,7 @@ git push origin develop
| `make lint` | 校验全仓库 Markdown | 需安装 markdownlint-cli |
| `bash backups/一键备份.sh` | 创建完整项目备份 | 无 |
| `python3 backups/快速备份.py` | Python 版备份脚本 | Python 3.8+ |
| `cd repo/libs/external/prompts-library && python3 main.py` | 提示词格式转换 | pandas, openpyxl, PyYAML |
| `cd repo/prompts-library && python3 main.py` | 提示词格式转换 | pandas, openpyxl, PyYAML |
### prompts-library 支持的转换模式
1. Excel → Docs将 Excel 工作簿转换为 Markdown 文档目录
@ -89,12 +89,11 @@ git push origin develop
- `workflow/` - 可复用工作流模板(自动开发闭环等)
- `config/` - 工具与开发配置(例如 Codex CLI
- `tools/` - 预留:自定义脚本/小工具(保持可替换、可审计)
- `libs/common/` - 通用模块
- `repo/libs/external/` - 外部工具与依赖
- `repo/` - 外部工具与依赖(含 Git submodule
### 依赖添加规则
- 新增工具或库时记录安装方式、最小版本与来源
- 外部依赖来源记录在 `repo/libs/external/` 目录下
- 外部依赖来源记录在 `repo/` 目录下
- 引入第三方脚本需标明许可证与来源
### 禁止行为
@ -181,18 +180,20 @@ git push origin develop
│ ├── auto-dev-loop/ # 自动开发循环
│ └── canvas-dev/ # Canvas白板驱动开发
├── libs/ # 核心库代码
│ ├── common/ # 通用模块
│ │ ├── models/ # 模型定义
│ │ └── utils/ # 工具函数(预留)
│ └── database/ # 数据库模块(预留)
├── repo/ # 可执行代码与外部依赖镜像
│ └── libs/
│ ├── external/ # 外部工具(含 Git submodule
│ └── common/
│ └── utils/
│ └── backups/ # 历史备份脚本快照
│ ├── README.md # 外部工具索引
│ ├── AGENTS.md # repo/ 目录规则
│ ├── prompts-library/ # Excel ↔ Markdown 互转工具
│ ├── chat-vault/ # AI 聊天记录保存工具
│ ├── Skill_Seekers-development/ # Skills 制作器
│ ├── 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)
├── tools/ # 工具目录(预留)
│ └── .gitkeep # 保持空目录被 Git 追踪
@ -207,7 +208,7 @@ git push origin develop
### 关键入口文件
- `README.md` - 项目主文档,面向人类开发者
- `AGENTS.md` - AI Agent 操作手册(本文件)
- `repo/libs/external/prompts-library/main.py` - 提示词转换工具入口
- `repo/prompts-library/main.py` - 提示词转换工具入口
- `backups/一键备份.sh` - 备份脚本入口
- `skills/tmux-autopilot/` - tmux 自动化操控技能(基于 oh-my-tmux含 capture-pane/send-keys/蜂群巡检脚本)
- `skills/sop-generator/` - SOP 生成与规范化技能(输入资料/需求 -> 标准 SOP
@ -281,7 +282,7 @@ feat|fix|docs|chore|refactor|test: scope - summary
```bash
# 提示词库转换
cd repo/libs/external/prompts-library && python3 main.py
cd repo/prompts-library && python3 main.py
# Lint 所有 Markdown 文件
make lint
@ -296,8 +297,8 @@ bash backups/一键备份.sh
- **`prompts/`**: 提示词库(指向云端表格)
- **`skills/`**: 扁平化技能库(详见 skills/README.md
- **`documents/`**: 知识库05-哲学与方法论、00-基础指南、01-入门指南、02-方法论、03-实战、04-资源)
- **`repo/libs/external/prompts-library/`**: Excel ↔ Markdown 转换工具
- **`repo/libs/external/chat-vault/`**: AI 聊天记录保存工具
- **`repo/prompts-library/`**: Excel ↔ Markdown 转换工具
- **`repo/chat-vault/`**: AI 聊天记录保存工具
- **`backups/`**: 备份脚本与存档
### Key Technical Details

View File

@ -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="./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>
<a href="./repo/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**](./repo/libs/external/chat-vault/): AI 聊天记录保存工具,支持 Codex/Kiro/Gemini/Claude CLI。
* [**prompts-library 工具说明**](./repo/libs/external/prompts-library/): 支持 Excel 与 Markdown 格式互转,包含数百个精选提示词。
* [**Chat Vault**](./repo/chat-vault/): AI 聊天记录保存工具,支持 Codex/Kiro/Gemini/Claude CLI。
* [**prompts-library 工具说明**](./repo/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): 变量命名、文件结构、编码规范、架构原则等。
@ -418,20 +418,19 @@ Canvas方式**代码 ⇄ 白板 ⇄ AI ⇄ 人类**,白板成为单一真
│ ├── auto-dev-loop/ # 自动开发循环
│ └── canvas-dev/ # Canvas白板驱动开发
├── libs/ # 核心库代码
│ ├── common/ # 通用模块
│ │ ├── models/ # 模型定义
│ │ └── utils/ # 工具函数
│ ├── database/ # 数据库模块(预留)
│ └── external/ # 外部工具
│ ├── prompts-library/ # Excel ↔ Markdown 互转工具
│ ├── chat-vault/ # AI 聊天记录保存工具
│ ├── Skill_Seekers-development/ # Skills 制作器
│ ├── .tmux/ # oh-my-tmux (submodule)
│ ├── tmux/ # tmux 源码 (submodule)
│ ├── my-nvim/ # Neovim 配置
│ ├── MCPlayerTransfer/ # MC 玩家迁移工具
│ └── XHS-image-to-PDF-conversion/ # 小红书图片转 PDF
├── repo/ # 外部工具与依赖镜像(含 Git submodule
│ ├── README.md # 外部工具索引
│ ├── prompts-library/ # Excel ↔ Markdown 互转工具
│ ├── chat-vault/ # AI 聊天记录保存工具
│ ├── Skill_Seekers-development/ # Skills 制作器
│ ├── 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)
├── tools/ # 工具目录(预留)
│ └── .gitkeep # 保持空目录被 Git 追踪
@ -596,7 +595,7 @@ gantt
本指南同时适用于 CLI 终端版本和 VSCode 扩展版本Codex 和 Claude Code 都有扩展,且界面更新)。
*(注:本指南早期版本使用的是 **Grok 3**,后来切换到 **Gemini 2.5 Pro**,现在我们使用的是 **Claude 4.6**(或 **gpt-5.3-codex (xhigh)**)*
*(注:本指南早期版本使用的是 **Grok 3**,后来切换到 **Gemini 3.1 Pro**,现在我们使用的是 **Claude 4.6**(或 **gpt-5.3-codex (xhigh)**)*
*(注2如果你想使用 Cursor请查看本指南的 [1.1 版本](https://github.com/EnzeD/vibe-coding/tree/1.1.1),但我们认为它目前不如 Codex CLI 或 Claude Code 强大)*

View File

@ -1,55 +0,0 @@
# 📦 通用库 (libs)
`libs/` 只用于收纳**内部可复用的胶水代码**:小而稳、低耦合、可替换。
第三方工具与外部集成已迁移至:`repo/libs/external/`。
`database/` 预留未来的数据持久化层(当前仅占位)。
## 目录结构
```text
libs/
├── README.md
├── common/
│ ├── README.md
│ ├── __init__.py
│ ├── models/
│ │ └── __init__.py
├── database/
│ ├── README.md
│ └── .gitkeep
└── (外部工具迁移至 repo/libs/external/)
```
## 子目录职责与边界
### `common/`:内部通用模块
- 入口:[`common/README.md`](./common/README.md)
- 只放 **可复用** 的基础能力:模型、工具函数、脚本等
- 不要把业务逻辑、项目临时代码塞进来
- 约定:新增/调整能力时,同步更新 `libs/common/README.md`
### `database/`:数据库适配层(预留)
- 入口:[`database/README.md`](./database/README.md)
- 目标是把“存储细节”关进盒子里:连接、迁移、查询适配、事务边界
- 约定:实现前先写清楚目录结构与边界(见 `libs/database/README.md`
### 外部工具与集成(已迁移)
- 外部工具/第三方项目统一收敛到:`repo/libs/external/`
- 原则:尽量保持第三方代码原样,避免“魔改后不可升级”
## 常用入口
- AI 聊天记录保存:`repo/libs/external/chat-vault/`(支持 Codex/Kiro/Gemini/Claude CLI
- 提示词批量管理:`repo/libs/external/prompts-library/`(配合 `prompts/` 使用)
- 备份工具:优先使用仓库根目录的 `backups/`;历史脚本在 `repo/libs/common/utils/backups/`
## 贡献约定(最小要求)
1. 新增模块先定义职责边界,再写代码/文档
2. 新增依赖记录安装方式与最低版本(必要时补充到 `documents/工具集.md`
3. 目录结构/职责变化时,更新对应 README保证“文档即真相源”

View File

@ -1,40 +0,0 @@
# 🔧 libs/common通用模块
`libs/common/` 放的是项目内部可复用的“胶水代码”:**小而稳、低耦合、可替换**。这里的目标不是堆功能,而是为仓库提供少量可靠的基础能力。
## 目录结构
```
libs/common/
├── README.md
├── __init__.py
├── models/ # 预留:数据模型(当前仅占位)
│ └── __init__.py
└── utils/
└── backups/ # 基于 .gitignore 的快速备份工具
├── README.md
├── 快速备份.py
└── 一键备份.sh
```
## 现有内容
- `utils/backups/`:快速备份工具(当前与仓库根目录 [`backups/`](../../backups/) 内容一致,用于避免脚本散落各处)
## 约束与约定
1. **不放业务逻辑**`common/` 只提供基础能力与工具
2. **接口要稳**:一旦被引用,就把它当作公开 API 对待
3. **可审计输出**:脚本/工具的输出要可复盘(明确输入、输出路径、失败原因)
4. **新增即文档**:新增模块/目录必须同步更新本 README 与 `libs/README.md`
## 使用方式(当前推荐)
本目录的内容目前主要以“脚本/工具”形式存在,推荐直接运行:
```bash
# 备份当前仓库(建议优先使用根目录 backups/ 入口)
python3 backups/快速备份.py
```
更多参数与说明见:[`../../backups/README.md`](../../backups/README.md)。

View File

@ -1 +0,0 @@
# Common Library

View File

@ -1 +0,0 @@
# Models Module

View File

@ -1 +0,0 @@
# Third-party libraries (read-only)

View File

@ -1,24 +0,0 @@
# 🗄️ libs/database数据库适配层预留
`libs/database/` 预留给未来的“存储适配层”。目标是把数据库的细节(连接、迁移、事务、查询)封装在一个清晰边界内,避免业务代码到处散落 SQL/ORM。
## 设计边界(先写清楚再实现)
- 这里负责连接管理、迁移脚本、ORM/SQL 模型、统一的查询/事务封装
- 这里不负责业务规则、HTTP/API 逻辑、领域对象的复杂编排
## 推荐目录结构(落地时按需取舍)
```
libs/database/
├── README.md
├── __init__.py
├── connection.py # 连接与池化
├── migrations/ # 迁移脚本Alembic/Flyway/自研均可)
├── repositories/ # 数据访问层(可选)
└── models/ # ORM 模型或 SQL schema可选
```
## 何时开始实现
当仓库出现“需要长期保存/查询的数据”且 **文件系统不够用** 时,再把这一层落地;否则保持为空,避免过早引入复杂度。

View File

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

View File

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

View File

@ -1,21 +1,26 @@
# repo/ 目录 Agent 指南
本目录用于收纳**可执行代码与外部依赖镜像**,将“知识库/提示词/技能”与“代码/第三方工具”做物理隔离,便于迁移与审计
本目录用于收纳 **外部工具/第三方项目**(含 Git submodule保持“主仓库资产”和“外部依赖”边界清晰、可审计、可更新
## 目录结构(当前
## 目录结构(约定
```text
repo/
├── AGENTS.md
└── libs/
├── external/ # 第三方工具与外部集成(含 Git submodule
└── common/
└── utils/
└── backups/ # 历史备份脚本快照README + 脚本)
├── AGENTS.md # 本文件(目录级行为准则)
├── README.md # 外部工具索引
├── .tmux/ # submoduleoh-my-tmux 配置
├── tmux/ # submoduletmux 源码
└── claude-official-skills/ # submoduleClaude 官方 skills 仓库Anthropic
```
## 操作规范
- `repo/libs/external/`:尽量原样保留外部项目,优先使用 Git submodule 管理上游。
- `repo/libs/common/utils/backups/`:只做“脚本快照/参考”;常用备份优先使用仓库根目录 `backups/`
- 若需要更新路径/结构,必须同步更新:根目录 `AGENTS.md`、`README.md` 及本文件,保证“文档即真相源”。
### 允许
- 新增外部依赖(优先 Git submodule确保可复现
- 更新 submodule 指针(明确记录上游来源与用途)
### 禁止 / 不推荐
- 直接复制粘贴大型第三方仓库内容到主仓库(优先 submodule
- 将 submodule 替换为本地绝对路径软链接(会导致他人环境不可用)

46
repo/README.md Normal file
View File

@ -0,0 +1,46 @@
# 🔌 repo/:外部集成与第三方工具
`repo/` 用来收纳第三方工具、外部依赖与集成模块(含 Git submodule。核心原则是
- **尽量原样保留**:避免“魔改后不可升级”
- **隔离依赖与风险**:外部工具的依赖不要污染主仓库
- **可追溯**:来源、许可证、用法要写清楚
## 目录结构
```
repo/
├── AGENTS.md # 本目录的 Agent 行为准则
├── README.md # 本文件(外部工具索引)
├── .tmux/ # submoduleoh-my-tmux 配置
├── tmux/ # submoduletmux 源码
├── claude-official-skills/ # submoduleClaude 官方 skills 仓库Anthropic
├── prompts-library/ # Excel ↔ Markdown 转换工具
├── chat-vault/ # AI 聊天记录保存工具
├── Skill_Seekers-development/ # 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/`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/`:以 submodule 形式引入的上游仓库
> 📝 `system-prompts-and-models-of-ai-tools-main-cn/` 已移至 [`prompts/system_prompts/`](../../prompts/system_prompts/)
## 新增外部工具(最小清单)
1. 创建目录:`repo/<tool-name>/`
2. 必备文件:`README.md`(用途/入口/依赖/输入输出)、许可证与来源说明(如 `LICENSE` / `SOURCE.md`
3. 依赖约束:尽量使用工具自带的虚拟环境/容器化方式,不影响仓库其他部分
4. 文档同步:在本 README 增加一行工具说明,保证可发现性

Some files were not shown because too many files have changed in this diff Show More