阿超 > aios-core

aios-core

2026-02-16

ai

莫等闲，白了少年头，空悲切。——岳飞

Synkra AIOS：用“代理化敏捷”重构你的全栈开发流程

在将 AI 引入软件工程的诸多尝试中，Synkra AIOS 给出了一条极具工程美感的路径：以“CLI 优先”的架构基线、以“代理化规划 + 工程化上下文开发”为双核创新，把需求、规划、执行、质量和记忆融入一个可编排、可观测、可扩展的框架中。仓库 SynkraAI/aios-core 是该体系的核心框架，主旨是 AI-Orchestrated System for Full Stack Development。

仓库描述：Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework v4.0
主题标签：agents、ai-agents、automation、cli、development、framework、fullstack、nodejs、orchestration、typescript
文档多语种支持：英文、葡语、西语
主页与资源导航详见仓库 README 与 docs 目录

下面，我将基于仓库的说明，完整介绍它的架构理念、双核创新、安装配置、CLI 能力、ADE 自主开发引擎，以及核心模块的 API 代码示例，帮助你在团队中快速落地。

架构基线：CLI First → Observability Second → UI Third

AIOS 的优先级层次非常清晰：所有智能与决策首先驻留在命令行，观测层用来“看见”CLI 的实时工作，UI 做少量管理与可视化。官方在 README 中明确了这条基线与由此派生的实践原则。

1
2
3
4
5
6
7
```
CLI First → Observability Second → UI Third

- A CLI é a fonte da verdade - dashboards apenas observam
- Funcionalidades novas devem funcionar 100% via CLI antes de ter UI
- A UI nunca deve ser requisito para operação do sistema
- Observabilidade serve para entender o que o CLI está fazendo, não para controlá-lo
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

这意味着：

- 任何新功能先以 CLI 形式完整可用
- 观测层不替代 CLI，而是帮助团队理解与追踪行为
- UI 是补充，不是必需项

对于强调可自动化、可复现的工程团队，这样的基线可以有效减少实现碎片，统一研发动线。

---

## 双核创新：代理化规划 + 工程化上下文开发

AIOS 把智能代理分工落到需求与开发的两个关键阶段，形成极具可操作性的工作流。

```markdown

  1. Planejamento Agêntico：analyst、pm、architect 等规划代理协作产出高质量的 PRD 与架构文档，结合进阶提示工程与人类参与修正。

  2. Desenvolvimento Contextualizado por Engenharia：sm 代理把详细规划转成高细粒度的开发故事，包含上下文、实现细节与架构指导，直接进入 dev 代理的执行入口。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
```

这种“两阶段”方式，直接对准了 AI 助手在真实工程里最容易失效的两件事：规划不一致、上下文丢失。把这些问题前置到“规划代理 + 故事文件”中，能让开发代理在明确的边界和意图下稳定产出。

---

## 安装与更新：用一个 NPX 命令起步

AIOS 的安装与更新都走 NPX，支持交互式现代安装体验、多组件选择、包管理器选择、跨平台验证等。

```markdown
```bash
# 创建新项目
npx aios-core init meu-projeto

# 安装到现有项目
cd seu-projeto
npx aios-core install

# 使用最新版本
npx aios-core@latest init meu-projeto
1
2
3
4
5
6
7
8
9
10
11

```markdown
```bash
# 更新已有安装
npx aios-core@latest install

# 自动：
# - 检测现有安装
# - 更新变更文件
# - 为自定义修改生成 .bak 备份
# - 保留项目配置
1
2
3
4
5
6
7

支持“静默安装”和“Dry-Run”模拟，非常适合 CI/CD 与团队批量部署。

```markdown
```bash
# CI/CD 静默安装
npx aios-core install --quiet --force
1
2
3
4
5
6

```markdown
```bash
# Dry-Run 模拟安装
npx aios-core install --dry-run
# 输出将显示将创建的目录、复制的文件、是否初始化 Git 等，不改动任何文件
1
2
3
4
5
6
7
8
9
10

前置要求：Node.js >=18（推荐 20+）、npm >=9，GitHub CLI 可选。

---

## CLI 能力与参考

AIOS 提供现代、跨平台的 CLI，带全面帮助系统和彩色输出，支持版本查询、系统信息、诊断与修复。

```markdown

Usage: aios-core [options] [command]

Commands:
init 创建新项目
install [options] 安装到当前目录
info 显示系统信息
doctor [options] 运行诊断与健康检查
help [command] 查看详细帮助

1
2
3
4
5
6
7
8
9
10
11
```

如果你从 Web 界面快速起步，两分钟即可完成“安装 → IDE 规则配置 → 激活规划代理 → 使用 *help → 按照用户指南推进”的最短路径。

---

## 文档与指南：多语种覆盖与快速入口

文档支持英文、葡语、西语，并提供从入门到架构、代理系统、工作流、故障排除等完整索引。

```markdown

English / Português / Español 文档均已完成，直接从 Getting Started 开始

1
2
3
```

```markdown

Quick Links（English）：

  • Getting Started
  • Installation Guide
  • Architecture Overview
  • Agent Reference
  • Workflow Documentation
  • Troubleshooting
1
2
3
4
5
6
7
8
9
```

---

## ADE：把“需求”稳定地变成“可运行代码”

AIOS v1.0.0 引入了 Autonomous Development Engine（ADE），它把“规格管线 → 执行引擎 → QA → 恢复系统 → 记忆层”串成闭环，目标是自动化地把需求转化为工作代码。

```markdown

