John Qiu
99881e268a
- 重命名 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>
131 lines
3.0 KiB
Markdown
131 lines
3.0 KiB
Markdown
# 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/ # 公共技能 (48 个，Git 版本控制)
|
||
│ ├── ai-proj-plugin/
|
||
│ ├── dev-coding-plugin/
|
||
│ ├── feishu-plugin/
|
||
│ └── ...
|
||
└── skills-personal/ # 个人技能 (.gitignore 排除)
|
||
└── qiudl-personal-plugin/
|
||
```
|
||
|
||
## 可用技能 (48 公共)
|
||
|
||
### 开发
|
||
|
||
ai-proj, dev, dev-arch, dev-coding, dev-test, frontend-design, agent-swarm
|
||
|
||
### DevOps
|
||
|
||
ops-tools, ops-servers, enjoysa-deploy, 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
|
||
|
||
### 项目
|
||
|
||
coolbuy-legacy, coolbuy-paas, coolbuy-platform, enjoysa, openclaw, openclaw-ops
|
||
|
||
### 会话管理
|
||
|
||
save-session, reload-session, read-session, search-sessions, session
|
||
|
||
### 工具
|
||
|
||
pull-request, finishing-a-development-branch, skill-manager, dotfiles, gitea
|
||
|
||
## 配置管理
|
||
|
||
### 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
|