# 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-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
├── skills-personal/       # 个人（.gitignore 排除）
├── claude-config.yaml     # 技能启用/禁用 + MCP 配置
├── init.sh                # MCP + marketplace 初始化
├── sync-skills.sh         # 从 ~/.claude/skills/ 同步技能
└── generate-marketplace.py
```

## 添加新技能

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

## 禁用技能

编辑 `claude-config.yaml`：

```yaml
skills:
  disabled:
    - "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-personal/` 不被 Git 跟踪，用于存放个人配置和工具
- 其余 `skills-*` 目录均由 Git 版本控制
- 所有目录都会被 `generate-marketplace.py` 自动扫描并加入 marketplace.json