Synkra AIOS

项目概述#

Synkra AIOS (aios-core) 是一个 AI 编排操作系统，旨在作为全栈开发的核心框架。它不仅仅是一个工具集，而是一个完整的开发方法论实现，通过 CLI First 原则，将 LLM 转化为专业的开发团队，实现需求分析、架构设计、编码实现、质量保证及部署的端到端自动化。

解决的问题：

• 上下文丢失：通过 Engineering-Contextualized Development 确保开发 Story 包含完整架构指导和上下文
• 流程割裂：通过统一的工作流编排将 PM、Architect、Dev、QA 角色标准化为 Agents 协作
• 执行不确定性：通过 ADE 提供故障恢复、结构化审查和记忆层，提升自动化执行的鲁棒性

适用场景：

• Greenfield（绿地项目）：从零开始的新项目快速搭建
• Brownfield（棕地项目）：现有代码库的迭代、扩展与重构
• 非技术领域：通过 Squads 机制扩展至创意写作、商业策略、教育等领域

核心架构原则#

项目遵循明确的优先级层次：

• CLI (最高优先级)：智能核心，所有执行、决策和自动化发生地
• Observability (次要)：实时观察和监控 CLI 活动
• UI (第三级)：按需管理和可视化

两大核心创新#

1. Agentic Planning（智能规划）#

专门的分析师、PM、架构师代理协作创建详细的 PRD 和架构文档。

2. Engineering-Contextualized Development（工程上下文化开发）#

Scrum Master 代理将详细计划转换为超详细的开发 stories，包含完整上下文、实现细节和架构指导。

专业代理矩阵（11+ Agents）#

Meta Agents:

• aios-master - 主编排代理（包含框架开发能力）
• aios-orchestrator - 工作流编排和团队协调

Planning Agents (Web界面):

• analyst - 业务分析专家和 PRD 创建
• pm (Product Manager) - 产品经理和优先级管理
• architect - 系统架构师和技术设计
• ux-expert - 用户体验设计和可用性

Development Agents (IDE):

• sm (Scrum Master) - Sprint 管理和 story 创建
• dev - 开发者和实现
• qa - 质量保证和测试
• po (Product Owner) - Backlog 和 story 管理
• data-engineer - 数据库设计和数据建模
• devops - CI/CD、基础设施和 git 操作（唯一拥有 push 权限的代理）

Autonomous Development Engine (ADE)#

7 个 Epic 支持自主开发：

1. Worktree Manager - Git worktrees 的分支隔离
2. Migration V2→V3 - 迁移到 autoClaude V3 格式
3. Spec Pipeline - 将需求转换为可执行 specs
4. Execution Engine - 13 步执行 + 自我批评
5. Recovery System - 自动故障恢复
6. QA Evolution - 10 阶段结构化审查
7. Memory Layer - 模式和洞察的持久记忆

典型工作流程#

1. @pm creates a PRD          → *create-epic
2. @sm drafts stories          → *draft
3. @po validates stories       → *validate-story-draft
4. @dev implements             → (works from story file)
5. @qa reviews                 → *review STORY-ID
6. @devops pushes              → *push (only agent with push authority)
7. @po closes story            → *close-story STORY-ID

安装与快速开始#

系统要求#

• Node.js >= 18.0.0 (推荐 v20+)
• npm >= 9.0.0
• Git：可选但推荐
• GitHub CLI：可选，团队协作需要

安装方式#

# 创建新项目
npx aios-core init my-project

# 安装到现有项目
cd your-project
npx aios-core install

CLI 命令参考#

# 项目管理
npx aios-core init <project-name> [options]
  --force              # 在非空目录强制创建
  --skip-install       # 跳过 npm 依赖安装
  --template <name>    # 使用特定模板

# 系统命令
npx aios-core --version
npx aios-core --help
npx aios-core info
npx aios-core doctor --fix

代理激活和命令#

# 通用命令
*help                    # 显示可用命令
*guide                   # 显示详细使用指南
*session-info            # 显示当前会话详情
*exit                    # 退出代理模式

# 代理特定示例
@dev *help               # 开发者代理命令
@qa *review STORY-42     # QA 代理审查 story

核心组件结构#

.aios-core/ 目录包含所有代理能力的定义和资源：

• agents/: 基础构建块，每个 markdown 文件定义单个 AI 代理的角色、能力和依赖
• agent-teams/: 团队文件定义代理集合和工作流捆绑
• workflows/: YAML 文件定义特定项目类型的步骤和代理交互序列
• templates/: 可重用文档模板（PRD、架构规格、用户 stories 等）
• tasks/: 特定可重复操作的指令
• checklists/: 质量保证检查表
• data/: 核心知识库和技术偏好

扩展机制：Squads#

squads/ 目录包含预构建的代理团队包，每个 squad 包含：config.yaml, agents/, tasks/, templates/, checklists/, data/, README.md

IDE 兼容性#

当前版本：v4.2.15 主要语言：JavaScript (95.7%), TypeScript, Python, Shell