sdaduanbilei/cc-haha
1
0
Fork 0
mirror of https://github.com/NanmiCoder/cc-haha synced 2026-07-17 13:13:35 +08:00
Code Issues Packages Projects Releases Wiki Activity
cc-haha/docs/en/agent/index.md
程序员阿江(Relakkes) 007b8abab8 docs: add VitePress documentation site with i18n and GitHub Pages deployment 
- 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>
2026-04-04 22:21:45 +08:00

5.1 KiB
Raw Blame History

Claude Code Multi-Agent System Documentation

Complete guide and technical reference for multi-agent orchestration

Documentation Index

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 — 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
  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
  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