/help               显示帮助
/tools              列出可用工具
/skills             列出可用技能
/mode [react|plan|auto]   查看或切换运行模式
/exit               退出

┌──────────────────────────────────────────────────────────┐
│                        CLI (src/cli.ts)                    │
│   REPL · 内置命令 · 单次模式      渲染器 (src/ui/render.ts) │
└───────────────┬──────────────────────────────────────────┘
                │ AgentEvent 流（thinking/plan/tool/subagent/…）
┌───────────────▼──────────────────────────────────────────┐
│                   Agent 引擎 (src/agent)                   │
│   agent.ts    统一入口 · 自动模式选择 · 技能注入           │
│   react.ts    ReAct 反应式循环                             │
│   plan.ts     Plan-and-Execute（生成计划→逐步执行→汇总）   │
│   loop.ts     共享 think→tool→observe 循环 + 反思自纠       │
│   orchestrator.ts  子代理委派（隔离上下文/工具/预算）      │
└───────┬───────────────┬───────────────┬──────────────────┘
        │               │               │
┌───────▼─────┐ ┌───────▼──────┐ ┌──────▼───────┐ ┌──────────┐
│ Tools       │ │ Skills       │ │ Memory       │ │ LLM      │
│ (src/tools) │ │ (src/skills) │ │ (src/memory) │ │ (src/llm)│
│ 注册表+工具 │ │ 加载+匹配    │ │ 记忆+预算    │ │ OpenAI / │
│             │ │              │ │ +上下文裁剪  │ │ Mock     │
└─────────────┘ └──────────────┘ └──────────────┘ └──────────┘

.
├── src/
│   ├── cli.ts                  # CLI 入口：REPL、内置命令、启动装配
│   ├── config.ts               # 环境变量与配置
│   ├── llm/                    # LLM 接入层
│   │   ├── types.ts            #   统一接口（Message/ToolCall/Provider）
│   │   ├── openai.ts           #   OpenAI 兼容 provider（流式+function calling）
│   │   ├── mock.ts             #   离线 Mock provider
│   │   └── index.ts            #   provider 工厂
│   ├── tools/                  # 工具调用框架
│   │   ├── types.ts            #   Tool 抽象 + zod→JSON-Schema
│   │   ├── registry.ts         #   注册表（注册/校验/执行/子集）
│   │   ├── file-tools.ts       #   read_file / write_file
│   │   ├── list-dir-tool.ts    #   list_dir
│   │   ├── run-command-tool.ts #   run_command（超时保护）
│   │   ├── analyze-code-tool.ts#   analyze_code（检索+结构统计）
│   │   └── safe-path.ts        #   工作目录沙箱
│   ├── skills/                 # 技能系统
│   │   ├── loader.ts           #   扫描 + frontmatter 解析
│   │   └── registry.ts         #   注册 + 触发匹配
│   ├── memory/                 # 记忆与预算
│   │   ├── memory.ts           #   会话记忆 + 上下文裁剪/摘要
│   │   └── budget.ts           #   步数/token 预算计量器
│   ├── agent/                  # 推理引擎
│   │   ├── agent.ts            #   统一入口 + 自动模式选择
│   │   ├── react.ts            #   ReAct
│   │   ├── plan.ts             #   Plan-and-Execute
│   │   ├── loop.ts             #   核心循环 + 反思
│   │   ├── orchestrator.ts     #   子代理委派
│   │   ├── orchestration-tools.ts # spawn_subagent / update_plan
│   │   └── types.ts            #   AgentEvent 事件流
│   └── ui/render.ts            # 彩色流式渲染
├── skills/                     # 技能定义（Markdown）
│   ├── code-review.md
│   └── explain-code.md
├── demo-workspace/             # Agent 的沙箱工作目录（运行时创建）
├── .env.example
├── package.json
├── tsconfig.json
└── README.md

> 读取 README.md 并总结内容

◆ 模式 REACT (用户指定 ReAct 模式)
🧠 思考: 思考：下一步调用 read_file 来推进任务。
🔧 调用工具 read_file {"path":"README.md"}
  ✓ 结果 [read_file]
    文件 README.md（…字符）: …
✅ 最终结果:
  任务「读取 README.md 并总结内容」已完成。…

> 调研项目结构并审查代码质量，拆分为多个子任务并行处理
ℹ 匹配到技能：code-review
🧠 思考: 下一步调用 spawn_subagent 来推进任务。
│ ╭─ 🤖 子代理启动 调研当前项目的目录结构 [tools: list_dir, read_file, analyze_code]
│ 🔧 调用工具 list_dir {"path":"."}
│ ╰─ 🤖 子代理完成: …