User Request → Spec Pipeline → Execution Engine → QA Review → Working Code
↓
Recovery System
↓
Memory Layer

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
```

快速上手命令非常清晰，按代理角色分步推进：

```markdown
```bash
# 1. 从需求生成规格
@pm *gather-requirements
@architect *assess-complexity
@analyst *research-deps
@pm *write-spec
@qa *critique-spec

# 2. 执行规格
@architect *create-plan
@architect *create-context
@dev *execute-subtask 1.1

# 3. QA 评审
@qa *review-build STORY-42
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

对于希望把 AI 正式纳入“工程闭环”的团队，这是非常关键的抓手。

---

## 核心模块 API：直接可复制的代码片段

核心模块位于 `.aios-core/core`，提供配置管理、会话上下文、引导工作流、YAML 校验、输出格式化等能力，且支持 CommonJS 与 ESM。

### 模块引入

```markdown
```javascript
// CommonJS
const core = require('./.aios-core/core');

// ES Modules
import { ConfigCache, ElicitationEngine } from './.aios-core/core/index.esm.js';
1
2
3
4
5
6
7
8
9
10
11
12

### 配置缓存与加载

```markdown
```javascript
const { globalConfigCache } = require('./.aios-core/core');

// 写入配置，5 分钟 TTL
globalConfigCache.set('my-key', { value: 42 }, 300000);

// 读取配置
const config = globalConfigCache.get('my-key');
1
2
3
4
5

```markdown
```javascript
const { loadAgentConfig } = require('./.aios-core/core');
const agentConfig = await loadAgentConfig('dev');
1
2
3
4
5

```markdown
```javascript
const { loadConfigSections } = require('./.aios-core/core');
const config = await loadConfigSections(['persona', 'commands']);
1
2
3
4
5
6
7
8

### 会话与上下文

```markdown
```javascript
const { ContextDetector } = require('./.aios-core/core');
const detector = new ContextDetector();
const context = detector.detectContext();
1
2
3
4
5
6

```markdown
```javascript
const { SessionContextLoader } = require('./.aios-core/core');
const loader = new SessionContextLoader();
const context = await loader.loadContext(sessionId);
1
2
3
4
5
6
7
8
9
10

### 引导工作流与会话管理

```markdown
```javascript
const { ElicitationEngine } = require('./.aios-core/core');
const engine = new ElicitationEngine();

const session = await engine.startSession('create-agent');
const response = await engine.processStep(session.id, userInput);
1
2
3
4
5
6
7
8
9
10
11
12
13

### YAML 校验与输出格式化

```markdown
```javascript
const { YAMLValidator, validateYAML } = require('./.aios-core/core');

// 快速校验
const result = await validateYAML(yamlContent, 'agent');

// 完整校验
const validator = new YAMLValidator();
const validation = await validator.validateFile('agent.yaml', 'agent');
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

通过这些 API，你可以把“规划代理生成的故事文件”与“任务工作流”编织到团队的自动化开发回路里。

---

## 质量与工作流：多层防护与分支保护

AIOS 在本地 pre-commit、pre-push 与云端 CI/CD 设置了三层验证，覆盖 ESLint、TypeScript、测试与覆盖率等，并提供分支保护脚本。

```markdown
```bash
# 本地验证
npm run lint
npm run typecheck
npm test
npm run test:coverage

# AIOS 验证器
node .aios-core/utils/aios-validator.js pre-commit
node .aios-core/utils/aios-validator.js pre-push
node .aios-core/utils/aios-validator.js stories
1
2
3
4
5

```markdown
```bash
# 分支保护
node scripts/setup-branch-protection.js
1
2
3
4
5
6
7
8
9
10

这类“工程化约束”，能把 AI 辅助的开发行为纳入团队质量门槛，保证迭代的可持续性。

---

## 代理角色与扩展：从“队伍”到“域扩展”

AIOS 内置 11 类专业代理，覆盖编排、规划、开发与质量等角色；同时你可以通过“Squads”机制把框架扩展到任意领域，并自定义代理、任务和模板。

```markdown

Agentes Meta：aios-master、aios-orchestrator
Agentes de Planejamento：analyst、pm、architect、ux-expert
Agentes de Desenvolvimento：sm、dev、qa、po

1
2
3
```

```markdown

squads/seu-squad/
├── config.yaml
├── agents/
├── tasks/
├── templates/
├── checklists/
├── data/
├── README.md
└── user-guide.md

1

这让“代理化敏捷”不局限于软件开发，也可迁移到创作、商业策略、教育等多种场景。

社区与贡献

仓库提供了完整的贡献流程、社区指南、Roadmap 与讨论区，欢迎提出新特性与改进。许可与法律文档详见仓库的 LICENSE 与 docs 法规页。

总结

Synkra AIOS 并不是“把 AI 加进 IDE”的一次性尝试，而是把“规划 → 规格 → 执行 → 质量 → 记忆”串成闭环，以 CLI 为首位，构建可编排、可观测、可扩展的工程平台。它的精髓在于：

  • 把 AI 代理引入到“工程结构化”的两个关键阶段
  • 用故事文件与引导工作流，稳住上下文与边界
  • 以多层验证与分支保护，确保质量门槛与团队协作

如果你正准备把 AI 助手真正“落在工程里”，不妨用一个 NPX 命令起步，在你的团队里把“代理化敏捷”跑起来。