John Qiu
ea266e9cce
将 coolbuy (3) 和 enjoysa (2) 共 5 个项目特定技能从 skills/ 移至 skills-projects/， 保持通用技能与业务项目技能分离。 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
117 lines
3.3 KiB
Markdown
117 lines
3.3 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/ # 通用技能 (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
|