# ai-proj-helper

Claude Code 技能市场 + MCP 配置管理工具。

## 快速开始

```bash
./init.sh
```

交互式配置 MCP 连接和生成 marketplace.json。支持命令行参数：

```bash
./init.sh --mode stdio --env prod --token YOUR_TOKEN
```

## 目录结构

```
ai-proj-helper/
├── skills/                    # 通用技能（Git 版本控制）
│   ├── ai-proj-plugin/
│   │   ├── .claude-plugin/plugin.json
│   │   └── skills/SKILL.md
│   └── ...
├── skills-projects/           # 项目技能（Git 版本控制）
│   ├── coolbuy-legacy-plugin/
│   ├── coolbuy-paas-plugin/
│   ├── coolbuy-platform-plugin/
│   ├── enjoysa-plugin/
│   └── enjoysa-deploy-plugin/
├── skills-personal/           # 个人技能（.gitignore 排除）
│   └── qiudl-personal-plugin/
├── claude-config.yaml         # 技能启用/禁用 + MCP 配置
├── init.sh                    # MCP + marketplace 初始化
├── sync-skills.sh             # 从 ~/.claude/skills/ 同步技能
└── generate-marketplace.py    # marketplace.json 生成器
```

## 添加新技能

1. 在 `skills/` 下创建 `<name>-plugin/` 目录
2. 创建 `.claude-plugin/plugin.json` 和 `skills/SKILL.md`
3. 运行 `python3 generate-marketplace.py` 重新生成 marketplace.json

## 禁用技能

编辑 `claude-config.yaml`：

```yaml
skills:
  disabled:
    - "dotfiles-plugin"
    - "biz-ops-plugin"
```

重新运行 `./init.sh` 或 `python3 generate-marketplace.py`。

## MCP 环境

| 环境 | API 地址 |
|------|----------|
| dev | http://localhost:8080/api/v1 |
| staging | https://ai-staging.pipexerp.com/api/v1 |
| prod | https://ai.pipexerp.com/api/v1 |

## 项目技能

`skills-projects/` 存放特定业务项目的技能（coolbuy、enjoysa 等），由 Git 版本控制。

## 个人技能

`skills-personal/` 目录不被 Git 跟踪，用于存放个人配置和工具。

两者都会被 `generate-marketplace.py` 扫描并加入 marketplace.json。