From 8830a20cc5ad40051c46e043886d7c085805a72b Mon Sep 17 00:00:00 2001 From: tukuaiai Date: Sun, 14 Dec 2025 08:24:49 +0800 Subject: [PATCH] feat: Update documentation and claude-skills module --- backups/README.md | 53 ++++ documents/README.md | 105 ++++++++ libs/README.md | 90 +++++++ libs/common/README.md | 27 ++ libs/database/README.md | 22 ++ libs/external/README.md | 29 ++ prompts/README.md | 80 ++++-- skills/README.md | 253 ++++++++++++++++-- skills/claude-skills/SKILL.md | Bin 10817 -> 6846 bytes .../claude-skills/assets/template-complete.md | 78 ++++++ .../claude-skills/assets/template-minimal.md | 14 + skills/claude-skills/scripts/create-skill.sh | 54 ++++ 12 files changed, 763 insertions(+), 42 deletions(-) create mode 100644 backups/README.md create mode 100644 documents/README.md create mode 100644 libs/README.md create mode 100644 libs/common/README.md create mode 100644 libs/database/README.md create mode 100644 libs/external/README.md create mode 100644 skills/claude-skills/assets/template-complete.md create mode 100644 skills/claude-skills/assets/template-minimal.md create mode 100644 skills/claude-skills/scripts/create-skill.sh diff --git a/backups/README.md b/backups/README.md new file mode 100644 index 0000000..fc03cca --- /dev/null +++ b/backups/README.md @@ -0,0 +1,53 @@ +# 快速备份工具 + +基于 `.gitignore` 规则的项目备份工具，自动排除不需要的文件。 + +## 功能特性 + +- 自动读取 `.gitignore` 规则 +- 支持取反规则（`!` 语法） +- 目录级剪枝优化 +- 生成 `.tar.gz` 压缩包 +- 零依赖（仅使用 Python 内置模块） + +## 文件结构 + +``` +backups/ +├── 快速备份.py # 核心备份引擎 +├── 一键备份.sh # Shell 启动脚本 +└── README.md # 本文档 +``` + +## 使用方法 + +```bash +# 方式一：Shell 脚本（推荐） +bash backups/一键备份.sh + +# 方式二：直接运行 Python +python3 backups/快速备份.py + +# 指定输出文件 +python3 backups/快速备份.py -o my_backup.tar.gz + +# 指定项目目录 +python3 backups/快速备份.py -p /path/to/project +``` + +## 输出位置 + +默认输出到 `backups/gz/备份_YYYYMMDD_HHMMSS.tar.gz` + +## 参数说明 + +| 参数 | 说明 | 默认值 | +|------|------|--------| +| `-p, --project` | 项目根目录 | 当前目录 | +| `-o, --output` | 输出文件路径 | `backups/gz/备份_时间戳.tar.gz` | +| `-g, --gitignore` | gitignore 文件路径 | `.gitignore` | + +## 依赖 + +- Python 3.x（无需额外包） +- Bash（用于 Shell 脚本） diff --git a/documents/README.md b/documents/README.md new file mode 100644 index 0000000..ae8d838 --- /dev/null +++ b/documents/README.md @@ -0,0 +1,105 @@ +# 📖 文档库 (Documents) + +`documents/` 目录汇总项目的流程文档、架构说明、开发经验与最佳实践，是理解方法论与协作规则的首选入口。当前包含 **14 个**文档。 + +## 目录结构 + +``` +documents/ +├── README.md # 本文件 +│ +├── # === 方法论与理念 === +├── 编程之道.md # 编程哲学与核心理念（5.4KB） +├── 胶水编程.md # 胶水编程方法论（4KB） +├── gluecoding.md # Glue Coding 英文版（5.2KB） +├── 小登论道.md # 学习经验分享 +│ +├── # === 开发实践 === +├── 开发经验.md # 变量命名、编码规范、架构原则（5KB） +├── 代码组织.md # 代码结构与组织方式（1.7KB） +├── vibe-coding-经验收集.md # AI 开发最佳实践（2.3KB） +├── 通用项目架构模板.md # 项目目录结构模板（13KB）⭐推荐 +│ +├── # === 工具与配置 === +├── 工具集.md # 开发工具推荐 +├── auggie-mcp配置文档.md # Augment 上下文引擎配置（2.7KB） +├── tmux快捷键大全.md # tmux 终端复用快捷键（1.1KB） +├── 关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md # FRP 内网穿透（10.6KB） +│ +├── # === 提示词与 AI === +├── 系统提示词构建原则.md # 系统提示词设计指南（5.6KB） +│ +└── # === 学习资源 === + └── 编程书籍推荐.md # 编程书籍推荐列表（6KB） +``` + +## 文档分类 + +### 🧘 方法论与理念 + +| 文档 | 大小 | 说明 | +|------|------|------| +| `编程之道.md` | 5.4KB | 编程哲学、核心理念、思维方式 | +| `胶水编程.md` | 4KB | 胶水编程方法论（中文） | +| `gluecoding.md` | 5.2KB | Glue Coding 方法论（英文） | +| `小登论道.md` | 0.2KB | 个人学习经验分享 | + +### 💻 开发实践 + +| 文档 | 大小 | 说明 | +|------|------|------| +| `通用项目架构模板.md` | 13KB | ⭐ 多种项目类型的标准目录结构、设计原则、技术选型 | +| `开发经验.md` | 5KB | 变量命名、文件结构、编码规范、微服务、Redis、消息队列 | +| `代码组织.md` | 1.7KB | 代码结构与组织方式 | +| `vibe-coding-经验收集.md` | 2.3KB | AI 开发最佳实践与系统提示词优化技巧 | + +### 🔧 工具与配置 + +| 文档 | 大小 | 说明 | +|------|------|------| +| `auggie-mcp配置文档.md` | 2.7KB | Augment 上下文引擎 MCP 配置 | +| `tmux快捷键大全.md` | 1.1KB | tmux 终端复用快捷键速查 | +| `关于手机ssh...frp实现的方法.md` | 10.6KB | FRP 内网穿透，手机 SSH 连接本地电脑 | +| `工具集.md` | 0.5KB | 开发工具推荐列表 | + +### 🤖 提示词与 AI + +| 文档 | 大小 | 说明 | +|------|------|------| +| `系统提示词构建原则.md` | 5.6KB | 系统提示词设计指南：沟通互动、任务执行、编码规范、安全防护 | + +### 📚 学习资源 + +| 文档 | 大小 | 说明 | +|------|------|------| +| `编程书籍推荐.md` | 6KB | 编程书籍推荐列表与阅读建议 | + +## 推荐阅读顺序 + +**新手入门**： +1. `编程之道.md` - 理解编程哲学 +2. `通用项目架构模板.md` - 学习项目结构 +3. `开发经验.md` - 掌握编码规范 + +**Vibe Coding 实践**： +1. `胶水编程.md` / `gluecoding.md` - 理解方法论 +2. `vibe-coding-经验收集.md` - AI 开发技巧 +3. `系统提示词构建原则.md` - 提示词设计 + +**工具配置**： +1. `auggie-mcp配置文档.md` - Augment 引擎 +2. `tmux快捷键大全.md` - 终端复用 +3. `关于手机ssh...frp实现的方法.md` - 远程连接 + +## 贡献新文档 + +1. 使用清晰的中文命名 +2. 在文件开头说明文档用途 +3. 更新本 README 的文档列表 +4. 如有关联，在主 README 中添加链接 + +## 相关资源 + +- [提示词库](../prompts/) - AI 提示词集合 +- [技能库](../skills/) - AI Skills 技能 +- [通用库](../libs/) - 工具与外部集成 diff --git a/libs/README.md b/libs/README.md new file mode 100644 index 0000000..7c039b3 --- /dev/null +++ b/libs/README.md @@ -0,0 +1,90 @@ +# 📦 通用库与外部集成 (Libs) + +`libs/` 目录存放项目的通用库代码和外部集成模块，用于项目内部模块化和工具复用。 + +## 目录结构 + +``` +libs/ +├── README.md # 本文件 +├── common/ # 通用功能模块 +│ ├── __init__.py +│ ├── models/ # 数据模型定义 +│ │ └── __init__.py +│ └── utils/ # 工具函数 +│ └── backups/ # 备份工具 +├── database/ # 数据库相关模块（预留） +│ └── .gitkeep +└── external/ # 外部集成与第三方工具 + ├── prompts-library/ # 提示词库管理工具 + ├── my-nvim/ # Neovim 配置 + └── XHS-image-to-PDF-conversion/ # 小红书图片转 PDF +``` + +## 各子目录详解 + +### `common/` - 通用功能模块 + +存放项目内部共享的通用代码： + +- `models/` - 数据模型定义，如 Pydantic 模型、数据类等 +- `utils/` - 工具函数，如文件处理、格式转换等 +- `utils/backups/` - 备份相关工具函数 + +### `database/` - 数据库模块（预留） + +预留的数据库适配层，用于未来扩展数据持久化功能。 + +### `external/` - 外部集成 + +#### `prompts-library/` - 提示词库管理工具 + +Excel ↔ Markdown 提示词互转工具： + +```bash +cd libs/external/prompts-library +pip install -r requirements.txt +python main.py +``` + +功能： +- Excel 转 Markdown：批量将表格提示词转为 .md 文件 +- Markdown 转 Excel：将 .md 文件汇总到表格中 +- 支持分类、标签、版本管理 + +#### `my-nvim/` - Neovim 配置 + +个人 Neovim 配置，基于 LazyVim，包含： +- LSP 配置 +- 代码补全 +- 文件导航 +- Git 集成 + +#### `XHS-image-to-PDF-conversion/` - 小红书图片转 PDF + +将小红书图片合并为 PDF 的工具： + +```bash +cd libs/external/XHS-image-to-PDF-conversion +pip install -r requirements.txt +python pdf.py +``` + +## 使用原则 + +1. **分层边界**: `common/` 只放通用代码，业务逻辑放其他地方 +2. **单一职责**: 每个模块只做一件事 +3. **依赖记录**: 新增外部依赖时更新对应的 `requirements.txt` +4. **文档同步**: 新增模块时更新本 README + +## 新增模块指南 + +```bash +# 新增通用模块 +mkdir -p libs/common/新模块名 +touch libs/common/新模块名/__init__.py + +# 新增外部集成 +mkdir -p libs/external/工具名 +echo "# 工具说明" > libs/external/工具名/README.md +``` diff --git a/libs/common/README.md b/libs/common/README.md new file mode 100644 index 0000000..e860e5e --- /dev/null +++ b/libs/common/README.md @@ -0,0 +1,27 @@ +# 🔧 通用功能模块 (Common) + +存放项目内部共享的通用代码，包括数据模型和工具函数。 + +## 目录结构 + +``` +common/ +├── __init__.py +├── models/ # 数据模型定义 +│ └── __init__.py +└── utils/ # 工具函数 + └── backups/ # 备份工具 +``` + +## 子模块 + +- `models/` - Pydantic 模型、数据类等 +- `utils/` - 文件处理、格式转换等工具函数 +- `utils/backups/` - 备份相关工具 + +## 使用 + +```python +from libs.common.models import YourModel +from libs.common.utils import your_function +``` diff --git a/libs/database/README.md b/libs/database/README.md new file mode 100644 index 0000000..94c30f8 --- /dev/null +++ b/libs/database/README.md @@ -0,0 +1,22 @@ +# 🗄️ 数据库模块 (Database) + +预留的数据库适配层，用于未来扩展数据持久化功能。 + +## 规划用途 + +- 数据库连接管理 +- ORM 模型定义 +- 数据迁移脚本 +- 查询工具函数 + +## 待实现 + +当前为占位目录，后续可添加： + +``` +database/ +├── __init__.py +├── connection.py # 连接管理 +├── models.py # ORM 模型 +└── migrations/ # 迁移脚本 +``` diff --git a/libs/external/README.md b/libs/external/README.md new file mode 100644 index 0000000..609f93c --- /dev/null +++ b/libs/external/README.md @@ -0,0 +1,29 @@ +# 🔌 外部集成模块 (External) + +存放第三方工具、外部依赖和集成模块。 + +## 目录结构 + +``` +external/ +├── prompts-library/ # 提示词库管理工具（Excel ↔ MD 互转） +├── my-nvim/ # Neovim 配置 +└── XHS-image-to-PDF-conversion/ # 小红书图片转 PDF +``` + +## 工具说明 + +| 工具 | 用途 | 使用方法 | +|------|------|----------| +| `prompts-library` | 提示词 Excel/MD 互转 | `python main.py` | +| `my-nvim` | Neovim 配置 | 复制到 `~/.config/nvim` | +| `XHS-image-to-PDF-conversion` | 图片合并 PDF | `python pdf.py` | + +## 新增外部工具 + +```bash +mkdir -p libs/external/工具名 +echo "# 工具说明" > libs/external/工具名/README.md +``` + +新增时请注明来源、许可证和依赖。 diff --git a/prompts/README.md b/prompts/README.md index 2005f73..28fee4f 100644 --- a/prompts/README.md +++ b/prompts/README.md @@ -1,33 +1,81 @@ # 💡 AI 提示词库 (Prompts Library) -`prompts/` 目录是本项目中 AI 提示词的核心资产，包含了大量经过精心设计和分类的提示词，用于指导 AI 进行各种任务，从代码生成到系统行为设定。这些提示词是实现高质量 AI 结对编程的关键。 +`prompts/` 目录是本项目中 AI 提示词的核心资产，包含 **40+ 个**经过精心设计和分类的提示词，用于指导 AI 进行各种任务。 ## 目录结构 ``` prompts/ -├── coding_prompts/ # 编程与代码生成相关提示词 -├── system_prompts/ # AI 系统级提示词，用于设定 AI 行为和思维框架 -└── user_prompts/ # 用户自定义或常用的提示词 +├── README.md # 本文件 +├── coding_prompts/ # 编程与代码生成相关提示词（40+ 个） +│ ├── index.md # 提示词索引与版本矩阵 +│ ├── plan提示词.md # 实施计划生成 +│ ├── 系统架构可视化生成Mermaid.md +│ ├── 项目上下文文档生成.md +│ └── ... +├── system_prompts/ # AI 系统级提示词（10 个版本） +│ └── CLAUDE.md/ +│ ├── 1/ ~ 10/ # 不同版本的系统提示词 +│ └── ... +└── user_prompts/ # 用户自定义提示词 + ├── ASCII图生成.md + ├── 数据管道.md + └── 项目变量与工具统一维护.md ``` -## 各子目录说明 +## 各子目录详解 -### `coding_prompts/` +### `coding_prompts/` - 编程提示词集 -此目录存放专注于编程和代码生成任务的提示词。它们旨在帮助 AI 理解编程需求、生成符合规范的代码、进行代码分析、重构和调试等。这些提示词通常包含了对编程语言、框架、最佳实践和特定代码结构的详细指示。 +| 类别 | 示例提示词 | 用途 | +|------|-----------|------| +| 项目规划 | `plan提示词.md` | 生成详细实施计划 | +| 架构设计 | `系统架构可视化生成Mermaid.md` | 架构分析与可视化 | +| 文档生成 | `项目上下文文档生成.md`、`精华技术文档生成提示词.md` | 自动生成项目文档 | +| 代码规范 | `标准项目目录结构.md`、`标准化流程.md` | 统一代码风格与结构 | +| 需求分析 | `智能需求理解与研发导航引擎.md` | 需求澄清与任务分解 | +| 深度思考 | `ultrathink` 系列 | 触发 AI 深度推理模式 | -### `system_prompts/` +**索引文件**: `index.md` 提供完整的提示词列表和快速跳转链接。 -此目录包含用于设定 AI 整体行为模式、思维框架和角色定位的系统级提示词。通过这些提示词，可以定义 AI 的个性、它与用户交互的方式、以及在解决问题时应遵循的原则。它们是确保 AI 能够以稳定、一致且符合预期的行为进行工作的基础。 +### `system_prompts/` - 系统级提示词 -### `user_prompts/` +用于设定 AI 整体行为模式和思维框架，当前包含 **10 个版本**： -此目录用于存放用户自定义或常用的提示词。这些提示词可以是个性化的任务指令、常用的查询模板或特定项目的工作流指南。用户可以根据自己的需求在此处添加和管理自己的提示词，以便于快速调用和复用。 +| 版本 | 特点 | +|------|------| +| v1 | 开发者行为准则与工程规范 | +| v2 | ultrathink 模式与架构可视化规范 | +| v3 | 思维创作哲学与执行确认机制 | +| v4 | Linus 级工程师服务认知架构 | +| v5 | 顶级程序员思维框架与代码品味 | +| v6 | 综合版本，整合所有最佳实践 | +| v7 | 推理与规划智能体，专职复杂任务分解 | +| v8 | 最新综合版，顶级程序员服务 Linus 级工程师 | +| v9 | 简化版本（实验性） | +| v10 | 最新版，加入 Augment 上下文引擎规范 | -## 提示词的使用与管理 +**推荐**: 新项目建议从 `v8` 或 `v10` 开始。 -* **分类明确:** 提示词根据其用途被清晰地分类到不同的子目录中，方便查找和管理。 -* **内容丰富:** 每个提示词都经过精心设计，以提供足够的信息和指导，确保 AI 能够准确理解任务。 -* **持续优化:** 提示词是一个动态的知识库，可以根据实际使用效果和 AI 模型的演进进行持续的优化和更新。 -* **结合工具:** 提示词可与 `libs/external/prompts-library` 中的提示词管理工具结合使用，进行 Excel 与 Markdown 格式的相互转换，实现更便捷的编辑和维护。 +### `user_prompts/` - 用户自定义提示词 + +- `ASCII图生成.md` - 生成 ASCII 艺术图 +- `数据管道.md` - 数据处理流程设计 +- `项目变量与工具统一维护.md` - 项目配置管理 + +## 快速使用 + +```bash +# 查看某个提示词 +cat prompts/coding_prompts/plan提示词.md + +# 使用 v8 版本的系统提示词 +cp prompts/system_prompts/CLAUDE.md/8/CLAUDE.md ./CLAUDE.md +``` + +## 相关资源 + +- [Google 表格提示词数据库](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1) +- [元提示词](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220) +- [系统提示词收集仓库](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools) +- [Skills 生成器](https://github.com/yusufkaraaslan/Skill_Seekers) diff --git a/skills/README.md b/skills/README.md index 9f8f830..45b6514 100644 --- a/skills/README.md +++ b/skills/README.md @@ -1,40 +1,241 @@ -# 🤖 AI 技能库 (Skills Library) +# 🎯 AI Skills 技能库 -`skills/` 目录是本项目中 AI 技能的模块化集合。每个子目录代表一个独立的技能模块，旨在为 AI 提供特定的工具、领域知识和操作能力。这些技能使得 AI 能够执行更复杂、更专业的任务。 +`skills/` 目录存放 AI 技能（Skills），这些是比提示词更高级的能力封装，可以让 AI 在特定领域表现出专家级水平。当前包含 **14 个**专业技能。 ## 目录结构 ``` skills/ -├───ccxt/ # CCXT 加密货币交易库技能 -├───claude-code-guide/ # Claude Code 使用指南技能 -├───claude-cookbooks/ # Claude Cookbooks 技能 -├───claude-skills/ # Claude 核心技能 -├───coingecko/ # CoinGecko 数据查询技能 -├───cryptofeed/ # CryptoFeed 实时数据处理技能 -├───hummingbot/ # Hummingbot 量化交易机器人技能 -├───polymarket/ # Polymarket 预测市场技能 -├───postgresql/ # PostgreSQL 数据库操作技能 -├───proxychains/ # ProxyChains 代理工具技能 -├───snapdom/ # SnapDOM 网页自动化技能 -├───telegram-dev/ # Telegram Bot 开发技能 -├───timescaledb/ # TimescaleDB 时序数据库技能 -└───twscrape/ # Twscrape 数据抓取技能 +├── README.md # 本文件 +│ +├── # === 元技能（核心） === +├── claude-skills/ # ⭐ 元技能：生成 Skills 的 Skills（11KB） +│ +├── # === Claude 工具 === +├── claude-code-guide/ # Claude Code 使用指南（9KB） +├── claude-cookbooks/ # Claude API 最佳实践（9KB） +│ +├── # === 数据库 === +├── postgresql/ # ⭐ PostgreSQL 专家技能（76KB，最详细） +├── timescaledb/ # 时序数据库扩展（3KB） +│ +├── # === 加密货币/量化 === +├── ccxt/ # 加密货币交易所统一 API（18KB） +├── coingecko/ # CoinGecko 行情 API（3KB） +├── cryptofeed/ # 加密货币实时数据流（6KB） +├── hummingbot/ # 量化交易机器人框架（4KB） +├── polymarket/ # 预测市场 API（6KB） +│ +├── # === 开发工具 === +├── telegram-dev/ # Telegram Bot 开发（18KB） +├── twscrape/ # Twitter/X 数据抓取（11KB） +├── snapdom/ # DOM 快照工具（8KB） +└── proxychains/ # 代理链配置（6KB） ``` -## 各技能模块说明 +## Skills 一览表 -每个技能模块通常包含以下内容： +### 按文件大小排序（详细程度） -* **`SKILL.md`**: 该技能的详细描述、功能、使用场景和限制。 -* **`assets/`**: 与该技能相关的图像、图表或其他非代码资产。 -* **`references/`**: 相关文档、API 文档链接、教程或其他参考资料。 -* **`scripts/`**: 实现该技能的具体脚本或代码示例。 +| 技能 | 大小 | 领域 | 说明 | +|------|------|------|------| +| **postgresql** | 76KB | 数据库 | ⭐ 最详细，PostgreSQL 完整专家技能 | +| **telegram-dev** | 18KB | Bot 开发 | Telegram Bot 开发完整指南 | +| **ccxt** | 18KB | 交易 | 加密货币交易所统一 API | +| **twscrape** | 11KB | 数据采集 | Twitter/X 数据抓取 | +| **claude-skills** | 11KB | 元技能 | ⭐ 生成 Skills 的 Skills | +| **claude-code-guide** | 9KB | 工具 | Claude Code 使用最佳实践 | +| **claude-cookbooks** | 9KB | 工具 | Claude API 使用示例 | +| **snapdom** | 8KB | 前端 | DOM 快照与测试 | +| **cryptofeed** | 6KB | 数据流 | 加密货币实时数据流 | +| **polymarket** | 6KB | 预测市场 | Polymarket API 集成 | +| **proxychains** | 6KB | 网络 | 代理链配置与使用 | +| **hummingbot** | 4KB | 量化 | 量化交易机器人框架 | +| **timescaledb** | 3KB | 数据库 | PostgreSQL 时序扩展 | +| **coingecko** | 3KB | 行情 | CoinGecko 行情 API | -## 如何使用技能 +### 按领域分类 -AI Agent 在执行任务时，会根据任务需求调用相应的技能模块。开发者可以通过阅读每个技能模块内的 `SKILL.md` 文件，了解其具体功能和如何集成到 AI 的工作流程中。 +#### 🔧 元技能与工具 -## 扩展与贡献 +| 技能 | 说明 | 推荐场景 | +|------|------|----------| +| `claude-skills` | 生成 Skills 的 Skills | 创建新技能时必用 | +| `claude-code-guide` | Claude Code CLI 使用指南 | 日常开发 | +| `claude-cookbooks` | Claude API 最佳实践 | API 集成 | -本项目鼓励为 AI 技能库贡献新的技能模块。如果你有新的工具或领域知识希望集成到 AI 的能力中，可以创建一个新的子目录，并按照上述结构填充 `SKILL.md`、`assets/`、`references/` 和 `scripts/`。这有助于持续增强 AI 的能力和应用范围。 +#### 🗄️ 数据库 + +| 技能 | 说明 | 推荐场景 | +|------|------|----------| +| `postgresql` | PostgreSQL 完整指南（76KB） | 关系型数据库开发 | +| `timescaledb` | 时序数据库扩展 | 时间序列数据 | + +#### 💰 加密货币/量化 + +| 技能 | 说明 | 推荐场景 | +|------|------|----------| +| `ccxt` | 交易所统一 API | 多交易所对接 | +| `coingecko` | 行情数据 API | 价格查询 | +| `cryptofeed` | 实时数据流 | WebSocket 行情 | +| `hummingbot` | 量化交易框架 | 自动化交易 | +| `polymarket` | 预测市场 API | 预测市场交易 | + +#### 🛠️ 开发工具 + +| 技能 | 说明 | 推荐场景 | +|------|------|----------| +| `telegram-dev` | Telegram Bot 开发 | Bot 开发 | +| `twscrape` | Twitter 数据抓取 | 社交媒体数据 | +| `snapdom` | DOM 快照 | 前端测试 | +| `proxychains` | 代理链配置 | 网络代理 | + +## Skills vs Prompts 的区别 + +| 维度 | Prompts（提示词） | Skills（技能） | +|------|------------------|----------------| +| 粒度 | 单次任务指令 | 完整能力封装 | +| 复用性 | 复制粘贴 | 配置后自动生效 | +| 上下文 | 需手动提供 | 内置领域知识 | +| 适用场景 | 临时任务 | 长期项目 | +| 结构 | 单文件 | 目录（含 assets/scripts/references） | + +## 技能目录结构 + +每个技能遵循统一结构： + +``` +skill-name/ +├── SKILL.md # 技能主文件，包含领域知识和规则 +├── assets/ # 静态资源（图片、配置模板等） +├── scripts/ # 辅助脚本 +└── references/ # 参考文档 +``` + +## 快速使用 + +### 1. 查看技能 + +```bash +# 查看元技能 +cat skills/claude-skills/SKILL.md + +# 查看 PostgreSQL 技能（最详细） +cat skills/postgresql/SKILL.md + +# 查看 Telegram Bot 开发技能 +cat skills/telegram-dev/SKILL.md +``` + +### 2. 复制到项目中使用 + +```bash +# 复制整个技能目录 +cp -r skills/postgresql/ ./my-project/ + +# 或只复制主文件到 CLAUDE.md +cp skills/postgresql/SKILL.md ./CLAUDE.md +``` + +### 3. 结合 Claude Code 使用 + +在项目根目录创建 `CLAUDE.md`，引用技能： + +```markdown +# 项目规则 + +请参考以下技能文件： +@skills/postgresql/SKILL.md +@skills/telegram-dev/SKILL.md +``` + +## 创建自定义 Skill + +### 方法一：使用元技能生成（推荐） + +1. 准备领域资料（文档、代码、规范） +2. 将资料和 `skills/claude-skills/SKILL.md` 一起提供给 AI +3. AI 会生成针对该领域的专用 Skill + +```bash +# 示例：让 AI 读取元技能后生成新技能 +cat skills/claude-skills/SKILL.md +# 然后告诉 AI：请根据这个元技能，为 [你的领域] 生成一个新的 SKILL.md +``` + +### 方法二：手动创建 + +```bash +# 创建技能目录 +mkdir -p skills/my-skill/{assets,scripts,references} + +# 创建主文件 +cat > skills/my-skill/SKILL.md << 'EOF' +# My Skill + +## 概述 +简要说明技能用途和适用场景 + +## 领域知识 +- 核心概念 +- 最佳实践 +- 常见模式 + +## 规则与约束 +- 必须遵守的规则 +- 禁止的操作 +- 边界条件 + +## 示例 +具体的使用示例和代码片段 + +## 常见问题 +FAQ 和解决方案 +EOF +``` + +## 核心技能详解 + +### `claude-skills/SKILL.md` - 元技能 ⭐ + +**生成 Skills 的 Skills**，是创建新技能的核心工具。 + +使用方法： +1. 准备你的领域资料（文档、代码、规范等） +2. 将资料和 SKILL.md 一起提供给 AI +3. AI 会生成针对该领域的专用 Skill + +### `postgresql/SKILL.md` - PostgreSQL 专家 ⭐ + +最详细的技能（76KB），包含： +- 数据库设计最佳实践 +- 查询优化技巧 +- 索引策略 +- 性能调优 +- 常见问题解决方案 +- SQL 代码示例 + +### `telegram-dev/SKILL.md` - Telegram Bot 开发 + +完整的 Telegram Bot 开发指南（18KB）： +- Bot API 使用 +- 消息处理 +- 键盘与回调 +- Webhook 配置 +- 错误处理 + +### `ccxt/SKILL.md` - 加密货币交易所 API + +统一的交易所 API 封装（18KB）： +- 支持 100+ 交易所 +- 统一的数据格式 +- 订单管理 +- 行情获取 + +## 相关资源 + +- [Skills 生成器](https://github.com/yusufkaraaslan/Skill_Seekers) - 把任何资料转为 AI Skills +- [元技能文件](./claude-skills/SKILL.md) - 生成 Skills 的 Skills +- [提示词库](../prompts/) - 更细粒度的提示词集合 +- [Claude Code 指南](./claude-code-guide/SKILL.md) - Claude Code 使用最佳实践 +- [文档库](../documents/) - 方法论与开发经验 diff --git a/skills/claude-skills/SKILL.md b/skills/claude-skills/SKILL.md index 440e45c9d3830d5a12422ccf2ef3dded7d42ea6a..09f3683e7ad246a9fc640b1c6078fd41a4d0e22b 100644 GIT binary patch literal 6846 zcmcgx+io1k5q+PpD3C!ct~k3UZ6(UWu}$$J(GewCq$~t025ips?zTBMPtTCtm8?6;PE|1s!yr?so>G*kI@Y1RGD%{CSlg&H zMP>4AN+-Hf?g7p7lA=d>byU?QKB_FH z95z$)XYF@kgQ}>~Dq1$?;yhI*3vHnzGdB_G+d`L>f$@2nr!cZ2o7ZKeDa8v)qmpqD z;u^tbW5FHB9a}yJ!Iv}|b=Me;rnE$)!u{BY$((cGWD7@$ z!|{RLRBCreIFlXZJ)Pt#wiK@rF%zjIS+T24T9o;mfs{gUg$}jM|G;9Hqbe^~ zblUJj5L{eb1eQr8WGb2j@816W?(JXjU*}P3|82shKh!W2gP4#=gDmQ8Ro3dtPTGC= zfXwt^nbMht&v9?$8^AI*3w$uCT4>v|;Zw42q;KPiPT;jBak1~MKX$3-y41i=_x}FA zm(AlgVgh#YLkq$dOsAd*-5NpTANNk4(oqSJBN6~F-D`ZZCEi@AG!a9N+B@HN-q@s9 znfamC1OR0fh?cDY6S|BP6Tos+Ak*#EPzhWbR5-U!o*PdGAPq9eH}Eh=Q%?C(1FT5p z7z{LwcB;y&IKRnyXG~X4VTSM9PmsRU6C=v!RMcgW<9(a}RcRIriGj{kX>!2PNr8jg zGvH}R$&X5-=d3A-${fYOB3R$?;wQGT{vX*cq_eg6(hf4_-@e?HcOUm?J~)7uB8y@i zK}WT4oUL@>sHm)yMnev76_bJ$Px@bIXG*7$yJ*1tR5EFptf;F=URU@5t8SY+KGuL2 zktCooP$7iZ(<+~~_p3YSVOb)lpTMnPlm%XpreI*r-@4=3JdqQ7nQN&n=m3qKS8j1b zM&ji05ZgVekT`jUfFJmZ@>Ekx6$0r?WtTyE6`PX6f*Q0;espQR-H2zGc|UbPJY~bX zt>GrKI=d0b{mag1vw*(%f<8HXe)P!)aq7_4!|8`$ID6qhd@cz21yK!Ywhk$`et@W1 z3#ooR;TEBJ5ac z@Bv?T!Q35FBN;RR3NLAyx4Wbyyymj6bX+pH9BQ9qCYY8N=p~a>02hAeUhWyl*9BZ8 zeRKN!S%72gFLiW4EY1Xo$;;IlF90i0=#NL`{5$t{X$RJ7nN z4RQ}YAJZYPrtZ41y3n^%`qS*q%{V;2|F!@5X8h*n{;xV`z%+QwRab2?3>~pa{(-}W z+?H2-k8&vZaf460F{O=f@@2NMO&d5ce%*c0SRUj|PHZejta`JGOGm{A7^pGoEZF*MkEwnfQ@&WxHy;Pk#jAJs|H=OUNl|Cf42C}Krhs6jo%Q^Cj)1q%AeO^tC_~oBgu5c)YPQ35)_LHS$cpy(r)=pxPn(?cr0+9O z&eR+NRz@Sq#wmIy4%AFaopT4h(a5D;`_NTD{wWSO%z<9D^WPLd!5z7B=#KUk7q@qG z>Z>2R3+@16{U{WOY0$6nuiL#L7%;2+*Q^zgEDe4&~q;*RX*XeVO+#> zui1<#cg3+X0c*_ToJGF7SqPnJ)V0@Rc~_&w4FYeSs}aUR&paMOZndV_sW_BdV*0i=(G{FnR_FJYRaMyO zgvT0o9Ld0J3<{a(Y@!O|!w^az&t;Z0FPrq(jnBAi_jYCWb?W9`Cn$$_?$r}4Izx>B zkica~j5%fqc+Tym9gR?E@u>y{xr}*A03@pw#(nVMXvC;$qVBexN;3iH#1QP^=!E@< z5lFu`b$d`!nS~oaNpCHJ0%xG+DPzl8J{leEed`v3b-BktABtHH^h{W+Z8O~c8ed@D z5gJri2XY0MCkbW=?G%vS{p}xwiyV5;$>gpbLda8`xot${3!LV4Y0yNqB|jT^fYBdU zjlV`q>uS$dCQt;XMKu(*z@HEuX)~ykpgE{>QegInlXEnA)WV^g3K^`&b55-6n7%{#R7^c$-)jk2~V|H5OQzl=<_+ zn(xINA!A`nB8|Fu?Pyuypg&=S>d$1VqcHOn)Ap;5wXEw-)`<%qiqHg1c6J}^?C$*b zH{lJ&qi}fh=YuV_>eS1bWQui!`jNIDej3W~(#uVVKMXh$l~=gPBdrF!|BG-b2j0^)Z~S$|J6I}mJpERF4wFC&ub|MCPOa4Um<0p@P~iU0rr literal 10817 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 + +SKILL_NAME=$1 + +if [ -z "$SKILL_NAME" ]; then + echo "Usage: ./create-skill.sh " + echo "Example: ./create-skill.sh my-awesome-skill" + exit 1 +fi + +mkdir -p "$SKILL_NAME"/{assets,scripts,references} + +cat > "$SKILL_NAME/SKILL.md" << 'EOF' +--- +name: SKILL_NAME_PLACEHOLDER +description: Skill description +--- + +# Skill Name + +## Overview + +Brief explanation of the skill's purpose. + +## When to Use This Skill + +- Scenario 1 +- Scenario 2 + +## Instructions + +[Detailed instructions] + +## Examples + +[Usage examples] + +## Constraints + +- Limitation 1 +- Limitation 2 +EOF + +sed -i "s/SKILL_NAME_PLACEHOLDER/$SKILL_NAME/g" "$SKILL_NAME/SKILL.md" + +echo "✅ Created Skill: $SKILL_NAME/" +echo " ├── SKILL.md" +echo " ├── assets/" +echo " ├── scripts/" +echo " └── references/" +echo "" +echo "Next: Edit $SKILL_NAME/SKILL.md to add your instructions"