# 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-dev/            # 开发 (9)
├── skills-req/            # 需求管理 (10)
├── skills-ops/            # 运维 (4)
├── skills-integration/    # 第三方集成 (8)
├── skills-biz/            # 商务 (4)
├── skills-workflow/       # 工作流 (7)
├── skills-projects/       # 项目特定 (5)
└── skills-personal/       # 个人（.gitignore 排除）
```

## 可用技能 (49)

### skills-dev/ — 开发 (9)

dev, dev-arch, dev-coding, dev-test, frontend-design, agent-swarm, pull-request, finishing-a-development-branch, gitea

### skills-req/ — 需求管理 (10)

req, req-commands, req-dev, req-prd, req-review, req-test-gate, req-workflow, req-deploy, requirement, executing-plans

### skills-ops/ — 运维 (4)

ops-tools, ops-servers, openclaw, openclaw-ops

### skills-integration/ — 第三方集成 (8)

feishu, feishu-bitable, feishu-docx, wecom, siyuan, siyuan-to-feishu, data-excel, doubao-voice

### skills-biz/ — 商务 (4)

biz-contract, biz-ops, biz-plan, finance

### skills-workflow/ — 工作流 (7)

ai-proj, save-session, reload-session, read-session, search-sessions, session, skill-manager

### 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` 添加要禁用的技能名称，然后重新运行 `./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