create-vela-workflow

Vela 快应用 AI 自动化开发工作流脚手架 — 一键初始化 AI 辅助开发环境

简介

让 AI 帮你写小米手表应用。本工具为你的项目注入 AI 工作流配置，支持两种 IDE 环境：

| 方式 | IDE | AI 引擎 | 安装模式 | |------|-----|---------|---------| | 方式一 | AIoT IDE / VS Code | GitHub Copilot | --mode copilot | | 方式二 | Kiro | Kiro AI (Claude) | --mode kiro |

快速开始

# 在当前目录安装全部工作流配置
npx create-vela-workflow .

# 创建新目录并安装
npx create-vela-workflow my-app

# 仅安装 Copilot Agent 方式
npx create-vela-workflow my-app --mode copilot

# 仅安装 Kiro Workflow 方式
npx create-vela-workflow my-app --mode kiro

安装后使用

方式一：AIoT IDE / VS Code + Copilot

1. 在 IDE 中打开项目
2. 打开 Copilot Chat
3. 选择 Vela 快应用工作流 Agent
4. 输入需求描述，工作流自动启动

方式二：Kiro + Workflow

1. 在 Kiro 中打开项目
2. 对话框输入 @.workflow/workflow_starter.md
3. 按提示输入需求，工作流自动执行

安装的文件

--mode copilot 安装内容

.github/
├── agents/                      # 自定义 Agent
│   ├── vela-workflow.agent.md   # 工作流协调器（入口）
│   ├── vela-s1-prd.agent.md    # S1: PRD 生成
│   ├── vela-s2-tech.agent.md   # S2: 技术方案
│   ├── vela-s3-coding.agent.md # S3: 代码生成
│   └── vela-knowledge.agent.md # 知识库查询
├── rules/                       # 编码规则（自动注入）
├── prompts/                     # 知识参考（按需加载）
└── copilot-instructions.md      # 全局指令

--mode kiro 安装内容

.kiro/
├── skills/vela-js-app/SKILL.md  # 完整知识库
├── steering/                    # 工作流规范（自动加载）
├── hooks/                       # 自动化钩子
└── settings/mcp.json            # MCP 配置

.workflow/
├── workflow_starter.md           # 工作流入口
├── scripts/                     # 引擎脚本
└── stages/                      # 阶段编排

前置要求

• Node.js >= 16
• aiot-toolkit（npm install -g aiot-toolkit）

方式一额外要求

• VS Code 或 AIoT IDE
• GitHub Copilot 订阅

方式二额外要求

• Kiro IDE

支持的功能

• ✅ 三阶段工作流：PRD → 技术方案 → 代码生成
• ✅ 快速模式：跳过文档，直接生成代码
• ✅ Figma 设计稿导入与图片导出
• ✅ 飞书文档需求导入
• ✅ 圆屏/方屏多设备适配
• ✅ 代码质量自动校验
• ✅ 断点恢复（Kiro 方式）

更新

# 获取最新版本
npx create-vela-workflow@latest . --mode all

文档

• AI 自动化生成应用教程
• Vela 快应用官方文档

命令行参数

用法: npx create-vela-workflow [目标目录] [选项]

选项:
  --mode <mode>    安装模式 (默认: all)
                     copilot  — 仅安装 .github/
                     kiro     — 仅安装 .kiro/ + .workflow/
                     all      — 安装全部
  --help, -h       显示帮助信息
  --version, -v    显示版本号

维护者发布

# 修改代码后发布新版本
cd release/
npm version patch   # 或 minor / major
npm publish

License

MIT