mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-12 17:21:19 +08:00
b2fc2f60f1
- Added tests to ensure loading of ignore patterns and extension filters from settings. - Implemented functionality to respect ignore patterns and extension filters during file indexing. - Created integration tests for CodexLens ignore-pattern configuration routes. - Added a new AdvancedTab component with tests for managing ignore patterns and extension filters. - Established a comprehensive branding naming system for the Maestro project, including guidelines for package names, CLI commands, and directory structure.
416 lines
11 KiB
Markdown
416 lines
11 KiB
Markdown
# Maestro 品牌命名系统
|
||
|
||
> **文档版本**: 1.0.0
|
||
> **最后更新**: 2026-03-09
|
||
> **状态**: 已确定
|
||
|
||
## 概述
|
||
|
||
本文档定义了 Maestro 项目的完整品牌命名系统，包括总品牌、子品牌（工作流）、包名、CLI 命令、域名等命名规范。
|
||
|
||
### 品牌理念
|
||
|
||
**Maestro**（指挥家/编排大师）是一个智能编排平台，协调多个 AI CLI 工具，为开发者提供统一的工作流体验。
|
||
|
||
---
|
||
|
||
## 品牌架构
|
||
|
||
```
|
||
Maestro (总平台/编排系统)
|
||
├── Maestro Claude (基于 Claude Code 的工作流)
|
||
├── Maestro Codex (基于 Codex 的工作流)
|
||
├── Maestro Gemini (基于 Gemini 的工作流)
|
||
└── Maestro Qwen (基于 Qwen 的工作流)
|
||
```
|
||
|
||
### 设计原则
|
||
|
||
1. **清晰直观** - 工作流名称直接表明使用的 CLI 工具
|
||
2. **品牌统一** - 所有工作流都在 Maestro 品牌下
|
||
3. **易于扩展** - 未来添加新 CLI 时，命名规则保持一致
|
||
4. **技术透明** - 开发者清楚底层技术栈
|
||
|
||
---
|
||
|
||
## 完整命名规范
|
||
|
||
| 工作流 | 品牌名 | NPM 包 | CLI 命令 | GitHub Repo | 域名 |
|
||
|--------|--------|---------|----------|-------------|------|
|
||
| Claude Code 工作流 | **Maestro Claude** | `@maestro/claude` | `maestro claude` | `maestro-claude` | `claude.maestro.dev` |
|
||
| Codex 工作流 | **Maestro Codex** | `@maestro/codex` | `maestro codex` | `maestro-codex` | `codex.maestro.dev` |
|
||
| Gemini 工作流 | **Maestro Gemini** | `@maestro/gemini` | `maestro gemini` | `maestro-gemini` | `gemini.maestro.dev` |
|
||
| Qwen 工作流 | **Maestro Qwen** | `@maestro/qwen` | `maestro qwen` | `maestro-qwen` | `qwen.maestro.dev` |
|
||
|
||
### 命名规则
|
||
|
||
- **品牌名**: `Maestro <CLI名称>`
|
||
- **NPM 包**: `@maestro/<cli-name>`（小写，使用 scope）
|
||
- **CLI 命令**: `maestro <cli-name>`（小写）
|
||
- **GitHub 仓库**: `maestro-<cli-name>`（小写，连字符）
|
||
- **域名**: `<cli-name>.maestro.dev`（小写，子域名）
|
||
|
||
---
|
||
|
||
## 目录结构
|
||
|
||
### 推荐的项目结构
|
||
|
||
```
|
||
maestro/
|
||
├── packages/
|
||
│ ├── core/ # Maestro 核心引擎
|
||
│ │ ├── src/
|
||
│ │ └── package.json
|
||
│ ├── claude/ # Maestro Claude 工作流
|
||
│ │ ├── src/
|
||
│ │ └── package.json
|
||
│ ├── codex/ # Maestro Codex 工作流
|
||
│ │ ├── src/
|
||
│ │ └── package.json
|
||
│ ├── gemini/ # Maestro Gemini 工作流
|
||
│ │ ├── src/
|
||
│ │ └── package.json
|
||
│ ├── qwen/ # Maestro Qwen 工作流
|
||
│ │ ├── src/
|
||
│ │ └── package.json
|
||
│ └── podium/ # Maestro UI (原 CCW)
|
||
│ ├── frontend/
|
||
│ ├── backend/
|
||
│ └── package.json
|
||
├── docs/
|
||
│ ├── branding/ # 品牌文档
|
||
│ ├── guides/ # 使用指南
|
||
│ └── api/ # API 文档
|
||
├── .codex/ # Codex 配置和技能
|
||
├── .workflow/ # 工作流配置
|
||
├── package.json # Monorepo 根配置
|
||
└── README.md
|
||
```
|
||
|
||
---
|
||
|
||
## CLI 使用示例
|
||
|
||
### 基本调用
|
||
|
||
```bash
|
||
# 使用 Claude Code 工作流
|
||
maestro claude --prompt "implement user authentication"
|
||
|
||
# 使用 Codex 工作流
|
||
maestro codex --analyze "src/**/*.ts"
|
||
|
||
# 使用 Gemini 工作流
|
||
maestro gemini --task "summarize this document"
|
||
|
||
# 使用 Qwen 工作流
|
||
maestro qwen --prompt "explain this code"
|
||
```
|
||
|
||
### 带参数调用
|
||
|
||
```bash
|
||
# Claude 工作流 - 代码生成
|
||
maestro claude generate --file "components/Button.tsx" --prompt "add loading state"
|
||
|
||
# Codex 工作流 - 代码分析
|
||
maestro codex search --pattern "useEffect" --path "src/"
|
||
|
||
# Gemini 工作流 - 多模态任务
|
||
maestro gemini analyze --image "screenshot.png" --prompt "describe this UI"
|
||
|
||
# Qwen 工作流 - 快速任务
|
||
maestro qwen translate --from "en" --to "zh" --text "Hello World"
|
||
```
|
||
|
||
### 工作流选择
|
||
|
||
```bash
|
||
# 查看可用工作流
|
||
maestro list
|
||
|
||
# 查看特定工作流信息
|
||
maestro info claude
|
||
|
||
# 设置默认工作流
|
||
maestro config set default-workflow claude
|
||
```
|
||
|
||
---
|
||
|
||
## 配置文件
|
||
|
||
### maestro.config.json
|
||
|
||
```json
|
||
{
|
||
"version": "1.0.0",
|
||
"workflows": {
|
||
"claude": {
|
||
"name": "Maestro Claude",
|
||
"description": "Claude Code workflow for code generation and refactoring",
|
||
"cli": "claude-code",
|
||
"enabled": true,
|
||
"defaultModel": "claude-sonnet-4",
|
||
"capabilities": ["generate", "refactor", "explain", "chat"]
|
||
},
|
||
"codex": {
|
||
"name": "Maestro Codex",
|
||
"description": "Codex workflow for code analysis and understanding",
|
||
"cli": "codex",
|
||
"enabled": true,
|
||
"defaultModel": "gpt-5.2",
|
||
"capabilities": ["analyze", "search", "visualize", "index"]
|
||
},
|
||
"gemini": {
|
||
"name": "Maestro Gemini",
|
||
"description": "Gemini workflow for general-purpose AI tasks",
|
||
"cli": "gemini",
|
||
"enabled": true,
|
||
"defaultModel": "gemini-2.5-pro",
|
||
"capabilities": ["multimodal", "general", "experimental"]
|
||
},
|
||
"qwen": {
|
||
"name": "Maestro Qwen",
|
||
"description": "Qwen workflow for fast response and experimental tasks",
|
||
"cli": "qwen",
|
||
"enabled": true,
|
||
"defaultModel": "coder-model",
|
||
"capabilities": ["fast", "experimental", "assistant"]
|
||
}
|
||
},
|
||
"branding": {
|
||
"name": "Maestro",
|
||
"tagline": "Orchestrate Your Development Workflow",
|
||
"website": "https://maestro.dev",
|
||
"repository": "https://github.com/maestro-suite/maestro"
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 包名规范
|
||
|
||
### NPM 包
|
||
|
||
#### @maestro/claude
|
||
|
||
```json
|
||
{
|
||
"name": "@maestro/claude",
|
||
"version": "1.0.0",
|
||
"description": "Maestro Claude - Claude Code workflow orchestration",
|
||
"main": "dist/index.js",
|
||
"types": "dist/index.d.ts",
|
||
"bin": {
|
||
"maestro-claude": "./bin/cli.js"
|
||
},
|
||
"keywords": [
|
||
"maestro",
|
||
"claude",
|
||
"claude-code",
|
||
"workflow",
|
||
"ai",
|
||
"code-generation"
|
||
],
|
||
"repository": {
|
||
"type": "git",
|
||
"url": "https://github.com/maestro-suite/maestro-claude"
|
||
}
|
||
}
|
||
```
|
||
|
||
#### @maestro/codex
|
||
|
||
```json
|
||
{
|
||
"name": "@maestro/codex",
|
||
"version": "1.0.0",
|
||
"description": "Maestro Codex - Codex workflow orchestration",
|
||
"main": "dist/index.js",
|
||
"types": "dist/index.d.ts",
|
||
"bin": {
|
||
"maestro-codex": "./bin/cli.js"
|
||
},
|
||
"keywords": [
|
||
"maestro",
|
||
"codex",
|
||
"workflow",
|
||
"ai",
|
||
"code-analysis"
|
||
],
|
||
"repository": {
|
||
"type": "git",
|
||
"url": "https://github.com/maestro-suite/maestro-codex"
|
||
}
|
||
}
|
||
```
|
||
|
||
### Python 包（如果需要）
|
||
|
||
#### maestro-claude
|
||
|
||
```toml
|
||
[project]
|
||
name = "maestro-claude"
|
||
version = "1.0.0"
|
||
description = "Maestro Claude - Claude Code workflow orchestration"
|
||
readme = "README.md"
|
||
requires-python = ">=3.8"
|
||
keywords = ["maestro", "claude", "workflow", "ai"]
|
||
|
||
[project.urls]
|
||
Homepage = "https://claude.maestro.dev"
|
||
Repository = "https://github.com/maestro-suite/maestro-claude"
|
||
```
|
||
|
||
---
|
||
|
||
## 品牌视觉
|
||
|
||
### Logo 设计
|
||
|
||
每个工作流使用不同的颜色来区分，但保持统一的设计语言：
|
||
|
||
| 工作流 | 主色 | 辅助色 | 图标元素 |
|
||
|--------|------|--------|----------|
|
||
| **Maestro Claude** | 橙色 `#FF6B35` | 深橙 `#D94F1C` | Claude 的 C 字母 + 指挥棒 |
|
||
| **Maestro Codex** | 绿色 `#00D084` | 深绿 `#00A86B` | Codex 的代码符号 + 指挥棒 |
|
||
| **Maestro Gemini** | 蓝色 `#4285F4` | 深蓝 `#1967D2` | Gemini 的双子星 + 指挥棒 |
|
||
| **Maestro Qwen** | 紫色 `#9C27B0` | 深紫 `#7B1FA2` | Qwen 的 Q 字母 + 指挥棒 |
|
||
|
||
### 总品牌色彩
|
||
|
||
- **主色**: 深蓝/午夜蓝 `#192A56` - 专业、稳定
|
||
- **强调色**: 活力青/薄荷绿 `#48D1CC` - 智能、创新
|
||
- **中性色**: 浅灰 `#F5F5F5`, 深灰 `#333333`
|
||
|
||
### 设计元素
|
||
|
||
- **指挥棒**: 所有 Logo 的核心元素，象征编排和指挥
|
||
- **声波/轨迹**: 动态的线条，表示工作流的流动
|
||
- **几何化**: 现代、简洁的几何图形
|
||
|
||
---
|
||
|
||
## 方案优点
|
||
|
||
### 1. 清晰直观
|
||
- 用户一眼就知道使用的是哪个 CLI 工具
|
||
- 不需要学习额外的术语映射
|
||
|
||
### 2. 易于理解
|
||
- 命名规则简单一致
|
||
- 新用户快速上手
|
||
|
||
### 3. 灵活扩展
|
||
- 未来添加新 CLI 时，命名规则保持一致
|
||
- 例如：添加 `Maestro GPT`、`Maestro Llama` 等
|
||
|
||
### 4. 品牌统一
|
||
- 所有工作流都在 Maestro 品牌下
|
||
- 强化 Maestro 作为编排平台的定位
|
||
|
||
### 5. 技术透明
|
||
- 开发者清楚底层使用的技术栈
|
||
- 便于调试和问题排查
|
||
|
||
---
|
||
|
||
## 注意事项
|
||
|
||
### 1. 商标问题
|
||
|
||
使用 "Maestro Claude"、"Maestro Codex" 等名称时，需要注意：
|
||
|
||
- ⚠️ 确保不侵犯原 CLI 的商标权
|
||
- ✅ 在文档中明确说明这些是"基于 XXX 的工作流"，而不是官方产品
|
||
- ✅ 添加免责声明：
|
||
```
|
||
Maestro Claude 是基于 Claude Code 的工作流编排系统。
|
||
Claude 和 Claude Code 是 Anthropic 的商标。
|
||
本项目与 Anthropic 无关联。
|
||
```
|
||
|
||
### 2. 命名冲突
|
||
|
||
在发布前需要检查：
|
||
|
||
- [ ] npm 包名 `@maestro/claude`、`@maestro/codex` 等是否可用
|
||
- [ ] PyPI 包名 `maestro-claude`、`maestro-codex` 等是否可用
|
||
- [ ] GitHub 组织名 `maestro-suite` 是否可用
|
||
- [ ] 域名 `maestro.dev`、`claude.maestro.dev` 等是否可用
|
||
|
||
### 3. 用户认知
|
||
|
||
需要在文档中清楚说明：
|
||
|
||
- **Maestro** 是编排平台（总品牌）
|
||
- **Maestro Claude/Codex/Gemini/Qwen** 是工作流系统（子品牌）
|
||
- 底层使用的是对应的 CLI 工具（技术实现）
|
||
|
||
示例说明：
|
||
```
|
||
Maestro 是一个 AI 工作流编排平台。
|
||
Maestro Claude 是基于 Claude Code 的工作流系统，
|
||
它调用 Claude Code CLI 来执行代码生成和重构任务。
|
||
```
|
||
|
||
---
|
||
|
||
## 下一步行动
|
||
|
||
### 阶段 1: 资源可用性检查
|
||
|
||
- [ ] 检查域名可用性
|
||
- [ ] `maestro.dev`
|
||
- [ ] `claude.maestro.dev`
|
||
- [ ] `codex.maestro.dev`
|
||
- [ ] `gemini.maestro.dev`
|
||
- [ ] `qwen.maestro.dev`
|
||
|
||
- [ ] 检查 npm 包名可用性
|
||
- [ ] `@maestro/core`
|
||
- [ ] `@maestro/claude`
|
||
- [ ] `@maestro/codex`
|
||
- [ ] `@maestro/gemini`
|
||
- [ ] `@maestro/qwen`
|
||
|
||
- [ ] 检查 GitHub 可用性
|
||
- [ ] 组织名 `maestro-suite`
|
||
- [ ] 仓库名 `maestro`, `maestro-claude`, `maestro-codex` 等
|
||
|
||
### 阶段 2: 迁移计划
|
||
|
||
- [ ] 创建迁移文档（详见 `docs/migration/renaming-plan.md`）
|
||
- [ ] 重命名根目录：`Claude_dms3` → `maestro`
|
||
- [ ] 重组包结构：创建 `packages/` 目录
|
||
- [ ] 更新所有配置文件
|
||
- [ ] 更新代码中的引用
|
||
|
||
### 阶段 3: 实施和发布
|
||
|
||
- [ ] 执行迁移
|
||
- [ ] 更新文档和 README
|
||
- [ ] 创建 Logo 和品牌资产
|
||
- [ ] 发布到 npm/PyPI
|
||
- [ ] 配置域名和网站
|
||
|
||
---
|
||
|
||
## 参考资料
|
||
|
||
- [品牌架构设计](./brand-architecture.md)
|
||
- [迁移计划](../migration/renaming-plan.md)
|
||
- [视觉设计指南](./visual-identity.md)
|
||
|
||
---
|
||
|
||
## 变更历史
|
||
|
||
| 版本 | 日期 | 变更内容 | 作者 |
|
||
|------|------|----------|------|
|
||
| 1.0.0 | 2026-03-09 | 初始版本，确定品牌命名系统 | - |
|