chore: repo - flatten tool mirrors

This commit is contained in:
tukuaiai
2026-02-26 08:05:07 +08:00
parent 921bdf3f6a
commit 88d57b3bc7
402 changed files with 131 additions and 266 deletions
+21 -20
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