Skip to content

CLAUDE.md

Latest commit

 

History

History
42 lines (34 loc) · 1.62 KB

CLAUDE.md

File metadata and controls

42 lines (34 loc) · 1.62 KB
Raw

pi-multi-agent — Project Instructions

项目性质

pi-multi-agent 是一个多 Agent 编排系统的 monorepo，包含两个包：

  • pi-multi-agent-core — 核心编排引擎（agent 生命周期、事件持久化、工作流模板）
  • pi-multi-agent-dashboard — Web Dashboard + TUI overlay（独立扩展，从 core/public-api 读取数据）

代码风格

  • 严格 TypeScript（strict: true）
  • ESM 模块（import/export, 无 require）
  • JSDoc 注释
  • 文件命名 kebab-case（如 persistent-task.ts）
  • 关注点分离（组装和调用分开）

架构原则

  1. 事件文件驱动 — 所有状态通过 events.jsonl 持久化
  2. 异步优先 — 编排器永不阻塞，agent 任务异步执行
  3. 最佳努力 — 持久化失败不抛异常
  4. 隔离工作空间 — Fork/Merge 用于实验性改动
  5. 多 Agent 协作 — 不是单 agent 决策，团队讨论达成共识
  6. 清晰边界 — Dashboard 只能通过 public-api.ts 访问 core

关键路径

  • 核心入口: packages/pi-multi-agent-core/extension/index.ts
  • 公共 API: packages/pi-multi-agent-core/extension/public-api.ts
  • Dashboard 入口: packages/pi-multi-agent-dashboard/extension/index.ts
  • Dashboard Server: packages/pi-multi-agent-dashboard/extension/dashboard-server.ts
  • Dashboard Web: packages/pi-multi-agent-dashboard/extension/dashboard-web/
  • 测试: packages/pi-multi-agent-core/test/

测试

cd packages/pi-multi-agent-core && npm test

构建

cd packages/pi-multi-agent-core && npx tsc --noEmit

编排偏好通过 agent_config 管理，详见 .multi-agent/config.json