# ai-toolkit

**Repository Path**: sheep-cloud/ai-toolkit

## Basic Information

- **Project Name**: ai-toolkit
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-27
- **Last Updated**: 2026-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Toolkit

个人 AI 工具箱 — 集中管理 Claude Code skills、MCP server、通用 prompt 模板和相关配置。

## 项目结构

```
ai-toolkit/
├── claude/                      # Claude Code 专属
│   ├── skills/                  # Skills（按类型分目录）
│   │   ├── _template/           #   skill 模板
│   │   ├── dev/                 #   开发类（代码生成、SQL 编写等）
│   │   ├── workflow/            #   流程类（PRD 转方案、需求分析等）
│   │   └── ops/                 #   运维类（日志分析、部署等）
│   ├── CLAUDE.md                # 全局 Claude 指令（源文件）
│   └── settings.json            # Claude Code 配置（源文件）
│
├── mcp/                         # MCP 相关
│   ├── servers/                 #   自建 MCP server（每个独立子项目）
│   └── configs/                 #   各客户端的 MCP 配置
│
├── prompts/                     # 通用 prompt 模板（工具无关）
│   ├── dev/                     #   开发相关
│   └── data/                    #   数据分析相关
│
├── docs/                        # 使用文档
│   ├── setup.md                 #   安装同步指南
│   └── mcp-dev-guide.md         #   MCP server 开发指南
│
└── scripts/                     # 同步/安装脚本
    ├── install.sh               #   一键初始化
    ├── sync-skills.sh           #   同步 skills 到 ~/.claude/
    └── sync-mcp-config.sh       #   同步 MCP 配置到各客户端
```

## 快速开始

```bash
# 克隆
git clone <repo-url>
cd ai-toolkit

# 赋予脚本可执行权限（首次需要）
chmod +x scripts/*.sh

# 一键同步配置到生效位置
./scripts/install.sh
```

## 核心概念

**此仓库是「源」，不是「生效位置」。**

Claude Code 的 skills、CLAUDE.md 等有固定的生效路径（如 `~/.claude/skills/`），本仓库通过 `scripts/` 下的同步脚本将配置部署到正确位置。这样做的好处：

- 所有 AI 配置集中版本管理
- 支持多环境（可扩展到 Claude Desktop、Cursor 等）
- 可在多台机器间同步

## 文档

- [安装与同步指南](docs/setup.md)
- [MCP Server 开发指南](docs/mcp-dev-guide.md)
- [Skill 编写模板](claude/skills/_template/skill.md)
- [Prompt 编写规范](prompts/README.md)