PACT (Prepare, Architect, Code, Test)

基于 Claude Code 的多智能体编排插件，通过 Prepare、Architect、Code、Test 四阶段工作流与 12 个专业 Agent 实现协同软件开发。

项目概述#

PACT (Prepare, Architect, Code, Test) 是专为 Claude Code CLI 设计的多智能体编排插件，由 Synaptic-Labs-AI 组织维护（作者 Professor Synapse），当前版本 v3.19.0。项目采用 Viable System Model (VSM) 控制论框架与 Gordon Pask 的 Conversation Theory，将单次 AI 编程会话升级为由 12 个专业 Agent 组成的协同开发团队。主要语言为 Python (99.1%) + Shell (0.9%)，采用 MIT License。

四阶段核心工作流#

每个任务依次流经 PREPARE → ARCHITECT → CODE → TEST 四个阶段：

PREPARE：研究、需求收集、文档阅读
ARCHITECT：系统设计、蓝图、契约定义
CODE：后端/前端/数据库实现
TEST：单元测试、集成测试、端到端测试

12 个专业 Agent#

Agent	职责
Preparer	研究、需求收集、文档阅读
Architect	系统设计、蓝图、契约定义
Backend Coder	服务端逻辑、API、中间件
Frontend Coder	用户界面、客户端逻辑
Database Engineer	Schema 设计、查询优化、迁移
DevOps Engineer	CI/CD、Docker、基础设施
n8n Specialist	工作流自动化
Test Engineer	编写和执行全面测试
Security Engineer	对抗性安全代码审查
QA Engineer	运行时验证、探索性测试
Secretary	研究助手、知识蒸馏、上下文保持

自适应复杂度路由#

根据任务的新颖性、范围、不确定性和风险自动评分：

简单任务 → /PACT:comPACT 轻量流程
复杂任务 → /PACT:orchestrate 完整仪式
仅规划不编码 → /PACT:plan-mode
多 Agent 协同审查 → /PACT:peer-review
阻塞分流 → /PACT:imPACT
会话归档 → /PACT:wrap-up

持久化记忆系统#

基于本地 SQLite 数据库 + 向量嵌入（all-MiniLM-L6-v2.gguf）+ 图关联记忆，实现：

决策、经验教训和上下文跨会话持久化
语义搜索：memory.search("rate limiting")
存储路径：~/.claude/pact-memory/

架构演进：v2 → v3#

从 v2.x 单会话内 Subagents 模式迁移至 v3.0 Agent Teams 模式：

执行模型：单实例派发 → 独立 Claude Code 实例组
通信方式：仅返回编排器 → 团队成员直接通信
任务跟踪：编排器中心化管理 → 共享任务列表自协调
生命周期：一次性临时 → 持久化顾问（Agent 完成阶段后不销毁，可作为顾问回答后续问题）

VSM 理论映射#

S1 (Operations)：专家 Agent 执行实际工作
S2 (Coordination)：协议防止 Agent 间冲突
S3 (Control)：编排器管理当前执行
S4 (Intelligence)：战略评估
S5 (Policy)：不可协商的规则（安全、质量、伦理）

自动化 Hooks#

session_init.py：会话启动时初始化 PACT 环境，生成团队
phase_completion.py：会话停止时提醒记录决策日志
validate_handoff.py：Agent 交接时验证输出质量
track_files.py：文件编辑/写入时追踪变更用于构建记忆图

扩展能力#

16 个技能模块：13 个领域知识模块按需加载 + 3 个运维技能（团队管理、工作树建立与清理）
Telegram Bridge（可选）：通过手机接收通知、回答阻塞问题、发送语音回复（OpenAI Whisper 转录）

前置条件与安装#

Claude Code CLI：npm install -g @anthropic-ai/claude-code
启用 Agent Teams 实验功能
Python 3.9+
macOS 或 Linux（Windows 支持即将推出）

/plugin marketplace add ProfSynapse/PACT-prompt
/plugin install PACT@pact-marketplace
cp ~/.claude/plugins/cache/pact-marketplace/PACT/*/CLAUDE.md ~/.claude/CLAUDE.md
pip install sqlite-vec  # 可选：向量嵌入支持

已知限制#

强依赖 Claude Code 实验性 Agent Teams 功能，存在会话恢复、任务协调和关闭行为限制
Windows 尚不支持
952 次提交但仅 1 个 release tag，活跃开发但发布节奏不明
Telegram Bridge 语音转录依赖 OpenAI Whisper，API key 配置未明确
n8n 集成需 n8n-mcp MCP server，具体配置未详细说明