AI-Supervisor：面向自主软件工程工作流的多Agent运行时内核

AI-Supervisor是面向自主软件工程工作流的多Agent运行时内核，从单一脚本演进为完整运行时引擎，支持任务调度、执行、监控及API接口。采用PostgreSQL实现状态持久化，Redis Streams作为消息队列，为AI驱动的软件开发提供任务操作系统基础设施。

项目来源：GitHub @linkaidadie-hash，更新时间2026-06-07，链接：https://github.com/linkaidadie-hash/AI-Supervisor

AI-Supervisor经历了清晰的版本迭代：

• v0.1：单进程多Agent框架，实现Plan→Worker→Safety→Test→Review→Commit→Status的7步闭环工作流，验证了可行性。
• v0.2（当前版本）：架构升级，拆分为Scheduler（调度）、Executor（执行）、Watchdog（监控）、APIs（接口）四个可扩展角色；状态持久化到PostgreSQL，用Redis Streams做消息队列；分5个阶段实现（持久化层→Redis+调度/执行→LLM池→FastAPI接口→Web Dashboard）。
• v0.3.x：安全与治理层，已发布Secret Vault（AES-GCM加密）、Requirement Guard（规则验证）；规划中包括Spec Guard、RBAC、K8S支持、插件/Agent市场等。

核心架构设计借鉴操作系统思想：

1. 运行时角色：
   • Scheduler：系统大脑，负责任务分解、分发与升级。
   • Executor：无状态执行器，拉取任务、调用LLM、编辑代码，可水平扩展。
   • Watchdog：监控超时、死锁、配额超限，发起升级请求。
   • APIs：提供HTTP、WebSocket、CLI接口，支持外部交互。
2. 共享状态层：
   • PostgreSQL：存储任务、运行记录、成本等持久化数据。
   • Redis Streams：任务队列与事件总线，实现异步通信。
3. 技术栈：Python3.11+、PostgreSQL16、Redis7、FastAPI、Alembic、Docker Compose。

项目结构清晰分层：agents/（Agent实现）、api/（FastAPI接口）、core/（核心逻辑）、infra/（基础设施）、tests/（测试）等。 部署方式：

• Docker Compose：docker-compose up -d启动服务。
• 本地开发：安装依赖后运行python app.py。 测试覆盖：189个测试用例，覆盖率较高。 多语言支持：提供英文与简体中文双语README（README_zh.md）。

AI-Supervisor适用于以下场景：

• 自动化Bug修复：接收Issue自动分析、修复、测试并提交PR。
• 代码重构：按架构规划自动执行大规模重构，保持测试通过。
• 文档生成：从代码提取信息自动生成/更新文档。
• 多Agent协作开发：分工负责规划、实现、测试、审查等环节。
• CI/CD增强：作为流程一部分，自动处理构建/测试失败。

安全特性：

• Secret Vault（v0.3.1）：采用AES-GCM静态加密保护敏感信息（如API密钥、数据库密码），密钥可配置为环境变量或用密钥管理服务。
• Requirement Guard（v0.3.2）：基于规则的需求验证系统，无需LLM，可检查需求完整性、拦截不完整需求，减少返工。

AI-Supervisor代表AI辅助软件开发向系统化、工程化方向发展的趋势，解决多Agent协作中的状态管理、任务调度、故障处理与可观测性问题。 未来展望：v0.3+版本将重点提升安全、治理与可扩展性，计划支持K8S、Agent市场、插件市场等，有望成为完整的AI任务操作系统，支撑更复杂的软件工程工作流与大规模Agent协作。