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:
251
README.md
251
README.md
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user