create-vela-workflow 1.0.0

package/README.md

@@ -0,0 +1,136 @@
+# 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` |
+
+## 快速开始
+
+```bash
+# 在当前目录安装全部工作流配置
+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 方式）
+
+## 更新
+
+```bash
+# 获取最新版本
+npx create-vela-workflow@latest . --mode all
+```
+
+## 文档
+
+- [AI 自动化生成应用教程](https://iot.mi.com/vela/quickapp/ai-workflow)
+- [Vela 快应用官方文档](https://iot.mi.com/vela/quickapp/)
+
+## 命令行参数
+
+```
+用法: npx create-vela-workflow [目标目录] [选项]
+
+选项:
+  --mode <mode>    安装模式 (默认: all)
+                     copilot  — 仅安装 .github/
+                     kiro     — 仅安装 .kiro/ + .workflow/
+                     all      — 安装全部
+  --help, -h       显示帮助信息
+  --version, -v    显示版本号
+```
+
+## 维护者发布
+
+```bash
+# 修改代码后发布新版本
+cd release/
+npm version patch   # 或 minor / major
+npm publish
+```
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,188 @@
+#!/usr/bin/env node
+
+'use strict'
+
+const fs = require('fs')
+const path = require('path')
+
+// ============================================================
+// create-vela-workflow CLI
+// 用法:
+//   npx create-vela-workflow [项目目录] [--mode copilot|kiro|all]
+//   npx create-vela-workflow --help
+//   npx create-vela-workflow --version
+// ============================================================
+
+const VERSION = require('../package.json').version
+const TEMPLATES_DIR = path.join(__dirname, '..', 'templates')
+
+// 颜色输出
+const colors = {
+  green: (t) => `\x1b[32m${t}\x1b[0m`,
+  yellow: (t) => `\x1b[33m${t}\x1b[0m`,
+  red: (t) => `\x1b[31m${t}\x1b[0m`,
+  cyan: (t) => `\x1b[36m${t}\x1b[0m`,
+  bold: (t) => `\x1b[1m${t}\x1b[0m`,
+}
+
+function printHelp() {
+  console.log(`
+${colors.bold('create-vela-workflow')} v${VERSION}
+Vela 快应用 AI 自动化开发工作流脚手架
+
+${colors.bold('用法:')}
+  npx create-vela-workflow [目标目录] [选项]
+
+${colors.bold('选项:')}
+  --mode <mode>    安装模式 (默认: all)
+                     copilot  — 仅安装 .github/ (VS Code/AIoT IDE + Copilot)
+                     kiro     — 仅安装 .kiro/ + .workflow/ (Kiro IDE)
+                     all      — 安装全部
+  --help, -h       显示帮助信息
+  --version, -v    显示版本号
+
+${colors.bold('示例:')}
+  npx create-vela-workflow my-app
+  npx create-vela-workflow my-app --mode copilot
+  npx create-vela-workflow . --mode kiro
+  npx create-vela-workflow --mode all
+
+${colors.bold('文档:')}
+  https://iot.mi.com/vela/quickapp/
+`)
+}
+
+function printVersion() {
+  console.log(VERSION)
+}
+
+// 递归复制目录
+function copyDirSync(src, dest) {
+  if (!fs.existsSync(src)) {
+    console.log(colors.yellow(`  ⚠️  源目录不存在: ${src}`))
+    return 0
+  }
+  fs.mkdirSync(dest, { recursive: true })
+  let count = 0
+  const entries = fs.readdirSync(src, { withFileTypes: true })
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name)
+    const destPath = path.join(dest, entry.name)
+    if (entry.isDirectory()) {
+      count += copyDirSync(srcPath, destPath)
+    } else {
+      fs.copyFileSync(srcPath, destPath)
+      count++
+    }
+  }
+  return count
+}
+
+function main() {
+  const args = process.argv.slice(2)
+
+  // 解析参数
+  let targetDir = '.'
+  let mode = 'all'
+  let i = 0
+
+  while (i < args.length) {
+    const arg = args[i]
+    if (arg === '--help' || arg === '-h') {
+      printHelp()
+      process.exit(0)
+    }
+    if (arg === '--version' || arg === '-v') {
+      printVersion()
+      process.exit(0)
+    }
+    if (arg === '--mode') {
+      i++
+      mode = args[i] || 'all'
+      if (!['copilot', 'kiro', 'all'].includes(mode)) {
+        console.error(colors.red(`❌ 未知模式: ${mode}`))
+        console.error(`   支持: copilot | kiro | all`)
+        process.exit(1)
+      }
+    } else if (!arg.startsWith('-')) {
+      targetDir = arg
+    }
+    i++
+  }
+
+  // 解析目标路径
+  const resolvedTarget = path.resolve(targetDir)
+
+  console.log('')
+  console.log(colors.bold('🚀 Vela 快应用 AI 工作流安装器'))
+  console.log('═══════════════════════════════════════')
+  console.log(`📂 目标目录: ${colors.cyan(resolvedTarget)}`)
+  console.log(`📦 安装模式: ${colors.cyan(mode)}`)
+  console.log('')
+
+  // 创建目标目录
+  fs.mkdirSync(resolvedTarget, { recursive: true })
+
+  let totalFiles = 0
+
+  // 安装 .github (copilot 模式)
+  if (mode === 'copilot' || mode === 'all') {
+    const src = path.join(TEMPLATES_DIR, '.github')
+    const dest = path.join(resolvedTarget, '.github')
+    if (fs.existsSync(dest)) {
+      console.log(colors.yellow('  ⚠️  .github/ 已存在，将合并覆盖'))
+    }
+    const count = copyDirSync(src, dest)
+    console.log(colors.green(`  ✅ .github/ — ${count} 个文件`))
+    totalFiles += count
+  }
+
+  // 安装 .kiro (kiro 模式)
+  if (mode === 'kiro' || mode === 'all') {
+    const kiroSrc = path.join(TEMPLATES_DIR, '.kiro')
+    const kiroDest = path.join(resolvedTarget, '.kiro')
+    if (fs.existsSync(kiroDest)) {
+      console.log(colors.yellow('  ⚠️  .kiro/ 已存在，将合并覆盖'))
+    }
+    const kiroCount = copyDirSync(kiroSrc, kiroDest)
+    console.log(colors.green(`  ✅ .kiro/ — ${kiroCount} 个文件`))
+    totalFiles += kiroCount
+
+    const wfSrc = path.join(TEMPLATES_DIR, '.workflow')
+    const wfDest = path.join(resolvedTarget, '.workflow')
+    if (fs.existsSync(wfDest)) {
+      console.log(colors.yellow('  ⚠️  .workflow/ 已存在，将合并覆盖'))
+    }
+    const wfCount = copyDirSync(wfSrc, wfDest)
+    console.log(colors.green(`  ✅ .workflow/ — ${wfCount} 个文件`))
+    totalFiles += wfCount
+  }
+
+  console.log('')
+  console.log('═══════════════════════════════════════')
+  console.log(colors.green(colors.bold(`🎉 安装完成！共 ${totalFiles} 个文件`)))
+  console.log('')
+
+  // 使用提示
+  if (mode === 'copilot' || mode === 'all') {
+    console.log(colors.bold('📋 方式一: AIoT IDE / VS Code + Copilot'))
+    console.log('   1. 在 IDE 中打开项目')
+    console.log('   2. 打开 Copilot Chat')
+    console.log('   3. 选择 "Vela 快应用工作流" Agent')
+    console.log('   4. 输入需求描述，开始开发')
+    console.log('')
+  }
+
+  if (mode === 'kiro' || mode === 'all') {
+    console.log(colors.bold('📋 方式二: Kiro + Workflow'))
+    console.log('   1. 在 Kiro 中打开项目')
+    console.log('   2. 对话框输入: @.workflow/workflow_starter.md')
+    console.log('   3. 按提示输入需求，工作流自动执行')
+    console.log('')
+  }
+
+  console.log(colors.cyan('📚 详细教程: https://iot.mi.com/vela/quickapp/ai-workflow'))
+  console.log('')
+}
+
+main()