From ed4b0886315be8d03119520920ad1df46e5760a2 Mon Sep 17 00:00:00 2001 From: cexll Date: Wed, 14 Jan 2026 14:29:15 +0800 Subject: [PATCH] docs: add OmO workflow to README and fix plugin marketplace structure - Add OmO multi-agent orchestrator documentation to README.md and README_CN.md - Fix marketplace.json to follow official Claude Code plugin schema - Add $schema field and move version/description to top level - Create proper .claude-plugin/plugin.json for all plugins - Remove non-standard marketplace.json from plugin subdirectories - Simplify plugin names: omo, dev, requirements, bmad, essentials Generated with SWE-Agent.ai Co-Authored-By: SWE-Agent.ai --- .claude-plugin/marketplace.json | 228 +++--------------- README.md | 35 +++ README_CN.md | 35 +++ .../.claude-plugin/marketplace.json | 37 --- .../.claude-plugin/plugin.json | 9 + dev-workflow/.claude-plugin/plugin.json | 9 + .../.claude-plugin/marketplace.json | 44 ---- .../.claude-plugin/plugin.json | 9 + .../.claude-plugin/marketplace.json | 33 --- .../.claude-plugin/plugin.json | 9 + skills/omo/.claude-plugin/plugin.json | 9 + 11 files changed, 148 insertions(+), 309 deletions(-) delete mode 100644 bmad-agile-workflow/.claude-plugin/marketplace.json create mode 100644 bmad-agile-workflow/.claude-plugin/plugin.json create mode 100644 dev-workflow/.claude-plugin/plugin.json delete mode 100644 development-essentials/.claude-plugin/marketplace.json create mode 100644 development-essentials/.claude-plugin/plugin.json delete mode 100644 requirements-driven-workflow/.claude-plugin/marketplace.json create mode 100644 requirements-driven-workflow/.claude-plugin/plugin.json create mode 100644 skills/omo/.claude-plugin/plugin.json diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 59205b9..5a6691a 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1,209 +1,47 @@ { - "name": "claude-code-dev-workflows", + "$schema": "https://anthropic.com/claude-code/marketplace.schema.json", + "name": "myclaude", + "version": "5.6.1", + "description": "Professional multi-agent development workflows with OmO orchestration, Requirements-Driven and BMAD methodologies", "owner": { - "name": "Claude Code Dev Workflows", - "email": "contact@example.com", - "url": "https://github.com/cexll/myclaude" - }, - "metadata": { - "description": "Professional multi-agent development workflows with Requirements-Driven and BMAD methodologies, featuring 16+ specialized agents and 12+ commands", - "version": "1.0.0" + "name": "cexll", + "email": "evanxian9@gmail.com" }, "plugins": [ { - "name": "requirements-driven-development", - "source": "./requirements-driven-workflow/", - "description": "Streamlined requirements-driven development workflow with 90% quality gates for practical feature implementation", - "version": "1.0.0", - "author": { - "name": "Claude Code Dev Workflows", - "url": "https://github.com/cexll/myclaude" - }, - "homepage": "https://github.com/cexll/myclaude", - "repository": "https://github.com/cexll/myclaude", - "license": "MIT", - "keywords": [ - "requirements", - "workflow", - "automation", - "quality-gates", - "feature-development", - "agile", - "specifications" - ], - "category": "workflows", - "strict": false, - "commands": [ - "./commands/requirements-pilot.md" - ], - "agents": [ - "./agents/requirements-generate.md", - "./agents/requirements-code.md", - "./agents/requirements-testing.md", - "./agents/requirements-review.md" - ] + "name": "omo", + "description": "Multi-agent orchestration for code analysis, bug investigation, fix planning, and implementation with intelligent routing to specialized agents", + "version": "5.6.1", + "source": "./skills/omo", + "category": "development" }, { - "name": "bmad-agile-workflow", - "source": "./bmad-agile-workflow/", + "name": "dev", + "description": "Lightweight development workflow with requirements clarification, parallel codex execution, and mandatory 90% test coverage", + "version": "5.6.1", + "source": "./dev-workflow", + "category": "development" + }, + { + "name": "requirements", + "description": "Requirements-driven development workflow with quality gates for practical feature implementation", + "version": "5.6.1", + "source": "./requirements-driven-workflow", + "category": "development" + }, + { + "name": "bmad", "description": "Full BMAD agile workflow with role-based agents (PO, Architect, SM, Dev, QA) and interactive approval gates", - "version": "1.0.0", - "author": { - "name": "Claude Code Dev Workflows", - "url": "https://github.com/cexll/myclaude" - }, - "homepage": "https://github.com/cexll/myclaude", - "repository": "https://github.com/cexll/myclaude", - "license": "MIT", - "keywords": [ - "bmad", - "agile", - "scrum", - "product-owner", - "architect", - "developer", - "qa", - "workflow-orchestration" - ], - "category": "workflows", - "strict": false, - "commands": [ - "./commands/bmad-pilot.md" - ], - "agents": [ - "./agents/bmad-po.md", - "./agents/bmad-architect.md", - "./agents/bmad-sm.md", - "./agents/bmad-dev.md", - "./agents/bmad-qa.md", - "./agents/bmad-orchestrator.md", - "./agents/bmad-review.md" - ] + "version": "5.6.1", + "source": "./bmad-agile-workflow", + "category": "development" }, { - "name": "development-essentials", - "source": "./development-essentials/", + "name": "dev-kit", "description": "Essential development commands for coding, debugging, testing, optimization, and documentation", - "version": "1.0.0", - "author": { - "name": "Claude Code Dev Workflows", - "url": "https://github.com/cexll/myclaude" - }, - "homepage": "https://github.com/cexll/myclaude", - "repository": "https://github.com/cexll/myclaude", - "license": "MIT", - "keywords": [ - "code", - "debug", - "test", - "optimize", - "review", - "bugfix", - "refactor", - "documentation" - ], - "category": "essentials", - "strict": false, - "commands": [ - "./commands/code.md", - "./commands/debug.md", - "./commands/test.md", - "./commands/optimize.md", - "./commands/review.md", - "./commands/bugfix.md", - "./commands/refactor.md", - "./commands/docs.md", - "./commands/ask.md", - "./commands/think.md" - ], - "agents": [ - "./agents/code.md", - "./agents/bugfix.md", - "./agents/bugfix-verify.md", - "./agents/optimize.md", - "./agents/debug.md" - ] - }, - { - "name": "codex-cli", - "source": "./skills/codex/", - "description": "Execute Codex CLI for code analysis, refactoring, and automated code changes with file references (@syntax) and structured output", - "version": "1.0.0", - "author": { - "name": "Claude Code Dev Workflows", - "url": "https://github.com/cexll/myclaude" - }, - "homepage": "https://github.com/cexll/myclaude", - "repository": "https://github.com/cexll/myclaude", - "license": "MIT", - "keywords": [ - "codex", - "code-analysis", - "refactoring", - "automation", - "gpt-5", - "ai-coding" - ], - "category": "essentials", - "strict": false, - "skills": [ - "./SKILL.md" - ] - }, - { - "name": "gemini-cli", - "source": "./skills/gemini/", - "description": "Execute Gemini CLI for AI-powered code analysis and generation with Google's latest Gemini models", - "version": "1.0.0", - "author": { - "name": "Claude Code Dev Workflows", - "url": "https://github.com/cexll/myclaude" - }, - "homepage": "https://github.com/cexll/myclaude", - "repository": "https://github.com/cexll/myclaude", - "license": "MIT", - "keywords": [ - "gemini", - "google-ai", - "code-analysis", - "code-generation", - "ai-reasoning" - ], - "category": "essentials", - "strict": false, - "skills": [ - "./SKILL.md" - ] - }, - { - "name": "dev-workflow", - "source": "./dev-workflow/", - "description": "Minimal lightweight development workflow with requirements clarification, parallel codex execution, and mandatory 90% test coverage", - "version": "1.0.0", - "author": { - "name": "Claude Code Dev Workflows", - "url": "https://github.com/cexll/myclaude" - }, - "homepage": "https://github.com/cexll/myclaude", - "repository": "https://github.com/cexll/myclaude", - "license": "MIT", - "keywords": [ - "dev", - "workflow", - "codex", - "testing", - "coverage", - "concurrent", - "lightweight" - ], - "category": "workflows", - "strict": false, - "commands": [ - "./commands/dev.md" - ], - "agents": [ - "./agents/dev-plan-generator.md" - ] + "version": "5.6.1", + "source": "./development-essentials", + "category": "productivity" } ] } diff --git a/README.md b/README.md index 08c8f24..8427357 100644 --- a/README.md +++ b/README.md @@ -35,6 +35,41 @@ python3 install.py --install-dir ~/.claude ## Workflows Overview +### 0. OmO Multi-Agent Orchestrator (Recommended for Complex Tasks) + +**Intelligent multi-agent orchestration that routes tasks to specialized agents based on risk signals.** + +```bash +/omo "analyze and fix this authentication bug" +``` + +**Agent Hierarchy:** +| Agent | Role | Backend | Model | +|-------|------|---------|-------| +| `oracle` | Technical advisor | Claude | claude-opus-4-5 | +| `librarian` | External research | Claude | claude-sonnet-4-5 | +| `explore` | Codebase search | OpenCode | grok-code | +| `develop` | Code implementation | Codex | gpt-5.2 | +| `frontend-ui-ux-engineer` | UI/UX specialist | Gemini | gemini-3-pro | +| `document-writer` | Documentation | Gemini | gemini-3-flash | + +**Routing Signals (Not Fixed Pipeline):** +- Code location unclear → `explore` +- External library/API → `librarian` +- Risky/multi-file change → `oracle` +- Implementation needed → `develop` / `frontend-ui-ux-engineer` + +**Common Recipes:** +- Explain code: `explore` +- Small fix with known location: `develop` directly +- Bug fix, location unknown: `explore → develop` +- Cross-cutting refactor: `explore → oracle → develop` +- External API integration: `explore + librarian → oracle → develop` + +**Best For:** Complex bug investigation, multi-file refactoring, architecture decisions + +--- + ### 1. Dev Workflow (Recommended) **The primary workflow for most development tasks.** diff --git a/README_CN.md b/README_CN.md index fb34dbc..255e903 100644 --- a/README_CN.md +++ b/README_CN.md @@ -30,6 +30,41 @@ python3 install.py --install-dir ~/.claude ## 工作流概览 +### 0. OmO 多智能体编排器（复杂任务推荐） + +**基于风险信号智能路由任务到专业智能体的多智能体编排系统。** + +```bash +/omo "分析并修复这个认证 bug" +``` + +**智能体层级：** +| 智能体 | 角色 | 后端 | 模型 | +|-------|------|------|------| +| `oracle` | 技术顾问 | Claude | claude-opus-4-5 | +| `librarian` | 外部研究 | Claude | claude-sonnet-4-5 | +| `explore` | 代码库搜索 | OpenCode | grok-code | +| `develop` | 代码实现 | Codex | gpt-5.2 | +| `frontend-ui-ux-engineer` | UI/UX 专家 | Gemini | gemini-3-pro | +| `document-writer` | 文档撰写 | Gemini | gemini-3-flash | + +**路由信号（非固定流水线）：** +- 代码位置不明确 → `explore` +- 外部库/API → `librarian` +- 高风险/多文件变更 → `oracle` +- 需要实现 → `develop` / `frontend-ui-ux-engineer` + +**常用配方：** +- 解释代码：`explore` +- 位置已知的小修复：直接 `develop` +- Bug 修复，位置未知：`explore → develop` +- 跨模块重构：`explore → oracle → develop` +- 外部 API 集成：`explore + librarian → oracle → develop` + +**适用场景：** 复杂 bug 调查、多文件重构、架构决策 + +--- + ### 1. Dev 工作流（推荐） **大多数开发任务的首选工作流。** diff --git a/bmad-agile-workflow/.claude-plugin/marketplace.json b/bmad-agile-workflow/.claude-plugin/marketplace.json deleted file mode 100644 index a01afc6..0000000 --- a/bmad-agile-workflow/.claude-plugin/marketplace.json +++ /dev/null @@ -1,37 +0,0 @@ -{ - "name": "bmad-agile-workflow", - "source": "./", - "description": "Full BMAD agile workflow with role-based agents (PO, Architect, SM, Dev, QA) and interactive approval gates", - "version": "1.0.0", - "author": { - "name": "Claude Code Dev Workflows", - "url": "https://github.com/cexll/myclaude" - }, - "homepage": "https://github.com/cexll/myclaude", - "repository": "https://github.com/cexll/myclaude", - "license": "MIT", - "keywords": [ - "bmad", - "agile", - "scrum", - "product-owner", - "architect", - "developer", - "qa", - "workflow-orchestration" - ], - "category": "workflows", - "strict": false, - "commands": [ - "./commands/bmad-pilot.md" - ], - "agents": [ - "./agents/bmad-po.md", - "./agents/bmad-architect.md", - "./agents/bmad-sm.md", - "./agents/bmad-dev.md", - "./agents/bmad-qa.md", - "./agents/bmad-orchestrator.md", - "./agents/bmad-review.md" - ] -} \ No newline at end of file diff --git a/bmad-agile-workflow/.claude-plugin/plugin.json b/bmad-agile-workflow/.claude-plugin/plugin.json new file mode 100644 index 0000000..3411377 --- /dev/null +++ b/bmad-agile-workflow/.claude-plugin/plugin.json @@ -0,0 +1,9 @@ +{ + "name": "bmad", + "description": "Full BMAD agile workflow with role-based agents (PO, Architect, SM, Dev, QA) and interactive approval gates", + "version": "5.6.1", + "author": { + "name": "cexll", + "email": "cexll@cexll.com" + } +} diff --git a/dev-workflow/.claude-plugin/plugin.json b/dev-workflow/.claude-plugin/plugin.json new file mode 100644 index 0000000..b2bde11 --- /dev/null +++ b/dev-workflow/.claude-plugin/plugin.json @@ -0,0 +1,9 @@ +{ + "name": "dev", + "description": "Lightweight development workflow with requirements clarification, parallel codex execution, and mandatory 90% test coverage", + "version": "5.6.1", + "author": { + "name": "cexll", + "email": "cexll@cexll.com" + } +} diff --git a/development-essentials/.claude-plugin/marketplace.json b/development-essentials/.claude-plugin/marketplace.json deleted file mode 100644 index 92d333a..0000000 --- a/development-essentials/.claude-plugin/marketplace.json +++ /dev/null @@ -1,44 +0,0 @@ -{ - "name": "development-essentials", - "source": "./", - "description": "Essential development commands for coding, debugging, testing, optimization, and documentation", - "version": "1.0.0", - "author": { - "name": "Claude Code Dev Workflows", - "url": "https://github.com/cexll/myclaude" - }, - "homepage": "https://github.com/cexll/myclaude", - "repository": "https://github.com/cexll/myclaude", - "license": "MIT", - "keywords": [ - "code", - "debug", - "test", - "optimize", - "review", - "bugfix", - "refactor", - "documentation" - ], - "category": "essentials", - "strict": false, - "commands": [ - "./commands/code.md", - "./commands/debug.md", - "./commands/test.md", - "./commands/optimize.md", - "./commands/review.md", - "./commands/bugfix.md", - "./commands/refactor.md", - "./commands/docs.md", - "./commands/ask.md", - "./commands/think.md" - ], - "agents": [ - "./agents/code.md", - "./agents/bugfix.md", - "./agents/bugfix-verify.md", - "./agents/optimize.md", - "./agents/debug.md" - ] -} \ No newline at end of file diff --git a/development-essentials/.claude-plugin/plugin.json b/development-essentials/.claude-plugin/plugin.json new file mode 100644 index 0000000..ea640a9 --- /dev/null +++ b/development-essentials/.claude-plugin/plugin.json @@ -0,0 +1,9 @@ +{ + "name": "essentials", + "description": "Essential development commands for coding, debugging, testing, optimization, and documentation", + "version": "5.6.1", + "author": { + "name": "cexll", + "email": "cexll@cexll.com" + } +} diff --git a/requirements-driven-workflow/.claude-plugin/marketplace.json b/requirements-driven-workflow/.claude-plugin/marketplace.json deleted file mode 100644 index e1800dc..0000000 --- a/requirements-driven-workflow/.claude-plugin/marketplace.json +++ /dev/null @@ -1,33 +0,0 @@ -{ - "name": "requirements-driven-development", - "source": "./", - "description": "Streamlined requirements-driven development workflow with 90% quality gates for practical feature implementation", - "version": "1.0.0", - "author": { - "name": "Claude Code Dev Workflows", - "url": "https://github.com/cexll/myclaude" - }, - "homepage": "https://github.com/cexll/myclaude", - "repository": "https://github.com/cexll/myclaude", - "license": "MIT", - "keywords": [ - "requirements", - "workflow", - "automation", - "quality-gates", - "feature-development", - "agile", - "specifications" - ], - "category": "workflows", - "strict": false, - "commands": [ - "./commands/requirements-pilot.md" - ], - "agents": [ - "./agents/requirements-generate.md", - "./agents/requirements-code.md", - "./agents/requirements-testing.md", - "./agents/requirements-review.md" - ] -} \ No newline at end of file diff --git a/requirements-driven-workflow/.claude-plugin/plugin.json b/requirements-driven-workflow/.claude-plugin/plugin.json new file mode 100644 index 0000000..025cd8a --- /dev/null +++ b/requirements-driven-workflow/.claude-plugin/plugin.json @@ -0,0 +1,9 @@ +{ + "name": "requirements", + "description": "Requirements-driven development workflow with quality gates for practical feature implementation", + "version": "5.6.1", + "author": { + "name": "cexll", + "email": "cexll@cexll.com" + } +} diff --git a/skills/omo/.claude-plugin/plugin.json b/skills/omo/.claude-plugin/plugin.json new file mode 100644 index 0000000..143ae11 --- /dev/null +++ b/skills/omo/.claude-plugin/plugin.json @@ -0,0 +1,9 @@ +{ + "name": "omo", + "description": "Multi-agent orchestration for code analysis, bug investigation, fix planning, and implementation with intelligent routing to specialized agents", + "version": "5.6.1", + "author": { + "name": "cexll", + "email": "cexll@cexll.com" + } +}