mirror of
https://github.com/NanmiCoder/cc-haha
synced 2026-07-17 13:13:35 +08:00
007b8abab8
- Set up VitePress with bilingual support (Chinese root + English /en/) - Create unified sidebar navigation with all doc sections - Add custom Anthropic brand theme (#D97757) - Create Quick Start pages (zh/en) from README content - Migrate 7 .en.md files to docs/en/ directory structure - Translate memory/agent/skills docs to English (9 files) - Generate English-only architecture diagrams (11 images via PicTactic) - Copy English-ready images for agent/skills sections (21 images) - Configure custom domain (claudecodehaha.relakkesyang.org) - Localize Chinese UI labels (sidebar, outline, footer) - Add documentation site badge to READMEs - Fix dead links and update cross-references for VitePress Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
108 lines
5.1 KiB
Markdown
108 lines
5.1 KiB
Markdown
# Claude Code Multi-Agent System Documentation
|
|
|
|
> Complete guide and technical reference for multi-agent orchestration
|
|
|
|
---
|
|
|
|
## Documentation Index
|
|
|
|
### [01-usage-guide.md](./01-usage-guide.md) — Usage Guide
|
|
|
|
A comprehensive user-facing manual covering:
|
|
|
|
- **Agent Tool**: Parameter reference, spawn methods, background execution
|
|
- **Six Built-in Agents**: general-purpose, Explore, Plan, verification, claude-code-guide, statusline-setup
|
|
- **Background Tasks**: Asynchronous execution, progress tracking, completion notifications
|
|
- **Agent Teams**: Team creation, member collaboration, message communication
|
|
- **Worktree Isolation**: Independent environments, branch management, secure contexts
|
|
- **Custom Agents**: Definition format, tool pool configuration, system prompts
|
|
|
|
**Target Audience**: All Claude Code users
|
|
|
|
---
|
|
|
|
### [02-implementation.md](./02-implementation.md) — Implementation Details
|
|
|
|
A deep technical reference for developers covering:
|
|
|
|
- **Architecture Overview**: 5 agent categories, 4 spawn paths
|
|
- **Agent Spawn Flow**: Detailed walkthrough of Sync / Async / Fork / Teammate paths
|
|
- **Tool Pool System**: Three-layer filtering, constant definitions, permission mapping
|
|
- **Context Passing**: CacheSafeParams, system prompt construction, fork cache optimization
|
|
- **Teams Internals**: TeamFile structure, mailbox system, inbox polling, message routing
|
|
- **Background Task Engine**: LocalAgentTask lifecycle, progress tracking, notification queue
|
|
- **Permission Synchronization**: Team-level permissions, mode propagation, bubble mode
|
|
- **End-to-End Data Flow**: From Agent Tool invocation to result delivery
|
|
|
|
**Target Audience**: Contributors, architects, and developers seeking deep implementation understanding
|
|
|
|
---
|
|
|
|
## Illustration Notes
|
|
|
|
All diagrams use a dark background (#1a1a2e) with Anthropic brand copper-orange (#D97757), consistent with Claude Code's official documentation style.
|
|
|
|
| Image | Description | Document |
|
|
|-------|-------------|----------|
|
|
| `01-agent-overview.png` | Multi-Agent System Overview — Architecture panorama | Usage Guide |
|
|
| `02-agent-types.png` | Six Built-in Agents — Type comparison matrix | Usage Guide |
|
|
| `03-spawn-flow.png` | Agent Spawn Flow — Four-path decision tree | Usage Guide |
|
|
| `04-agent-teams.png` | Agent Teams Collaboration — Team communication topology | Usage Guide |
|
|
| `05-architecture.png` | Implementation Architecture — Core module relationships | Implementation |
|
|
| `06-context-passing.png` | Context Passing — CacheSafeParams data flow | Implementation |
|
|
| `07-tool-pool.png` | Tool Pool System — Three-layer filtering pipeline | Implementation |
|
|
| `08-background-task.png` | Background Task Engine — Lifecycle state machine | Implementation |
|
|
| `09-teams-mailbox.png` | Teams Mailbox System — Message routing topology | Implementation |
|
|
| `10-fork-cache.png` | Fork Cache Optimization — Byte-level consistent sharing | Implementation |
|
|
|
|
---
|
|
|
|
## Quick Start
|
|
|
|
### For Users
|
|
|
|
1. Read the [Usage Guide](./01-usage-guide.md)
|
|
2. Learn about the six built-in agents and their use cases
|
|
3. Try spawning subagents using the Agent tool in a conversation
|
|
4. Explore multi-agent collaboration with Agent Teams
|
|
|
|
### For Developers
|
|
|
|
1. Read the [Implementation Details](./02-implementation.md)
|
|
2. Browse the source code:
|
|
- `src/tools/AgentTool/` — Agent tool implementation
|
|
- `src/tools/TeamCreateTool/` — Team creation
|
|
- `src/tools/SendMessageTool/` — Inter-agent communication
|
|
- `src/utils/swarm/` — Swarm collaboration infrastructure
|
|
- `src/utils/forkedAgent.ts` — Fork agent context
|
|
- `src/tasks/` — Task management system
|
|
3. Understand the four spawn paths and context passing mechanisms
|
|
|
|
---
|
|
|
|
## Core Concepts Quick Reference
|
|
|
|
| Concept | Description |
|
|
|---------|-------------|
|
|
| **Agent Tool** | Primary entry point — accepts a prompt + subagent_type to spawn a subagent |
|
|
| **Subagent** | An independent child agent that executes tasks with its own tool pool and permissions |
|
|
| **Fork Agent** | A forked agent that inherits the parent's full context and shares prompt cache |
|
|
| **Teammate** | A collaborative member within an Agent Team, communicating via mailbox |
|
|
| **Worktree** | Git worktree isolation mode providing an independent file environment |
|
|
| **LocalAgentTask** | Local agent task state, tracking running/completed/failed status |
|
|
| **DreamTask** | Automatic memory consolidation task that runs periodically in the background |
|
|
| **CacheSafeParams** | Cache-safe parameters ensuring byte-level consistency of API request prefixes |
|
|
| **TeamFile** | Team configuration file storing the member list and permissions |
|
|
| **Mailbox** | File-based message queue supporting asynchronous communication between teammates |
|
|
|
|
---
|
|
|
|
## Related Resources
|
|
|
|
- [Claude Code Haha Home](/)
|
|
- [Memory System Documentation](/en/memory/01-usage-guide)
|
|
- [Agent Tool Source Code](https://github.com/NanmiCoder/cc-haha/tree/main/src/tools/AgentTool/)
|
|
- [Swarm Infrastructure](https://github.com/NanmiCoder/cc-haha/tree/main/src/utils/swarm/)
|
|
- [Task Management System](https://github.com/NanmiCoder/cc-haha/tree/main/src/tasks/)
|
|
- [GitHub Issues](https://github.com/NanmiCoder/cc-haha/issues)
|