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

251
README.md
View File

@@ -1,179 +1,130 @@
# Claude Code Plugin Marketplace
# ai-proj-helper
Custom Claude Code plugins for development workflows, DevOps, and business operations.
Claude Code 技能市场 + MCP 配置管理工具。整合公共技能、个人技能、MCP 服务器配置于一体。
## 🚀 Quick Start
> **从 claude-marketplace 迁移?** 本仓库是 claude-marketplace 的超集,已包含所有原有插件。直接使用本仓库即可,无需额外迁移。
### Add the Marketplace
## 快速开始
```bash
/plugin marketplace add git@gitea.pipexerp.com:huangjun/claude-marketplace.git
# 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
```
Or using HTTPS (requires credential configuration):
```bash
/plugin marketplace add https://gitea.pipexerp.com/huangjun/claude-marketplace.git
```
### Install Plugins
也可以使用命令行参数跳过交互:
```bash
# Install specific plugin
/plugin install ai-proj-plugin@coolbuy-claude-plugins
# List all available plugins
/plugin marketplace list coolbuy-claude-plugins
./init.sh --mode stdio --env prod --token YOUR_TOKEN
```
## 📦 Available Plugins (40 Total)
## 目录结构
### 🚀 Development & Coding
- **ai-proj-plugin** - AI project management with MCP integration
- **dev-plugin** - General development workflows
- **dev-arch-plugin** - Software architecture and design
- **dev-coding-plugin** - Coding standards and best practices
- **dev-test-plugin** - Testing workflows and automation
- **frontend-design-plugin** - Frontend design and UI/UX
### 🔧 DevOps & Operations
- **ops-tools-plugin** - DevOps tools for deployment and monitoring
- **ops-servers-plugin** - Server management and SSH operations
- **enjoysa-deploy-plugin** - Enjoysa deployment automation
- **req-deploy-plugin** - Requirement deployment workflows
### 📋 Project & Requirements Management
- **req-plugin** - Requirement management workflows
- **req-dev-plugin** - Requirement development processes
- **req-prd-plugin** - PRD (Product Requirements Document) creation
- **req-commands-plugin** - Detailed command reference for /req
- **req-review-plugin** - PRD review methodology
- **req-workflow-plugin** - Complete requirement lifecycle workflow
- **requirement-plugin** - General requirement handling
- **executing-plans-plugin** - Plan execution and tracking
### 💼 Business Operations
- **biz-plan-plugin** - Business planning and proposals
- **biz-contract-plugin** - Contract drafting and management
- **finance-plugin** - Financial operations and reporting
### 🔗 Integrations
- **feishu-plugin** - Feishu/Lark integration (documents, spreadsheets)
- **feishu-bitable-plugin** - Feishu Bitable (multi-dimensional tables)
- **feishu-docx-plugin** - Feishu cloud documents
- **wecom-plugin** - WeChat Work integration
- **siyuan-plugin** - SiYuan note-taking integration
- **data-excel-plugin** - Excel data processing
- **doubao-voice-plugin** - Doubao Voice API (TTS, ASR, dialogue)
### 🏢 Project-Specific
- **coolbuy-legacy-plugin** - Coolbuy legacy system workflows
- **coolbuy-paas-plugin** - Coolbuy PaaS platform operations
- **coolbuy-platform-plugin** - Coolbuy platform development
- **enjoysa-plugin** - Enjoysa project workflows
### 🔄 Session Management
- **save-session-plugin** - Save Claude Code sessions
- **reload-session-plugin** - Reload saved sessions
- **read-session-plugin** - Read session data
- **search-sessions-plugin** - Search through sessions
### 🛠️ Utilities
- **pr-plugin** - Pull request creation and management
- **finishing-a-development-branch-plugin** - Branch finishing workflows
- **skill-manager-plugin** - Skill management utilities
- **qiudl-personal-plugin** - Personal productivity tools
## 📖 Usage Examples
### AI Project Management
```bash
/ai-proj-plugin:create-task "Implement user authentication"
/ai-proj-plugin:start-timer
```
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/
```
### DevOps Operations
```bash
/ops-tools-plugin:deploy production
/ops-servers-plugin:check-status
## 可用技能 (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"
```
### Development Workflow
```bash
/dev-coding-plugin:start-feature "user-profile"
/finishing-a-development-branch-plugin:create-pr
### 禁用技能
编辑 `claude-config.yaml` 添加要禁用的技能:
```yaml
skills:
disabled:
- "dotfiles-plugin"
- "biz-ops-plugin"
```
### Business Operations
```bash
/biz-contract-plugin:draft "Software Subscription Agreement"
/biz-plan-plugin:create-proposal
```
然后重新运行 `./init.sh``python3 generate-marketplace.py`
## 🔐 Private Repository Access
## 同步本地技能
For background auto-updates, set authentication token:
`~/.claude/skills/` 中的技能同步到仓库:
```bash
# Add to ~/.zshrc or ~/.bashrc
export GITEA_TOKEN="your-gitea-token"
./sync-skills.sh
```
## 📝 Plugin Naming Convention
## MCP 环境
All plugins use namespaced commands to avoid conflicts:
- Format: `/plugin-name:command-name`
- Example: `/ai-proj-plugin:create-task`
| 环境 | API 地址 | 用途 |
|------|----------|------|
| dev | http://localhost:8080 | 本地开发 |
| staging | https://ai-staging.pipexerp.com | 测试环境 |
| prod | https://ai.pipexerp.com | 生产环境 |
## 🔄 Updates
## 作者
Update the marketplace and plugins:
**Donglin Lai (qiudl)** - qiudl@zhiyuncai.com
```bash
# Update marketplace catalog
/plugin marketplace update coolbuy-claude-plugins
## 仓库
# Update specific plugin
/plugin update ai-proj-plugin@coolbuy-claude-plugins
# Update all plugins from this marketplace
/plugin update-all
```
## 🏗️ Plugin Structure
Each plugin follows the official Claude Code plugin structure:
```
plugin-name-plugin/
├── .claude-plugin/
│ └── plugin.json # Plugin metadata
├── skills/
│ └── SKILL.md # Agent skills
└── [scripts, configs, etc.]
```
## 📚 Documentation
- [Official Claude Code Plugin Docs](https://code.claude.com/docs/en/plugins)
- [Plugin Marketplace Guide](https://code.claude.com/docs/en/plugin-marketplaces)
## 👤 Author
**Donglin Lai (qiudl)**
- Email: qiudl@zhiyuncai.com
- Organization: PipeX ERP
## 📄 License
Individual plugins may have their own licenses. Please check each plugin's documentation.
## 🤝 Contributing
To add or update plugins:
1. Clone this repository
2. Add/modify plugins in the `plugins/` directory
3. Regenerate `marketplace.json` using the provided scripts
4. Submit changes
---
**Repository**: git@gitea.pipexerp.com:huangjun/claude-marketplace.git
https://gitea.pipexerp.com/pipexerp/ai-proj-helper