From 4497be9d5074d7dc79b1e0c32df76103fbfc84f1 Mon Sep 17 00:00:00 2001 From: tukuaiai Date: Wed, 24 Dec 2025 18:31:28 +0800 Subject: [PATCH] docs: sync AGENTS.md and README.md with actual directory structure - Update prompts/skills/documents subdirectory names to Chinese numbered format - Add chat-vault and Skill_Seekers-development to external tools - Add CI link-checker job info - Remove non-existent scripts/ directory reference - Sync CLAUDE.md section in AGENTS.md --- AGENTS.md | 358 ++++++++++++++++++++++++++++++++++++++++-------------- README.md | 108 ++++++++-------- 2 files changed, 322 insertions(+), 144 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 6d12382..5e48ab8 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,95 +1,301 @@ # Repository Guidelines -## Project Structure & Module Organization -- 根目录：`README.md` 给出全貌，`Makefile` 封装日常命令，`CONTRIBUTING.md` 说明贡献流程，`LICENSE` 载明协议。保持根目录扁平，避免巨石文件。 -- 多语言 i18n：`i18n//` 统一三层结构（documents / prompts / skills）。现有语言：中文 `zh`、英文 `en`、希伯来语 `he`，以及 `es`、`hi`、`ar`、`pt`、`ru`、`fr`、`de`、`ja`、`ko`、`it`、`tr`、`nl`、`pl`、`id`、`vi`、`th`、`fa`、`uk`、`bn`、`ta`、`ur`、`ms`、`sw`、`ha`；新增语言遵循同样层级。 -- 文档库：`i18n/zh/documents/` 是默认中文方法论入口，含子目录：`方法论与原则/`、`模板与资源/`、`教程与指南/`、`外部资源聚合/`、`胶水编程/`、`从零开始vibecoding/` 等。 -- 提示词资产：`i18n/zh/prompts/` 按角色拆分（`system_prompts/`、`assistant_prompts/`、`coding_prompts/`、`user_prompts/`、`meta_prompts/`），`libs/external/prompts-library/` 提供 Excel ↔ Markdown 互转工具。 -- 技能库：`i18n/zh/skills/` 包含模块化技能集，如 `ccxt/`、`postgresql/`、`telegram-dev/`、`claude-code-guide/`、`ddd-doc-steward/`、`claude-skills/` 等 17+ 个技能目录。 -- 代码与集成：`libs/` 预留核心实现骨架，`common/`（含 `models/`、`utils/`）、`database/`、`external/` 分别对应通用模型、存储适配与外部依赖。 -- 外部工具：`libs/external/` 含 `prompts-library/`、`l10n-tool/`、`my-nvim/`、`MCPlayerTransfer/`、`XHS-image-to-PDF-conversion/` 等。 -- 备份：`backups/` 内含 `一键备份.sh`、`快速备份.py` 和 `gz/` 存档目录。 -- 脚本：`scripts/` 目录预留项目脚本。 -- GitHub 配置：`.github/` 含 `ISSUE_TEMPLATE/`、`PULL_REQUEST_TEMPLATE.md`、`SECURITY.md`、`FUNDING.yml`。 +本文件为 AI Agent 提供项目操作手册与约束清单，确保 Agent 行为可控、可复现。 -## Build, Test, and Development Commands -- `make help`：列出所有 Make 目标。 -- `make lint`：使用 `markdownlint-cli` 校验全仓库 Markdown。 -- `make build` / `make test` / `make clean`：目前为占位。 -- 提示词转换：`cd libs/external/prompts-library && python main.py`。 -- JSONL 批处理（Gemini）：`python libs/external/prompts-library/scripts/gemini_jsonl_batch.py --input 2 --output 2/prompts.jsonl`。 -- 备份：`bash backups/一键备份.sh` 或 `python backups/快速备份.py`。 +--- -## Coding Style & Naming Conventions -- 文字层：文档、注释、日志使用中文；代码符号统一英文且语义直白。 -- 缩进与排版：全仓保持空格缩进（2 或 4 空格不混用）；行宽控制在 120 列内。 -- 设计品味：优先消除分支与重复；函数单一职责且短小；命名小写加中划线或下划线。 -- 依赖管理：新增工具或库时记录安装方式、最小版本与来源。 +## 1. Mission & Scope（目标与边界） -## Testing Guidelines -- 当前无实测用例；引入代码时请至少提供最小可复现测试。 -- 文档与提示词改动：提交前运行 `make lint`。 -- 覆盖率基线由模块维护者设定。 +### 允许的操作 +- 读取、修改 `i18n/`、`libs/` 下的文档与代码 +- 执行 `make lint`、备份脚本、prompts-library 转换工具 +- 新增/修改提示词、技能、文档 +- 提交符合规范的 commit -## Commit & Pull Request Guidelines -- Commit 遵循简化 Conventional Commits：`feat|fix|docs|chore|refactor|test: scope – summary`。 -- PR 必填：变更摘要、动机或关联 Issue、测试与验证步骤。 -- 提交前清单：跑通 `make lint`；更新对应文档与 `Makefile` 目标；确认不携带临时文件或机密数据。 +### 禁止的操作 +- 修改 `.github/workflows/` 中的 CI 配置（除非任务明确要求） +- 删除或覆盖 `backups/gz/` 中的存档文件 +- 修改 `LICENSE`、`CODE_OF_CONDUCT.md` +- 在代码中硬编码密钥、Token 或敏感凭证 +- 未经确认的大范围重构 -## Security & Configuration Tips -- 运行备份或转换脚本前，确认输出目录不会覆盖私有数据。 -- 外部依赖来源记录在 `libs/external/` 目录下，引入第三方脚本需标明许可证与来源。 +### 敏感区域（禁止自动修改） +- `.github/workflows/*.yml` - CI/CD 配置 +- `backups/gz/` - 历史备份存档 +- `.env*` 文件（如存在） -## Architecture Overview & Workflow -- 工作流倡导「规划 → 上下文固定 → 分步实现 → 自测 → 复盘」。 -- 设计决策与目录结构更新后，请同步修订本文件与相关文档。 +--- + +## 2. Golden Path（推荐执行路径） + +```bash +# 1. 拉取最新代码 +git pull origin main + +# 2. 运行 lint 检查 +make lint + +# 3. 执行修改任务 +# ... + +# 4. 再次 lint 验证 +make lint + +# 5. 提交变更 +git add -A +git commit -m "feat|fix|docs|chore: scope - summary" +git push +``` + +--- + +## 3. Must-Run Commands（必须执行的命令清单） + +### 环境要求 +- Node.js 16+（用于 markdownlint-cli） +- Python 3.8+（用于 prompts-library 工具） +- Git + +### 核心命令 + +| 命令 | 用途 | 前置条件 | +|:---|:---|:---| +| `make help` | 列出所有 Make 目标 | 无 | +| `make lint` | 校验全仓库 Markdown | 需安装 markdownlint-cli | +| `bash backups/一键备份.sh` | 创建完整项目备份 | 无 | +| `python backups/快速备份.py` | Python 版备份脚本 | Python 3.8+ | +| `cd libs/external/prompts-library && python main.py` | 提示词格式转换 | pandas, openpyxl, PyYAML | + +### prompts-library 支持的转换模式 +1. Excel → Docs：将 Excel 工作簿转换为 Markdown 文档目录 +2. Docs → Excel：将 Markdown 文档目录还原为 Excel 工作簿 +3. Docs → JSONL：将 Markdown 文档转换为 JSONL 格式 +4. JSONL → Excel：将 JSONL 转换为 Excel +5. Excel(JSONL) → JSONL：将内部 JSONL 格式的 Excel 转换为 JSONL 文件 + +--- + +## 4. Code Change Rules（修改约束） + +### 架构原则 +- 保持根目录扁平，避免巨石文件 +- 多语言资产统一放在 `i18n//` 下，遵循三层结构（documents / prompts / skills） +- 新增语言遵循现有目录层级 + +### 模块边界 +- `i18n/zh/` - 中文主语料（默认） +- `i18n/en/` - 英文版本 +- `libs/common/` - 通用模块 +- `libs/external/` - 外部工具与依赖 + +### 依赖添加规则 +- 新增工具或库时记录安装方式、最小版本与来源 +- 外部依赖来源记录在 `libs/external/` 目录下 +- 引入第三方脚本需标明许可证与来源 + +### 禁止行为 +- 禁止"顺手重构/大范围改动"除非任务明确要求 +- 禁止删除现有测试用例（除非任务要求） +- 禁止在代码中硬编码敏感信息 + +--- + +## 5. Style & Quality（风格与质量标准） + +### 格式化工具 +- Markdown：`markdownlint-cli`（通过 `make lint` 执行） +- CI 自动检查：`.github/workflows/ci.yml` + +### 命名约定 +- 文档、注释、日志使用中文 +- 代码符号统一英文且语义直白 +- 文件名小写加中划线或下划线 + +### 缩进与排版 +- 全仓保持空格缩进（2 或 4 空格不混用） +- 行宽控制在 120 列内 + +### 设计品味 +- 优先消除分支与重复 +- 函数单一职责且短小 + +--- + +## 6. Project Map（项目结构速览） + +``` +. +├── README.md # 项目主文档 +├── AGENTS.md # AI Agent 行为准则（本文件） +├── CLAUDE.md # Claude 模型上下文（合并在本文件末尾） +├── GEMINI.md # Gemini 模型上下文 +├── Makefile # 自动化脚本 +├── LICENSE # MIT 许可证 +├── CODE_OF_CONDUCT.md # 行为准则 +├── CONTRIBUTING.md # 贡献指南 +├── .gitignore # Git 忽略规则 +│ +├── .github/ # GitHub 配置 +│ ├── workflows/ # CI/CD 工作流 +│ │ ├── ci.yml # Markdown lint + link checker +│ │ ├── labeler.yml # 自动标签 +│ │ └── welcome.yml # 欢迎新贡献者 +│ ├── ISSUE_TEMPLATE/ # Issue 模板 +│ ├── PULL_REQUEST_TEMPLATE.md # PR 模板 +│ ├── SECURITY.md # 安全政策 +│ ├── FUNDING.yml # 赞助配置 +│ └── wiki/ # GitHub Wiki 内容 +│ +├── i18n/ # 多语言资产 (27 种语言) +│ ├── README.md # 多语言索引 +│ ├── zh/ # 中文主语料 +│ │ ├── documents/ # 文档库 +│ │ │ ├── 00-基础指南/ # 方法论与原则 +│ │ │ ├── 01-入门指南/ # 从零开始教程 +│ │ │ ├── 02-方法论/ # 工具与技巧 +│ │ │ ├── 03-实战/ # 项目实战案例 +│ │ │ └── 04-资源/ # 外部资源聚合 +│ │ ├── prompts/ # 提示词库 +│ │ │ ├── 00-元提示词/ # 生成提示词的提示词 +│ │ │ ├── 01-系统提示词/ # AI 系统级提示词 +│ │ │ ├── 02-编程提示词/ # 编程相关提示词 +│ │ │ └── 03-用户提示词/ # 用户自定义提示词 +│ │ └── skills/ # 技能库 +│ │ ├── 00-元技能/ # 生成技能的元技能 +│ │ ├── 01-AI工具/ # AI CLI 和工具 +│ │ ├── 02-数据库/ # 数据库技能 +│ │ ├── 03-加密货币/ # 加密货币/量化交易 +│ │ └── 04-开发工具/ # 通用开发工具 +│ ├── en/ # 英文版本（结构同 zh/） +│ └── ... # 其他语言骨架 +│ +├── libs/ # 核心库代码 +│ ├── common/ # 通用模块 +│ │ ├── models/ # 模型定义 +│ │ └── utils/ # 工具函数 +│ ├── database/ # 数据库模块（预留） +│ └── external/ # 外部工具 +│ ├── prompts-library/ # Excel ↔ Markdown 互转工具 +│ ├── chat-vault/ # AI 聊天记录保存工具 +│ ├── Skill_Seekers-development/ # Skills 制作器 +│ ├── l10n-tool/ # 多语言翻译脚本 +│ ├── my-nvim/ # Neovim 配置 +│ ├── MCPlayerTransfer/ # MC 玩家迁移工具 +│ └── XHS-image-to-PDF-conversion/ # 小红书图片转 PDF +│ +└── backups/ # 备份脚本与存档 + ├── 一键备份.sh # Shell 备份脚本 + ├── 快速备份.py # Python 备份脚本 + ├── README.md # 备份说明 + └── gz/ # 压缩存档目录 +``` + +### 关键入口文件 +- `README.md` - 项目主文档，面向人类开发者 +- `AGENTS.md` - AI Agent 操作手册（本文件） +- `libs/external/prompts-library/main.py` - 提示词转换工具入口 +- `backups/一键备份.sh` - 备份脚本入口 + +--- + +## 7. Common Pitfalls（常见坑与修复） + +| 问题 | 原因 | 修复 | +|:---|:---|:---| +| `make lint` 失败 | 未安装 markdownlint-cli | `npm install -g markdownlint-cli` | +| prompts-library 报错 | 缺少 Python 依赖 | `pip install pandas openpyxl PyYAML rich InquirerPy` | +| CI link-checker 失败 | 文档中存在失效链接 | 检查并修复 Markdown 中的链接 | +| 备份脚本权限不足 | Shell 脚本无执行权限 | `chmod +x backups/一键备份.sh` | + +--- + +## 8. PR / Commit Rules（提交与 CI 规则） + +### Commit 规范 +遵循简化 Conventional Commits： +``` +feat|fix|docs|chore|refactor|test: scope - summary +``` + +示例： +- `docs: prompts - add new coding prompt` +- `feat: skills - add postgresql skill` +- `fix: readme - correct broken link` + +### PR 必填内容 +- 变更摘要 +- 动机或关联 Issue +- 测试与验证步骤 + +### CI 触发条件 +- `push` 到 `main` 分支 +- `pull_request` 到 `main` 分支 + +### CI 检查项 +1. `markdown-lint` - Markdown 格式检查 +2. `link-checker` - 链接有效性检查 + +### 提交前清单 +- [ ] 运行 `make lint` 通过 +- [ ] 更新对应文档 +- [ ] 确认不携带临时文件或机密数据 + +--- + +## 9. Documentation Sync Rule（强制同步规则） + +**任何功能/命令/配置/目录/工作流变化必须同步更新：** +- `README.md` - 面向人类开发者 +- `AGENTS.md` - 面向 AI Agent（本文件） +- `GEMINI.md` - Gemini 模型上下文 + +**不确定的内容用 TODO 标注，不允许猜测。** --- # CLAUDE.md -This file provides guidance to Claude series models when working with code in this repository. +本节为 Claude 系列模型提供项目上下文。 ## Repository Overview -This is the **Vibe Coding CN** repository, a workflow, toolset, and knowledge base for advanced AI-assisted programming. The project's core assets are its extensive `prompts` and `skills` libraries. +**Vibe Coding CN** 是一个通过与 AI 结对编程实现"将想法变为现实"的终极工作流程。项目核心资产是其丰富的 `prompts` 和 `skills` 库。 ## Key Commands ```bash -# Prompt library conversion +# 提示词库转换 cd libs/external/prompts-library && python3 main.py -# Lint all markdown files +# Lint 所有 Markdown 文件 make lint -# Create a full project backup +# 创建完整项目备份 bash backups/一键备份.sh ``` ## Architecture & Structure ### Core Directories -- **`i18n/zh/prompts/`**: Core prompt library (`coding_prompts/`, `system_prompts/`, `user_prompts/`, `assistant_prompts/`, `meta_prompts/`) -- **`i18n/zh/skills/`**: Modular skills library (16+ skills including `ccxt`, `postgresql`, `telegram-dev`, `claude-skills`) -- **`i18n/zh/documents/`**: Knowledge base (`方法论与原则/`, `模板与资源/`, `教程与指南/`, `胶水编程/`, `从零开始vibecoding/`) -- **`libs/external/prompts-library/`**: Excel ↔ Markdown conversion tool -- **`libs/external/`**: External tools (`l10n-tool/`, `my-nvim/`, `MCPlayerTransfer/`) -- **`backups/`**: Backup scripts and archives -- **`scripts/`**: Project scripts placeholder +- **`i18n/zh/prompts/`**: 核心提示词库（00-元提示词、01-系统提示词、02-编程提示词、03-用户提示词） +- **`i18n/zh/skills/`**: 模块化技能库（00-元技能、01-AI工具、02-数据库、03-加密货币、04-开发工具） +- **`i18n/zh/documents/`**: 知识库（00-基础指南、01-入门指南、02-方法论、03-实战、04-资源） +- **`libs/external/prompts-library/`**: Excel ↔ Markdown 转换工具 +- **`libs/external/chat-vault/`**: AI 聊天记录保存工具 +- **`backups/`**: 备份脚本与存档 ### Key Technical Details -1. **Prompt Organization**: Prompts use `(row,col)_` prefix for categorization. -2. **Conversion Tool**: Uses Python with `pandas` and `openpyxl`. -3. **Documentation Standard**: User-facing docs in Chinese; code/filenames in English. -4. **Skills**: Each skill has its own `SKILL.md`. +1. **Prompt Organization**: 提示词使用 `(row,col)_` 前缀进行分类 +2. **Conversion Tool**: 使用 Python + pandas + openpyxl +3. **Documentation Standard**: 用户文档使用中文；代码/文件名使用英文 +4. **Skills**: 每个技能有独立的 `SKILL.md` ## Development Workflow -1. Follow existing prompt and skill categorization systems. -2. Use `prompts-library` tool for prompt updates. -3. Run `make lint` after Markdown changes. -4. Run backup before major refactoring. +1. 遵循现有的提示词和技能分类系统 +2. 使用 `prompts-library` 工具进行提示词更新 +3. Markdown 修改后运行 `make lint` +4. 重大重构前运行备份脚本 --- @@ -111,40 +317,4 @@ bash backups/一键备份.sh ## 文件结构 -``` -. -├── .github/ # GitHub 配置 (Issue/PR 模板, SECURITY, FUNDING) -├── AGENTS.md # AI Agent 行为准则 -├── CLAUDE.md # Claude 模型上下文 -├── GEMINI.md # Gemini 模型上下文 -├── CODE_OF_CONDUCT.md # 行为准则 -├── CONTRIBUTING.md # 贡献指南 -├── LICENSE # MIT 许可证 -├── Makefile # 自动化脚本 -├── README.md # 项目主文档 -│ -├── i18n/ # 多语言资产 (29 种语言) -│ ├── zh/ # 中文主语料 -│ │ ├── documents/ # 文档库 (方法论/模板/教程/胶水编程等) -│ │ ├── prompts/ # 提示词库 (system/coding/user/assistant/meta) -│ │ └── skills/ # 技能库 (16+ 技能) -│ ├── en/ # 英文版本 -│ └── ... # 其他语言骨架 -│ -├── libs/ # 核心库代码 -│ ├── common/ # 通用模块 (models/, utils/) -│ ├── database/ # 数据库模块 -│ └── external/ # 外部工具 -│ ├── prompts-library/ # Excel-Markdown 互转工具 -│ ├── l10n-tool/ # 多语言翻译脚本 -│ ├── my-nvim/ # Neovim 配置 -│ ├── MCPlayerTransfer/ # MC 玩家迁移工具 -│ └── XHS-image-to-PDF-conversion/ -│ -├── backups/ # 备份脚本与存档 -│ ├── 一键备份.sh -│ ├── 快速备份.py -│ └── gz/ # 压缩存档 -│ -└── scripts/ # 项目脚本 -``` +详见上方 Project Map 章节。 diff --git a/README.md b/README.md index 2d88a8b..00c6f23 100644 --- a/README.md +++ b/README.md @@ -326,60 +326,68 @@ ``` . -├── CODE_OF_CONDUCT.md # 社区行为准则，规范贡献者行为。 -├── CONTRIBUTING.md # 贡献指南，说明如何为本项目做出贡献。 -├── GEMINI.md # AI 助手的上下文文档，包含项目概述、技术栈和文件结构。 -├── LICENSE # 开源许可证文件。 -├── Makefile # 项目自动化脚本，用于代码检查、构建等。 -├── README.md # 项目主文档，包含项目概览、使用指南、资源链接等。 -├── .gitignore # Git 忽略文件。 -├── AGENTS.md # AI 代理相关的文档或配置。 -├── CLAUDE.md # AI 助手的核心行为准则或配置。 +├── README.md # 项目主文档 +├── AGENTS.md # AI Agent 行为准则 +├── GEMINI.md # Gemini 模型上下文 +├── Makefile # 自动化脚本 +├── LICENSE # MIT 许可证 +├── CODE_OF_CONDUCT.md # 行为准则 +├── CONTRIBUTING.md # 贡献指南 +├── .gitignore # Git 忽略规则 │ -├── i18n/zh/documents/ # 存放各类说明文档、经验总结和配置详细说明。 -│ ├── 00-基础指南/ # 方法论与原则 -│ ├── 04-资源/ # 模板与资源 -│ └── 02-方法论/ # 教程与指南 +├── .github/ # GitHub 配置 +│ ├── workflows/ # CI/CD 工作流 +│ │ ├── ci.yml # Markdown lint + link checker +│ │ ├── labeler.yml # 自动标签 +│ │ └── welcome.yml # 欢迎新贡献者 +│ ├── ISSUE_TEMPLATE/ # Issue 模板 +│ ├── PULL_REQUEST_TEMPLATE.md # PR 模板 +│ ├── SECURITY.md # 安全政策 +│ ├── FUNDING.yml # 赞助配置 +│ └── wiki/ # GitHub Wiki 内容 │ -├── libs/ # 通用库代码，用于项目内部模块化。 -│ ├── common/ # 通用功能模块。 -│ │ ├── models/ # 模型定义。 -│ │ │ └── __init__.py -│ │ └── utils/ # 工具函数。 -│ │ └── backups/ # 内部备份工具。 -│ ├── database/ # 数据库相关模块。 -│ │ └── .gitkeep # 占位文件，确保目录被 Git 跟踪。 -│ └── external/ # 外部集成模块。 -│ ├── my-nvim/ # 用户的 Neovim 配置。 -│ ├── prompts-library/ # 提示词库管理工具（Excel-Markdown 转换）。 -│ │ ├── main.py # 提示词库管理工具主入口。 -│ │ ├── scripts/ # 包含 Excel 与 Markdown 互转脚本和配置。 -│ │ ├── prompt_excel/ # 存放 Excel 格式的原始提示词数据。 -│ │ ├── prompt_docs/ # 存放从 Excel 转换而来的 Markdown 提示词文档。 -│ │ └── ... (其他 prompts-library 内部文件) -│ └── XHS-image-to-PDF-conversion/ # 小红书图片转PDF工具。 +├── i18n/ # 多语言资产 (27 种语言) +│ ├── README.md # 多语言索引 +│ ├── zh/ # 中文主语料 +│ │ ├── documents/ # 文档库 +│ │ │ ├── 00-基础指南/ # 方法论与原则 +│ │ │ ├── 01-入门指南/ # 从零开始教程 +│ │ │ ├── 02-方法论/ # 工具与技巧 +│ │ │ ├── 03-实战/ # 项目实战案例 +│ │ │ └── 04-资源/ # 外部资源聚合 +│ │ ├── prompts/ # 提示词库 +│ │ │ ├── 00-元提示词/ # 生成提示词的提示词 +│ │ │ ├── 01-系统提示词/ # AI 系统级提示词 +│ │ │ ├── 02-编程提示词/ # 编程相关提示词 +│ │ │ └── 03-用户提示词/ # 用户自定义提示词 +│ │ └── skills/ # 技能库 +│ │ ├── 00-元技能/ # 生成技能的元技能 +│ │ ├── 01-AI工具/ # AI CLI 和工具 +│ │ ├── 02-数据库/ # 数据库技能 +│ │ ├── 03-加密货币/ # 加密货币/量化交易 +│ │ └── 04-开发工具/ # 通用开发工具 +│ ├── en/ # 英文版本（结构同 zh/） +│ └── ... # 其他语言骨架 │ -├── i18n/zh/prompts/ # 集中存放所有类型的 AI 提示词。 -│ ├── 00-元提示词/ # 用于生成提示词的高级提示词。 -│ ├── 01-系统提示词/ # AI 系统级提示词，用于设定 AI 行为和框架。 -│ │ └── ... (其他系统提示词) -│ │ -│ ├── 02-编程提示词/ # 专门用于编程和代码生成相关的提示词集合。 -│ │ └── ... (具体编程提示词文件) -│ │ -│ └── 03-用户提示词/ # 用户自定义或常用提示词。 -│ ├── ASCII图生成.md # ASCII 艺术图生成提示词。 -│ ├── 数据管道.md # 数据管道处理提示词。 -│ └── ... (其他用户提示词) +├── libs/ # 核心库代码 +│ ├── common/ # 通用模块 +│ │ ├── models/ # 模型定义 +│ │ └── utils/ # 工具函数 +│ ├── database/ # 数据库模块（预留） +│ └── external/ # 外部工具 +│ ├── prompts-library/ # Excel ↔ Markdown 互转工具 +│ ├── chat-vault/ # AI 聊天记录保存工具 +│ ├── Skill_Seekers-development/ # Skills 制作器 +│ ├── l10n-tool/ # 多语言翻译脚本 +│ ├── my-nvim/ # Neovim 配置 +│ ├── MCPlayerTransfer/ # MC 玩家迁移工具 +│ └── XHS-image-to-PDF-conversion/ # 小红书图片转 PDF │ -├── i18n/zh/skills/ # 集中存放所有类型的 skills 技能。 - ├── 00-元技能/ # 元技能目录 - │ └── claude-skills/ # 生成 SKILL 的元 SKILL - ├── 01-AI工具/ # AI CLI 和工具 - │ └── headless-cli/ # 无头模式 AI CLI 调用 - ├── 02-数据库/ # 数据库技能 - ├── 03-加密货币/ # 加密货币/量化交易 - └── 04-开发工具/ # 通用开发工具 +└── backups/ # 备份脚本与存档 + ├── 一键备份.sh # Shell 备份脚本 + ├── 快速备份.py # Python 备份脚本 + ├── README.md # 备份说明 + └── gz/ # 压缩存档目录 ``` ---