agent-smith

Agent Smith

实现递归自相似多智能体系统的 Skill。每个智能体（史密斯）拥有独立的工作空间，通过目录隔离协议达成无冲突的并行任务分解与执行。

Overview

Agent Smith 是一个递归自相似的多智能体协作框架。每个智能体（史密斯）遵循相同的协议，在自己的工作空间内独立运行，通过父子间的 inbox/outbox 通信完成复杂任务的分解与汇总。

When to Use

在以下场景触发本 Skill：

• 用户请求"创建多智能体系统"或"设置 Agent Smith"
• 任务需要分解为多个并行子任务
• 需要协调多个 Agent 同时工作
• 复杂任务需要递归分解处理
• 要求无冲突的并行执行环境

When NOT to Use

在以下场景请勿触发本 Skill：

• 单个 Agent 可在 15 分钟内独立完成的任务
• 子任务之间存在严格线性依赖（每一步必须等待上一步完成）
• 仅需单 Agent 即可完成，并行执行无收益
• 任务已充分细化，无需进一步分解

Hard Constraints (Quick Reference)

以下限制由史密斯协议强制执行。修改这些值需要同时更新 SKILL.md 和 smith.md。

限制	值
最大递归深度	3（Level 0 根节点 → 最大 Level 3）
每层最大子代理数	5
Level ≥ 3 行为	禁止分解，必须直接执行

核心概念

史密斯 (Smith) 是自相似的智能体单元，每个史密斯拥有唯一 ID 和层级，能够执行任务、分解任务、创建子史密斯并汇总结果。所有史密斯遵循相同的协议，形成递归结构。

所有史密斯均受上述 Hard Constraints 约束。

无冲突协议 通过严格的目录隔离实现并行安全：每个史密斯只能写入自己的 private/ 和 outbox/，只能读取自己 inbox/ 中父史密斯分配的任务。父史密斯拥有创建子目录和写入子史密斯 inbox 的专属权限。

目录结构

.agent-smith/
├── smiths/
│   ├── smith-root/             # 根史密斯
│   │   ├── smith.md            # 史密斯定义（只读）
│   │   ├── inbox/              # 任务队列（外部/父写入，自己读取）
│   │   ├── private/            # 私有工作区
│   │   ├── outbox/             # 结果输出
│   │   │   └── result.md
│   │   └── children/           # 子史密斯目录
│   │       └── smith-001/
│   │           ├── smith.md
│   │           ├── inbox/      # 父写入，子读取
│   │           ├── private/
│   │           ├── outbox/
│   │           └── children/
└── results/
    └── final.md                # 最终结果

初始化矩阵

当用户请求初始化 Agent Smith 时，执行以下步骤：

1. 创建目录结构

创建根史密斯环境：

• .agent-smith/smiths/smith-root/inbox/ —— 任务队列
• .agent-smith/smiths/smith-root/private/ —— 私有工作区
• .agent-smith/smiths/smith-root/outbox/ —— 结果输出
• .agent-smith/smiths/smith-root/children/ —— 子史密斯容器
• .agent-smith/results/ —— 最终结果

2. 读取 smith.md 模板

从 smith.md 读取史密斯定义模板。

3. 替换占位符

替换模板中的变量：

• {SMITH_ID} → smith-root
• {PARENT_ID} → none
• {LEVEL} → 0

4. 写入根史密斯定义