# ai-proj-helper

Claude Code 技能市场 + MCP 配置管理工具。整合公共技能、个人技能、MCP 服务器配置于一体。

> **从 claude-marketplace 迁移？** 本仓库是 claude-marketplace 的超集，已包含所有原有插件。直接使用本仓库即可，无需额外迁移。

## 快速开始

```bash
# 1. 克隆仓库
git clone https://gitea.pipexerp.com/pipexerp/ai-proj-helper.git
cd ai-proj-helper

# 2. 运行初始化（交互式配置 MCP + 生成 marketplace）
./init.sh

# 3. 添加技能市场
/plugin marketplace add /path/to/ai-proj-helper
```

也可以使用命令行参数跳过交互：

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

## 目录结构

```
ai-proj-helper/
├── .claude-plugin/marketplace.json    # 自动生成
├── claude-config.yaml                 # 技能启用/禁用 + MCP 配置
├── init.sh                            # MCP + marketplace 初始化
├── sync-skills.sh                     # 同步本地技能
├── generate-marketplace.py            # marketplace 生成器
├── skills/                            # 通用技能 (42 个，Git 版本控制)
│   ├── ai-proj-plugin/
│   ├── dev-coding-plugin/
│   ├── feishu-plugin/
│   └── ...
├── skills-projects/                   # 项目技能 (5 个，Git 版本控制)
│   ├── coolbuy-*-plugin/
│   └── enjoysa-*-plugin/
└── skills-personal/                   # 个人技能 (.gitignore 排除)
    └── qiudl-personal-plugin/
```

## 可用技能

### 通用技能 (skills/, 42 个)

- **开发**: ai-proj, dev, dev-arch, dev-coding, dev-test, frontend-design, agent-swarm
- **DevOps**: ops-tools, ops-servers, req-deploy
- **需求管理**: req, req-commands, req-dev, req-prd, req-review, req-test-gate, req-workflow, requirement, executing-plans
- **业务**: biz-plan, biz-contract, biz-ops, finance
- **集成**: feishu, feishu-bitable, feishu-docx, wecom, siyuan, siyuan-to-feishu, data-excel, doubao-voice
- **通用工具**: openclaw, openclaw-ops, pull-request, finishing-a-development-branch, skill-manager, gitea
- **会话管理**: save-session, reload-session, read-session, search-sessions, session

### 项目技能 (skills-projects/, 5 个)

- **酷采**: coolbuy-legacy, coolbuy-paas, coolbuy-platform
- **畅游南澳**: enjoysa, enjoysa-deploy

## 配置管理

### claude-config.yaml

```yaml
version: "1.0"

mcp:
  mode: stdio          # stdio | sse
  env: prod            # dev | staging | prod

skills:
  disabled: []         # 禁用的技能列表
  personal_dir: "skills-personal"
```

### 禁用技能

编辑 `claude-config.yaml` 添加要禁用的技能：

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

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

## 同步本地技能

将 `~/.claude/skills/` 中的技能同步到仓库：

```bash
./sync-skills.sh
```

## MCP 环境

| 环境 | API 地址 | 用途 |
|------|----------|------|
| dev | http://localhost:8080 | 本地开发 |
| staging | https://ai-staging.pipexerp.com | 测试环境 |
| prod | https://ai.pipexerp.com | 生产环境 |

## 作者

**Donglin Lai (qiudl)** - qiudl@zhiyuncai.com

## 仓库

https://gitea.pipexerp.com/pipexerp/ai-proj-helper