Claude Code Orchestrator Kit

Claude代码编排器工具包

Claude Code的专业自动化和编排系统

完整的工具包 39个人工智能代理, 38技能, 25个斜线命令, 自动优化MCP, 珠子问题跟踪, Gastown多代理编排, 即用型提示，以及 质量闸门 用于使用Claude Code构建生产就绪项目。

 ](https://www.npmjs.com/package/claude-code-orchestrator-kit)   

英语 | 俄语

______________________________________________________________________

目录

• 概述
• 关键创新
• 快速开始
• 安装
• 建筑
• 代理商生态系统
• 技能库
• 斜杠命令
• MCP配置
• Claude代码设置
• 提示
• 项目结构
• 使用示例
• 最佳实践
• Gastown设置
• 贡献
• 许可证

______________________________________________________________________

概述

Claude代码编排器工具包 将Claude Code从简单的助手转变为智能编排系统。Claude Code不是直接做所有事情，而是充当一个协调器，将复杂的任务委托给专门的子代理，保留上下文并启用无限期的工作会话。

所得

主要优势

• 上下文保护：主会话保持精简（约10-15K代币，而标准使用量为50K+）
• 专业化：每个代理都是其领域的专家
• 无限期工作：可以在不耗尽上下文的情况下无限期地处理项目
• 质量保证：每次授权后强制验证
• 资深专家：技能如 code-reviewer, senior-devops, senior-prompt-engineer

______________________________________________________________________

关键创新

1.编排器模式

核心范式：Claude Code充当编排器，委托给专门的子代理。

┌─────────────────────────────────────────────────────────────────┐
│                     MAIN CLAUDE CODE                             │
│                   (Orchestrator Role)                            │
├─────────────────────────────────────────────────────────────────┤
│  1. GATHER CONTEXT    │  2. DELEGATE        │  3. VERIFY        │
│  - Read existing code │  - Invoke agent     │  - Read results   │
│  - Search patterns    │  - Provide context  │  - Run type-check │
│  - Check recent commits│  - Set criteria    │  - Accept/reject  │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│                    SPECIALIZED AGENTS                            │
├──────────────┬──────────────┬──────────────┬───────────────────┤
│  bug-hunter  │  security-   │  database-   │  performance-     │
│  bug-fixer   │  scanner     │  architect   │  optimizer        │
│  dead-code-  │  vuln-fixer  │  api-builder │  accessibility-   │
│  hunter      │              │  supabase-   │  tester           │
│              │              │  auditor     │                   │
└──────────────┴──────────────┴──────────────┴───────────────────┘

2.内联技能（新架构）

从编排者的演变：我们用轻量级的内联技能取代了重型编排器代理。

示例: /health-bugs 现在使用 bug-health-inline 技能：

Detection → Validate → Fix by Priority → Verify → Repeat if needed

3.高级技能

复杂任务的专业级技能：

4.自动优化MCP配置

无需手动切换！ Claude Code自动优化上下文使用：

• 单 .mcp.json 对于所有服务器，无需手动切换
• 自动延迟加载 通过 ENABLE_TOOL_SEARCH=auto:5
• 上下文减少85% 用于MCP工具（通过工具搜索按需加载）
• 对用户透明 --无需配置即可工作

5.SpecKit集成

第0阶段规划的规范驱动开发工作流程：

• 执行人分配（MAIN与专业代理）
• 通过元代理创建并行代理
• 原子性：1个任务=1个代理调用

6.珠子问题跟踪（可选）

珠子 Steve Yegge——由git支持的AI代理问题跟踪器：

• 持续性任务：会话重启后仍能存活，用git跟踪
• 依赖图: blocks, blocked-by, discovered-from
• 多会话：在不丢失上下文的情况下跨多个Claude会话工作
• 8个工作流程公式: bigfeature, bugfix, hotfix, healthcheck等等。
• 初始化：运行 /beads-init 在您的项目中

7.Gastown多代理编排（可选）

煤气镇 Steve Yegge——将任务分派给AI工作进程（polecats）的多代理工作空间管理器：

You (human)
  │
  ├─ /work "Fix login bug"          ← Give task via Claude Code
  │    │
  │    ├─ bd create (bead)           ← Creates task in Beads
  │    └─ gt sling PREFIX-xxx RIG   ← Dispatches to Gastown
  │         │
  │         └─ Daemon (automatic)
  │              ├─ Spawns Polecat (AI worker in isolated git worktree)
  │              ├─ Polecat: branch → implement → test → commit
  │              ├─ Refinery: merge queue → develop
  │              └─ Witness: health monitoring
  │
  ├─ /status                         ← Check progress
  └─ git push                        ← Ship changes

主要特点：

• 并行人工智能工作者：多个撑杆在孤立的git工作树上同时工作
• 多运行时: claude （默认）， codex, gemini -所有基于订阅的，无API计费
• A/B测试: /work --ab "task" 将同一任务发送到2个运行时，比较结果
• 自我修复：Daemon管理Dolt数据库，重启崩溃的代理程序，监控运行状况
• 自动配置: /onboard 使用单个命令连接任何项目

包含的命令：

代理指令模板 因为所有运行时都在 .claude/templates/:

• CLAUDE.md --使用Gastown工作流编写Claude代码说明
• AGENTS.md --Codex兼容说明
• GEMINI.md --Gemini兼容指令

初始化：运行 /onboard 在您的项目目录中。看 Gastown设置指南 在......下面

______________________________________________________________________

快速开始

选项1:npm安装

npm install -g claude-code-orchestrator-kit
cd your-project
claude-orchestrator  # Interactive setup

选项2：克隆存储库

git clone https://github.com/maslennikov-ig/claude-code-orchestrator-kit.git
cd claude-code-orchestrator-kit

# Configure environment (optional, for Supabase)
cp .env.example .env.local
# Edit .env.local with your credentials

# Restart Claude Code - ready!

选项3：复制到现有项目

# Copy orchestration system to your project
cp -r claude-code-orchestrator-kit/.claude /path/to/your/project/
cp claude-code-orchestrator-kit/.mcp.json /path/to/your/project/
cp claude-code-orchestrator-kit/CLAUDE.md /path/to/your/project/

______________________________________________________________________

安装

先决条件

• 克劳德代码 已安装CLI
• Node.js 18+（适用于MCP服务器）
• Git （用于版本控制功能）

环境变量

创建 .env.local （git忽略）使用您的凭据：

# Supabase (optional)
SUPABASE_PROJECT_REF=your-project-ref
SUPABASE_ACCESS_TOKEN=your-token

# Sequential Thinking (optional)
SEQUENTIAL_THINKING_KEY=your-smithery-key
SEQUENTIAL_THINKING_PROFILE=your-profile

验证安装

# Check that .mcp.json and .claude/settings.json exist
ls -la .mcp.json .claude/settings.json

# Try a health command in Claude Code
/health-bugs

______________________________________________________________________

建筑

组件概述

┌────────────────────────────────────────────────────────────────┐
│                        CLAUDE.md                                │
│                  (Behavioral Operating System)                  │
│                                                                 │
│  Defines: Orchestration rules, delegation patterns, verification│
└────────────────────────────────────────────────────────────────┘
                              ↓
┌────────────────────────────────────────────────────────────────┐
│                         AGENTS                                  │
│            (39 specialized workers)                             │
├────────────────────────────────────────────────────────────────┤
│  health/       development/   testing/      database/          │
│  ├─bug-hunter  ├─llm-service  ├─integration ├─database-arch   │
│  ├─bug-fixer   ├─typescript   ├─performance ├─api-builder     │
│  ├─security-   ├─code-review  ├─mobile      ├─supabase-audit  │
│  ├─dead-code   ├─utility-     ├─access-     │                  │
│  └─reuse-      └─skill-build  └─ibility     │                  │
│                                                                 │
│  infrastructure/  frontend/     meta/        research/         │
│  ├─deployment     ├─nextjs-ui   ├─meta-agent ├─problem-invest  │
│  ├─qdrant         ├─fullstack   └─skill-v2   └─research-spec   │
│  └─orchestration  └─visual-fx                                  │
└────────────────────────────────────────────────────────────────┘
                              ↓
┌────────────────────────────────────────────────────────────────┐
│                         SKILLS                                  │
│            (37 reusable utilities)                              │
├────────────────────────────────────────────────────────────────┤
│  Inline Orchestration:        Senior Expertise:                 │
│  ├─bug-health-inline          ├─code-reviewer                  │
│  ├─security-health-inline     ├─senior-devops                  │
│  ├─deps-health-inline         ├─senior-prompt-engineer         │
│  ├─cleanup-health-inline      ├─ux-researcher-designer         │
│  └─reuse-health-inline        └─systematic-debugging           │
│                                                                 │
│  Utilities:                   Creative:                         │
│  ├─validate-plan-file         ├─algorithmic-art                │
│  ├─run-quality-gate           ├─canvas-design                  │
│  ├─rollback-changes           ├─theme-factory                  │
│  ├─parse-git-status           └─artifacts-builder              │
│  └─generate-report-header                                       │
└────────────────────────────────────────────────────────────────┘
                              ↓
┌────────────────────────────────────────────────────────────────┐
│                        COMMANDS                                 │
│            (21 slash commands)                                  │
├────────────────────────────────────────────────────────────────┤
│  /health-bugs      /speckit.specify    /worktree              │
│  /health-security  /speckit.plan       /push                  │
│  /health-deps      /speckit.implement  /translate-doc          │
│  /health-cleanup   /speckit.clarify    /process-logs          │
│  /health-reuse     /speckit.constitution                       │
│  /health-metrics   /speckit.taskstoissues                      │
└────────────────────────────────────────────────────────────────┘

______________________________________________________________________

代理商生态系统

39名专业代理

健康（10名代理人）

开发（6个代理）

测试（6种试剂）

数据库（3个代理）

基础设施（5个代理）

前端（3个代理）

其他（6名代理人）

______________________________________________________________________

技能库

38种可重复使用的技能

内联编排（5项技能）

直接执行健康工作流，无需生成编排器代理。所有技能包括 珠子集成 用于问题跟踪。

高级专业知识（6项技能）

专业级领域专业知识：

验证和质量（6项技能）

报告和格式（6项技能）

解析与提取（4项技能）

创意与用户界面（6项技能）

自动化工作流程（2项技能）

其他（4项技能）

______________________________________________________________________

斜杠命令

21命令

健康监测（6个命令）

例子：

/health-bugs
# Scans → Categorizes → Fixes by priority → Validates → Reports

SpecKit（9个命令）

珠子（2个命令）

Gastown（4个命令）

其他（4个命令）

______________________________________________________________________

MCP配置

统一的自动优化设置

不再需要手动切换！ 该套件使用单个 .mcp.json 自动优化。

运作原理

1. 单个配置文件 (.mcp.json)包含所有MCP服务器
2. 自动延迟加载 通过 .claude/settings.json:

   {
     "env": { "ENABLE_TOOL_SEARCH": "auto:5" }
   }

1. 按需加载 --Claude仅在需要时通过工具搜索加载工具
2. 节省85%的上下文 与预先加载所有工具相比

包含MCP服务器

环境变量

产生 .env.local 对于Supabase集成：

SUPABASE_PROJECT_REF=your-project-ref
SUPABASE_ACCESS_TOKEN=your-token

______________________________________________________________________

Claude代码设置

.claude/settings.json

用于增强工作流的项目级Claude代码配置：

{
  "plansDirectory": "./docs/plans",
  "env": {
    "ENABLE_TOOL_SEARCH": "auto:5"
  }
}

设置说明

好处

• 计划模式集成：计划保存到 docs/plans/ 用于版本控制和审查
• 自动上下文优化：MCP工具按需加载，而不是预先加载
• 无手动配置：工作透明--只需安装和使用

______________________________________________________________________

提示

在项目中设置各种功能的即用型提示。复制、粘贴并让Claude Code完成这项工作。

快速入门：健康工作流程

# 1. Install Beads CLI
npm install -g @anthropic/beads-cli

# 2. Initialize in your project
bd init

# 3. Run in Claude Code
/health-bugs

如何使用：

1. 将提示内容复制到您与Claude Code的聊天中
2. 回答Claude就您的项目细节提出的任何问题
3. 提交前检查生成的代码

看 prompts/README.md 获取完整文档。

______________________________________________________________________

项目结构

claude-code-orchestrator-kit/
├── .claude/
│   ├── agents/                 # 39 AI agents
│   │   ├── health/             # Bug, security, deps, cleanup
│   │   ├── development/        # LLM, TypeScript, utilities
│   │   ├── testing/            # Integration, performance, mobile
│   │   ├── database/           # Supabase, API, architecture
│   │   ├── infrastructure/     # Qdrant, deployment, orchestration
│   │   ├── frontend/           # Next.js, visual effects
│   │   ├── meta/               # Agent/skill creators
│   │   ├── research/           # Problem investigation
│   │   ├── documentation/      # Technical writing
│   │   ├── content/            # Article writing
│   │   └── business/           # Lead research
│   │
│   ├── skills/                 # 37 reusable skills
│   │   ├── bug-health-inline/  # Inline orchestration
│   │   ├── code-reviewer/      # Senior expertise
│   │   ├── validate-plan-file/ # Validation utilities
│   │   └── ...
│   │
│   ├── commands/               # 25 slash commands
│   │   ├── health-*.md         # Health monitoring
│   │   ├── speckit.*.md        # SpecKit workflow
│   │   ├── work.md             # Gastown: dispatch tasks
│   │   ├── status.md           # Gastown: show status
│   │   ├── upgrade.md          # Gastown: safe upgrade
│   │   ├── onboard.md          # Gastown: connect project
│   │   └── ...
│   │
│   ├── templates/              # Instruction file templates
│   │   ├── CLAUDE.md           # Claude Code template
│   │   ├── AGENTS.md           # Codex template
│   │   └── GEMINI.md           # Gemini template
│   │
│   ├── schemas/                # JSON schemas
│   └── scripts/                # Quality gate scripts
│
├── mcp/                        # Legacy MCP configs (reference only)
│   └── ...
│
├── prompts/                    # Ready-to-use setup prompts
│   ├── README.md
│   └── setup-error-logging.md
│
├── docs/                       # Documentation
│   ├── FAQ.md
│   ├── ARCHITECTURE.md
│   ├── TUTORIAL-CUSTOM-AGENTS.md
│   └── ...
│
├── .mcp.json                   # Unified MCP configuration
├── CLAUDE.md                   # Behavioral Operating System
└── package.json                # npm package config

______________________________________________________________________

使用示例

示例1：Bug修复工作流程

# Run complete bug detection and fixing
/health-bugs

# What happens:
# 1. Pre-flight validation
# 2. Bug detection (bug-hunter agent)
# 3. Quality gate validation
# 4. Priority-based fixing (critical → low)
# 5. Quality gates after each priority
# 6. Verification scan
# 7. Final report

示例2：代码审查

# Invoke code-reviewer skill
/code-reviewer

# Provides:
# - Automated code analysis
# - Best practices checking
# - Security scanning
# - Review checklist

示例3：发布自动化

# Auto-detect version bump
/push

# Or specify type
/push minor

# Actions:
# 1. Analyze commits since last release
# 2. Bump version in package.json
# 3. Generate changelog entry
# 4. Create git commit + tag
# 5. Push to remote

示例4：并行特征开发

# Create worktrees
/worktree create feature/new-auth
/worktree create feature/new-ui

# Work in parallel
cd .worktrees/feature-new-auth
# ... changes ...

# Cleanup when done
/worktree cleanup

______________________________________________________________________

最佳实践

1.使用自动优化MCP

该套件自动优化上下文使用，无需配置：

• MCP工具通过工具搜索按需加载
• 与预先加载所有工具相比，上下文减少了约85%

2.每周运行健康检查

/health-bugs      # Monday
/health-security  # Tuesday
/health-deps      # Wednesday
/health-cleanup   # Thursday
/health-metrics   # Monthly

3.使用图书馆优先的方法

在编写超过20行的代码之前，请搜索现有的库：

• 检查npm/PyPI是否有每周下载量超过1k的包
• 评估维护状态和类型支持
• 如果库覆盖了70%以上的功能，请使用库

4.遵循编排规则

1. 先收集上下文 -读取代码，搜索模式
2. 委派给下级代理 -提供完整的上下文
3. 验证结果 -从不跳过验证
4. 接受/拒绝循环 -必要时重新委派

5.确保凭据安全

# Never commit .env.local
echo ".env.local" >> .gitignore

______________________________________________________________________

Gastown设置

先决条件

1. 转到1.21+ 已安装(go version)
2. 煤气镇 和 珠子 已安装CLI：

   go install github.com/steveyegge/gastown/cmd/gt@latest
   go install github.com/steveyegge/beads/cmd/bd@latest

1. 加斯敦镇 已初始化：

   gt init ~/gt

1. 守护进程 以systemd用户服务运行：

   gt daemon enable-supervisor
   systemctl --user start gastown-daemon
   loginctl enable-linger $USER  # Auto-start on boot

重要提示：Daemon服务定制

默认 gt daemon enable-supervisor 模板不包括PATH。您必须手动添加环境行：

# Edit the service file
nano ~/.local/share/systemd/user/gastown-daemon.service

添加到下面 [Service]:

Environment="GT_TOWN_ROOT=/home/YOUR_USER/gt"
Environment="GT_ROOT=/home/YOUR_USER/gt"
Environment="PATH=/home/YOUR_USER/go/bin:/home/YOUR_USER/.local/bin:/usr/local/bin:/usr/bin:/bin"
Environment="HOME=/home/YOUR_USER"

然后重新加载并重新启动：

systemctl --user daemon-reload
systemctl --user restart gastown-daemon

守护程序配置

在中配置Dolt管理 ~/gt/mayor/daemon.json:

{
  "heartbeat": { "enabled": true, "interval": "3m" },
  "patrols": {
    "dolt_server": {
      "enabled": true,
      "port": 3307,
      "host": "127.0.0.1",
      "user": "root",
      "data_dir": "/home/YOUR_USER/gt/.dolt-data",
      "log_file": "/home/YOUR_USER/gt/daemon/dolt-server.log",
      "auto_restart": true
    },
    "deacon": { "enabled": true, "interval": "5m", "agent": "deacon" },
    "refinery": { "agent": "refinery", "enabled": true, "interval": "5m", "rigs": [] },
    "witness": { "agent": "witness", "enabled": true, "interval": "5m", "rigs": [] }
  },
  "type": "daemon-patrol-config",
  "version": 1
}

重要: time.Duration 字段如 health_check_interval 在Go中必须是整数（纳秒），而不是像这样的字符串 "30s"。省略它们以使用默认值（30秒）。

连接项目

跑 /onboard 从Claude Code中的项目目录：

/onboard

这将：

1. 跑 `gt rig add

` --汽车供应30+个部件

1. 更新 daemon.json --将项目添加到目击者/炼油厂巡逻中
2. 重新启动守护进程--获取新配置
3. 跑 gt doctor --fix --诊断和自动修复问题
4. 复制斜线命令-- /work, /status, /upgrade, /onboard
5. 复制指令模板-- CLAUDE.md, AGENTS.md, GEMINI.md

日常工作流程

# Give task to AI agent
/work "Fix the login validation bug"

# Check progress
/status

# Use specific runtime
/work --agent codex "Refactor auth module"

# A/B test: same task to 2 agents
/work --ab "Optimize database queries"

# Find available tasks
bd ready

# Visual dashboard
gt dashboard --open

故障排除

升级

/upgrade        # Upgrade both gt and bd
/upgrade gt     # Upgrade Gastown only
/upgrade bd     # Upgrade Beads only

这 /upgrade 命令处理整个周期：停止守护进程、升级二进制文件、验证服务文件、检查 daemon.json，重新启动，运行医生。

______________________________________________________________________

文档

______________________________________________________________________

贡献

添加新代理

1. 在中创建文件 .claude/agents/{category}/workers/
2. 遵循代理模板结构
3. 添加到此README

添加新技能

1. 创建目录 .claude/skills/{skill-name}/
2. 添加 SKILL.md 遵循格式
3. 添加到此README

添加MCP服务器

1. 将服务器添加到 .mcp.json
2. 在MCP配置部分的自述文件中

______________________________________________________________________

归因

GitHub提供的SpecKit

命令 /speckit.* 改编自 .

• 许可证：MIT许可证
• 版权：股份有限公司GitHub。

Steve Yegge的珠子

珠子问题跟踪集成改编自 史蒂夫·耶格的珠子.

• 描述：用于AI代理的分布式、git支持的图形问题跟踪器
• 许可证：MIT许可证
• 版权作者 ： Steve Yegge
• 命令: /beads-init, /speckit.tobeads
• 模板: .beads-templates/ 包含8个工作流公式的目录

史蒂夫·耶格的《Gastown》

多代理编排集成 史蒂夫·耶格的《Gastown》.

• 描述：具有隔离git工作树的多代理工作区管理器
• 许可证：MIT许可证
• 版权作者 ： Steve Yegge
• 命令: /onboard, /work, /status, /upgrade
• 模板: .claude/templates/ 包含所有运行时指令文件的目录

______________________________________________________________________

致谢

内置：

• 克劳德代码 通过Anthropic
• 背景7 通过Upstash
• Supabase MCP
• Smithery顺序思维
• 剧作家
• shadcn/ui

______________________________________________________________________

统计

• 39 AI代理
• 39 可重复使用的技能
• 25 斜杠命令
• 6 MCP服务器（自动优化）
• 3 运行时模板（Claude、Codex、Gemini）
• v1.4.20 当前版本

______________________________________________________________________

作者

Igor Maslennikov

• github： @马斯列尼科夫
• 网站： aidevteam.ru

______________________________________________________________________

许可证

MIT许可证-请参阅 许可证 文件。

______________________________________________________________________

如果你觉得这个仓库有用，就把它标上！