企业官网建设流程全解析

AIOX快速入门（Getting Started）：面向初学者的完整分步教程

【免费下载链接】aiox-coreSynkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework v4.0项目地址: https://gitcode.com/GitHub_Trending/ai/aiox-core

AIOX（Synkra AIOS）是一个面向全栈开发的 AI 编排系统，通过 12 个专业 AI 智能体（产品经理、架构师、开发者、QA 等）协同工作，帮你完成从需求分析、架构设计到编码、测试的完整流程。本文是一份面向初学者的完整分步教程，教你在 10 分钟内安装并跑通 AIOX。

AIOX 是什么？为什么值得学习？

如果你用过 AI 写代码，可能遇到过两个痛点：规划不一致（AI 每次理解都不同）和上下文丢失（写到一半忘了最初的设计）。AIOX 用"两阶段协作"解决了这两个问题：

1. 智能体规划阶段：analyst（分析师）、pm（产品经理）、architect（架构师）等智能体与你协作，产出详细的 PRD（产品需求文档）和架构文档；
2. 工程化开发阶段：sm（Scrum Master）把规划转写成超详细的开发故事（Story），dev（开发者）打开故事文件就拥有完整上下文——做什么、怎么做、为什么做。

它的核心理念是CLI First（命令行优先）：所有智能体、工作流和命令都在终端与 AI IDE 中完成，不依赖图形界面。

安装前准备：快速检查环境

在开始之前，请确认你的电脑满足以下要求：

💡提示：AIOX 对不同 IDE 的支持程度不同。Claude Code 支持最完整（参考实现），Gemini CLI 支持度高，Codex CLI、Cursor、Copilot 属于部分支持。具体差异可参考 docs/ide-integration.md。

第一步：一行命令安装 AIOX

AIOX 提供交互式安装向导，无需手动克隆仓库和配置文件。打开终端，执行：

# 创建全新项目 npx aiox-core init my-first-project cd my-first-project # 或者在已有项目中安装（对旧项目安全，不会覆盖你的配置） cd your-existing-project npx aiox-core install

安装向导会引导你完成：选择要安装的组件（核心框架、智能体系统、Squads 等）、选择包管理器（npm / yarn / pnpm）、是否初始化 Git 仓库等，并在结束前显示安装摘要。

安装完成后，项目里会多出如下关键目录：

my-first-project/ ├── .aiox-core/ # AIOX 框架核心（core、data、development、infrastructure） ├── .claude/ .codex/ .gemini/ # 各 IDE 的集成配置（按需生成） ├── docs/stories/ # 开发故事文件（智能体协作的核心载体） └── package.json

如果你想体验贡献者模式（修改 AIOX 源码本身），也可以克隆仓库：

git clone https://gitcode.com/GitHub_Trending/ai/aiox-core cd aiox-core && npm install

第二步：运行诊断命令，验证安装是否健康

安装后建议花 30 秒做一次"体检"：

npx aiox-core doctor

诊断命令会自动检查 Node.js 版本、Git、.aiox-core/目录结构、智能体文件（应发现 11 个）、工作流文件和模板数量，最后给出"✅ All checks passed!"之类的结论。若发现小问题，可加参数自动修复：

npx aiox-core doctor --fix

第三步：激活你的第一个 AI 智能体

AIOX 的智能体需要在你选定的 AI IDE / CLI 中激活。各平台的激活路径如下：

新手建议先激活总管智能体：

@aiox-master

激活后你会看到类似下面的欢迎语（greeting），这代表"首次价值"已经达成：

🎯 AIOX Master ready! Type *help to see available commands.

✅首次价值判定标准（官方定义）：激活 1 个智能体 + 收到有效问候 + 运行 1 条初始命令并获得有用输出，全部在 10 分钟内完成即算通过。

试试这几条通用命令（任何智能体都认）：

第四步：认识你的 AI 团队，创建第一个开发故事

AIOX 自带 12 个"数字员工"，各有名字和分工：

一个典型的协作流程是这样的：

1. @pm 创建 PRD（*create-epic） 2. @sm 起草开发故事（*draft） 3. @po 校验故事（*validate-story-draft） 4. @dev 根据故事文件实现 5. @qa 评审（*review STORY-42） 6. @devops 推送代码（*push） 7. @po 关闭故事（*close-story STORY-ID）

你的第一个实操动作：激活@po并输入@po *create-story，按提示填写故事标题、描述、验收标准和优先级——恭喜你，一个标准的 AI 敏捷开发闭环就跑通了。

已有老项目？AIOX 也能无缝接入（Brownfield）

如果你不是从零开始，而是想在旧代码库上启用 AIOX，只需：

cd my-existing-project npx aiox-core install npx aiox-core doctor

AIOX 的接入是非破坏性的：只创建新文件、从不覆盖你的.eslintrc、tsconfig.json等配置；必要时还可以用 Git 一键回退到接入前的状态。首次激活智能体时，它会主动提出帮你分析代码库并产出系统架构文档 + 技术债务报告。

常见问题排查（新手最常踩的坑）

下一步：继续深入 AIOX

• 完整使用流程（规划阶段 + 开发循环）：docs/guides/user-guide.md
• 分步新手教程（官方 Getting Started）：docs/getting-started.md
• 5 分钟速查版：docs/installation/v4-quick-start.md
• 各平台安装指南（macOS / Windows / Linux）：docs/installation/
• 用 Squads 把 AIOX 扩展到写作、商业、教育等非技术领域：docs/guides/squads-guide.md
• 想理解底层设计（ADE 自治开发引擎、分层架构）：docs/architecture/ARCHITECTURE-INDEX.md

跟着本教程走完四步，你就已经拥有一支 24 小时在线的"AI 全栈敏捷团队"。🚀

【免费下载链接】aiox-coreSynkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework v4.0项目地址: https://gitcode.com/GitHub_Trending/ai/aiox-core