核心概念

Agent 引擎、工具系统、MCP、Skill

Agent 引擎

send_message 主循环驱动多轮工具调用：

  1. 用户发送消息
  2. 模型决定是否调用工具
  3. 5 道工具执行门：sibling abort → parse → registry → hook → permission
  4. 9 步权限决策：对危险操作（写文件、跑 Shell）要求确认
  5. 工具结果返回模型，继续推理
  6. 直到任务完成

每一步思维链在对话区可见，危险操作可审批。

多角色编排（核心特性）

Gclm Agent 默认是 Compose 编排模式——不是一个 agent 干所有事，而是由编排角色根据任务自动派发到专门角色：

角色职责权限
Compose 编排（默认入口）分析问题、与用户对齐、判断派发、全局收尾不改代码、不跑命令
Plan 规划只读调研、设计方案，写入 .gclm/plans/禁止改业务代码/跑命令
Build 执行落地编码——改文件、跑命令、写测试完整工具权限
Review 复盘核对改动、汇总验证证据、审计质量风险只读，不改代码

Compose 自决：主线程 Compose 自己判断任务复杂度——

  • 简单任务（typo / 单点修复）→ Compose 直接做（默认能写代码）
  • 复杂任务（多文件 / 跨层）→ manage_spec 写 spec（5 必填字段）+ spawn_subagent(agent_id="build") 派 worker 到独立线程执行
  • worker 完成后 → 必要时 spawn_subagent(agent_id="review") 独立验收

worker（build/review/explore）跑在独立子线程，报告带回主线程。权限按角色隔离（review/explore 只读，build 才改代码）——让每一步在正确的时机交给正确的角色。

对齐 Claude Code / Codex / MiMo-Code：主 agent 自决复杂度，复杂任务派 sub-agent，无主线程角色互切。

工具系统

内置工具：

  • 文件：读写、编辑、浏览目录
  • Shell：执行命令（继承登录 shell 快照）
  • grep / glob：代码与文件搜索
  • Web：搜索与网页抓取
  • Todo：任务清单管理

工具失败会被 ToolFailureLedger 跟踪，支持重试与上下文管理。

MCP 集成

连接 MCP（Model Context Protocol）服务器扩展 Agent 能力：

  • filesystem —— 文件系统操作
  • github —— 仓库管理
  • postgres —— 数据库查询
  • playwright —— 浏览器自动化

在 设置 → MCP 管理连接，实时监控服务器状态与工具发现。

Skill 系统

Skill 是可复用的工作流模板：

  • 全局 Skill：~/.agents/skills
  • 项目 Skill：.gclm/skills

内置 Skill：commit（规范化提交）、review-pr（代码审查）、brainstorming（需求澄清）等。用斜杠命令 /skill-name 调用。