refactor: 合并 claude-marketplace,重构目录结构为单一仓库

- 重命名 plugins/ → skills/,个人插件迁移到 skills-personal/(gitignore)
- 更新 generate-marketplace.py 支持 config 读取和 skills-personal 扫描
- 新增 claude-config.yaml(技能启用/禁用 + MCP 配置)
- 新增 init.sh(交互式 MCP 初始化,支持 stdio/SSE 模式)
- 新增 CLAUDE.md 项目说明
- 重写 README.md 反映新结构
- 删除过时脚本:PUSH.sh、generate-marketplace.sh、convert-skills.sh

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-14 11:11:59 +10:30
parent f7f5428812
commit 99881e268a
191 changed files with 1131 additions and 492 deletions

64
CLAUDE.md Normal file
View File

@@ -0,0 +1,64 @@
# 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-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-personal/` 目录不被 Git 跟踪,用于存放个人配置和工具。
个人技能同样会被 `generate-marketplace.py` 扫描并加入 marketplace.json。