mirror of
https://github.com/cexll/myclaude.git
synced 2026-02-12 03:27:47 +08:00
ebd795c583
- Add per-module agent merge/unmerge for ~/.codeagent/models.json with __module__ tracking, user-customization protection, and agent restore on uninstall when shared by multiple modules - Add post-install verification (wrapper version, PATH, backend CLIs) - Install CLAUDE.md by default, best-effort (never crashes main flow) - Fix 7-phase → 5-phase references across all docs - Document 9 skills, 11 commands, claudekit module, OpenCode backend - Add templates/models.json.example with all agent presets (do + omo) - Fix empty parent directory cleanup on copy_file uninstall - Update USER_GUIDE.md with 13 CLI flags and OpenCode backend Generated with SWE-Agent.ai Co-Authored-By: SWE-Agent.ai <noreply@swe-agent.ai>
172 lines
5.8 KiB
Markdown
172 lines
5.8 KiB
Markdown
[中文](README_CN.md) [English](README.md)
|
|
|
|
# Claude Code Multi-Agent Workflow System
|
|
|
|
[](https://smithery.ai/skills?ns=cexll&utm_source=github&utm_medium=badge)
|
|
[](https://www.gnu.org/licenses/agpl-3.0)
|
|
[](https://claude.ai/code)
|
|
[](https://github.com/cexll/myclaude)
|
|
|
|
> AI-powered development automation with multi-backend execution (Codex/Claude/Gemini/OpenCode)
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
npx github:cexll/myclaude
|
|
```
|
|
|
|
## Modules Overview
|
|
|
|
| Module | Description | Documentation |
|
|
|--------|-------------|---------------|
|
|
| [do](skills/do/README.md) | **Recommended** - 5-phase feature development with codeagent orchestration | `/do` command |
|
|
| [omo](skills/omo/README.md) | Multi-agent orchestration with intelligent routing | `/omo` command |
|
|
| [bmad](agents/bmad/README.md) | BMAD agile workflow with 6 specialized agents | `/bmad-pilot` command |
|
|
| [requirements](agents/requirements/README.md) | Lightweight requirements-to-code pipeline | `/requirements-pilot` command |
|
|
| [essentials](agents/development-essentials/README.md) | 11 core dev commands: ask, bugfix, code, debug, docs, enhance-prompt, optimize, refactor, review, test, think | `/code`, `/debug`, etc. |
|
|
| [sparv](skills/sparv/README.md) | SPARV workflow (Specify→Plan→Act→Review→Vault) | `/sparv` command |
|
|
| course | Course development (combines dev + product-requirements + test-cases) | Composite module |
|
|
| claudekit | ClaudeKit: do skill + global hooks (pre-bash, inject-spec, log-prompt) | Composite module |
|
|
|
|
### Available Skills
|
|
|
|
Individual skills can be installed separately via `npx github:cexll/myclaude --list` (skills bundled in modules like do, omo, sparv are listed above):
|
|
|
|
| Skill | Description |
|
|
|-------|-------------|
|
|
| browser | Browser automation for web testing and data extraction |
|
|
| codeagent | codeagent-wrapper invocation for multi-backend AI code tasks |
|
|
| codex | Direct Codex backend execution |
|
|
| dev | Lightweight end-to-end development workflow |
|
|
| gemini | Direct Gemini backend execution |
|
|
| product-requirements | Interactive PRD generation with quality scoring |
|
|
| prototype-prompt-generator | Structured UI/UX prototype prompt generation |
|
|
| skill-install | Install skills from GitHub with security scanning |
|
|
| test-cases | Comprehensive test case generation from requirements |
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
# Interactive installer (recommended)
|
|
npx github:cexll/myclaude
|
|
|
|
# List installable items (modules / skills / wrapper)
|
|
npx github:cexll/myclaude --list
|
|
|
|
# Detect installed modules and update from GitHub
|
|
npx github:cexll/myclaude --update
|
|
|
|
# Custom install directory / overwrite
|
|
npx github:cexll/myclaude --install-dir ~/.claude --force
|
|
```
|
|
|
|
`--update` detects already installed modules in the target install dir (defaults to `~/.claude`, via `installed_modules.json` when present) and updates them from GitHub (latest release) by overwriting the module files.
|
|
|
|
### Module Configuration
|
|
|
|
Edit `config.json` to enable/disable modules:
|
|
|
|
```json
|
|
{
|
|
"modules": {
|
|
"bmad": { "enabled": false },
|
|
"requirements": { "enabled": false },
|
|
"essentials": { "enabled": false },
|
|
"omo": { "enabled": false },
|
|
"sparv": { "enabled": false },
|
|
"do": { "enabled": true },
|
|
"course": { "enabled": false }
|
|
}
|
|
}
|
|
```
|
|
|
|
## Workflow Selection Guide
|
|
|
|
| Scenario | Recommended |
|
|
|----------|-------------|
|
|
| Feature development (default) | `/do` |
|
|
| Bug investigation + fix | `/omo` |
|
|
| Large enterprise project | `/bmad-pilot` |
|
|
| Quick prototype | `/requirements-pilot` |
|
|
| Simple task | `/code`, `/debug` |
|
|
|
|
## Core Architecture
|
|
|
|
| Role | Agent | Responsibility |
|
|
|------|-------|----------------|
|
|
| **Orchestrator** | Claude Code | Planning, context gathering, verification |
|
|
| **Executor** | codeagent-wrapper | Code editing, test execution (Codex/Claude/Gemini/OpenCode) |
|
|
|
|
## Backend CLI Requirements
|
|
|
|
| Backend | Required Features |
|
|
|---------|-------------------|
|
|
| Codex | `codex e`, `--json`, `-C`, `resume` |
|
|
| Claude | `--output-format stream-json`, `-r` |
|
|
| Gemini | `-o stream-json`, `-y`, `-r` |
|
|
| OpenCode | `opencode`, stdin mode |
|
|
|
|
## Directory Structure After Installation
|
|
|
|
```
|
|
~/.claude/
|
|
├── bin/codeagent-wrapper
|
|
├── CLAUDE.md (installed by default)
|
|
├── commands/ (from essentials module)
|
|
├── agents/ (from bmad/requirements modules)
|
|
├── skills/ (from do/omo/sparv/course modules)
|
|
├── hooks/ (from claudekit module)
|
|
├── settings.json (auto-generated, hooks config)
|
|
└── installed_modules.json (auto-generated, tracks modules)
|
|
```
|
|
|
|
## Documentation
|
|
|
|
- [codeagent-wrapper](codeagent-wrapper/README.md)
|
|
- [Plugin System](PLUGIN_README.md)
|
|
|
|
## Troubleshooting
|
|
|
|
### Common Issues
|
|
|
|
**Codex wrapper not found:**
|
|
```bash
|
|
# Select: codeagent-wrapper
|
|
npx github:cexll/myclaude
|
|
```
|
|
|
|
**Module not loading:**
|
|
```bash
|
|
cat ~/.claude/installed_modules.json
|
|
npx github:cexll/myclaude --force
|
|
```
|
|
|
|
**Backend CLI errors:**
|
|
```bash
|
|
which codex && codex --version
|
|
which claude && claude --version
|
|
which gemini && gemini --version
|
|
```
|
|
|
|
## FAQ
|
|
|
|
| Issue | Solution |
|
|
|-------|----------|
|
|
| "Unknown event format" | Logging display issue, can be ignored |
|
|
| Gemini can't read .gitignore files | Remove from .gitignore or use different backend |
|
|
| Codex permission denied | Set `approval_policy = "never"` in ~/.codex/config.yaml |
|
|
|
|
See [GitHub Issues](https://github.com/cexll/myclaude/issues) for more.
|
|
|
|
## License
|
|
|
|
AGPL-3.0 - see [LICENSE](LICENSE)
|
|
|
|
### Commercial Licensing
|
|
|
|
For commercial use without AGPL obligations, contact: evanxian9@gmail.com
|
|
|
|
## Support
|
|
|
|
- [GitHub Issues](https://github.com/cexll/myclaude/issues)
|