中文 English

Claude Code 多智能体工作流系统

基于 AI 的开发自动化，支持多后端执行（Codex/Claude/Gemini/OpenCode）

快速开始

npx github:stellarlinkco/myclaude

模块概览

模块	描述	文档
do	推荐 - 5 阶段功能开发，配合 codeagent 协调	/do 命令
omo	多智能体协调，具备智能路由功能	/omo 命令
bmad	BMAD 敏捷工作流，包含 6 个专业智能体	/bmad-pilot 命令
requirements	轻量级需求到代码的流水线	/requirements-pilot 命令
essentials	11 个核心开发命令：ask、bugfix、code、debug、docs、enhance-prompt、optimize、refactor、review、test、think	/code、/debug 等
sparv	SPARV 工作流（Specify→Plan→Act→Review→Vault）	/sparv 命令
course	课程开发（结合开发 + 产品需求 + 测试用例）	复合模块
claudekit	ClaudeKit：do 技能 + 全局钩子（pre-bash、inject-spec、log-prompt）	复合模块

可用技能

可通过 npx github:stellarlinkco/myclaude --list 单独安装各个技能（如 do、omo、sparv 等模块中已捆绑的技能已在上文列出）：

技能	描述
browser	浏览器自动化，用于 Web 测试和数据提取
codeagent	codeagent-wrapper 调用，用于多后端 AI 代码任务
codex	直接使用 Codex 后端执行
dev	轻量级端到端开发工作流
gemini	直接使用 Gemini 后端执行
product-requirements	交互式 PRD 生成，并附带质量评分
prototype-prompt-generator	结构化 UI/UX 原型提示词生成
skill-install	从 GitHub 安装技能，并进行安全扫描
test-cases	根据需求生成全面的测试用例

安装

# 推荐使用交互式安装程序
npx github:stellarlinkco/myclaude

# 列出可安装的项目（模块 / 技能 / 包装器）
npx github:stellarlinkco/myclaude --list

# 检测已安装的模块并从 GitHub 更新
npx github:stellarlinkco/myclaude --update

# 自定义安装目录 / 强制覆盖
npx github:stellarlinkco/myclaude --install-dir ~/.claude --force

--update 会检测目标安装目录中已安装的模块（默认为 ~/.claude，通过 installed_modules.json 文件判断），并从 GitHub 上的最新版本覆盖更新这些模块文件。

模块配置

编辑 config.json 文件以启用或禁用模块：

{
  "modules": {
    "bmad": { "enabled": false },
    "requirements": { "enabled": false },
    "essentials": { "enabled": false },
    "omo": { "enabled": false },
    "sparv": { "enabled": false },
    "do": { "enabled": true },
    "course": { "enabled": false }
  }
}

工作流选择指南

场景	推荐
功能开发（默认）	/do
Bug 调查 + 修复	/omo
大型企业项目	/bmad-pilot
快速原型开发	/requirements-pilot
简单任务	/code、/debug

核心架构

角色	智能体	职责
协调者	Claude Code	计划制定、上下文收集、验证
执行者	codeagent-wrapper	代码编辑、测试执行（Codex/Claude/Gemini/OpenCode）

后端 CLI 要求

后端	必需功能
Codex	codex e、--json、-C、resume
Claude	--output-format stream-json、-r
Gemini	-o stream-json、-y、-r
OpenCode	opencode、标准输入模式

安装后的目录结构

~/.claude/
├── bin/codeagent-wrapper
├── CLAUDE.md              (默认安装)
├── commands/              (来自 essentials 模块)
├── agents/                (来自 bmad/requirements 模块)
├── skills/                (来自 do/omo/sparv/course 模块)
├── hooks/                 (来自 claudekit 模块)
├── settings.json          (自动生成，钩子配置)
└── installed_modules.json (自动生成，记录已安装模块)

文档

• codeagent-wrapper
• 插件系统

故障排除

常见问题

找不到 Codex 包装器：

# 选择：codeagent-wrapper
npx github:stellarlinkco/myclaude

模块无法加载：

cat ~/.claude/installed_modules.json
npx github:stellarlinkco/myclaude --force

后端 CLI 错误：

which codex && codex --version
which claude && claude --version
which gemini && gemini --version

常见问题解答

问题	解决方案
“未知事件格式”	日志显示问题，可忽略
Gemini 无法读取 .gitignore 文件	从 .gitignore 中移除或使用其他后端
Codex 权限被拒绝	在 ~/.codex/config.yaml 中设置 approval_policy = "never"

更多内容请参阅 GitHub Issues。

许可证

AGPL-3.0 - 详见 LICENSE

商业授权

如需在不遵守 AGPL 条款的情况下进行商业使用，请联系：support@stellarlink.co

支持

• GitHub Issues

myclaude 快速上手指南

myclaude 是一个基于 Claude Code 的多智能体工作流自动化系统，支持 Codex、Claude、Gemini、OpenCode 等多种后端执行代码任务，适用于功能开发、Bug 修复、原型构建等场景。

环境准备

系统要求

• 操作系统：Linux / macOS / Windows (WSL)
• Node.js：建议 v18+（用于运行 npx 命令）
• Git：已安装并配置好

前置依赖

请确保至少安装并配置好以下任一 AI 后端 CLI 工具：

• Codex: 需支持 codex e, --json, -C, resume 参数
• Claude: 需支持 --output-format stream-json, -r 参数
• Gemini: 需支持 -o stream-json, -y, -r 参数
• OpenCode: 需支持 opencode 及 stdin 模式

提示：使用前请通过 which <command> 和 <command> --version 验证后端工具是否可用。

安装步骤

推荐使用交互式安装器，它将自动检测环境并引导你完成模块选择。

1. 运行安装命令

在终端执行以下命令启动安装向导：

npx github:stellarlinkco/myclaude

2. 可选操作

• 查看可用模块/技能列表：

  npx github:stellarlinkco/myclaude --list
  

• 更新已安装的模块（自动检测 ~/.claude 目录下的模块并从 GitHub 拉取最新版本）：

  npx github:stellarlinkco/myclaude --update
  

• 自定义安装目录或强制覆盖：

  npx github:stellarlinkco/myclaude --install-dir ~/.claude --force
  

3. 配置模块（可选）

安装完成后，可通过编辑 ~/.claude/config.json 启用或禁用特定工作流模块：

{
  "modules": {
    "do": { "enabled": true },
    "bmad": { "enabled": false },
    "essentials": { "enabled": true }
  }
}

基本使用

安装完成后，你可以在项目中直接使用预定义的命令触发不同的工作流。

场景一：功能开发（推荐）

使用 /do 命令启动包含 5 个阶段的功能开发流程，由 codeagent 协调执行：

/do 实现用户登录功能，包含前端表单和后端验证

场景二：简单编码或调试

使用 essentials 模块提供的轻量级命令处理单一任务：

/code 创建一个计算斐波那契数列的 Python 函数
/debug 修复当前文件中的空指针异常
/test 为当前模块生成单元测试用例

场景三：复杂项目协作

对于大型企业级项目，可使用 BMAD 敏捷工作流：

/bmad-pilot 重构支付模块以支持多币种

核心架构说明

• 规划者 (Orchestrator): Claude Code 负责上下文收集、任务规划和结果验证。
• 执行者 (Executor): codeagent-wrapper 负责调用配置的后端（Codex/Claude/Gemini 等）进行实际的代码编辑和测试执行。

注意：所有命令均在支持 Claude Code 的终端环境中运行。首次运行时，系统会自动加载 ~/.claude 目录下的配置和钩子。