app-dev-workflow（应用程序开发工作流程）

AppDev Skill：通用应用软件开发全流程

从需求到部署，六阶段标准化开发流程。

┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐
│  产品   │ →  │  规划   │ →  │  生成   │ →  │  实现   │ →  │  验证   │ →  │  集成   │
│(Product)│    │ (Plan)  │    │(Generate)│   │(Implement)│   │(Validate) │   │(Integrate)│
└─────────┘    └─────────┘    └─────────┘    └─────────┘    └─────────┘    └─────────┘
    1h            30min          1h            2-4h           30min          30min
   PRD文档       需求对齐       代码骨架       业务逻辑       编译+测试       版本归档

前置依赖

• DevEco Studio 4.0+
• HarmonyOS SDK 6.0+
• Node.js >= 18
• TypeScript 5.0+

快速开始

# 1. 初始化项目
bash scripts/init-project.sh ./MyApp MyFeature

# 2. 产品功能设计
bash scripts/quick.sh prd init '核心功能'

# 3. AI辅助生成 (v2.0)
bash scripts/quick.sh ai service --prd=docs/prd/核心功能_PRD.md
bash scripts/quick.sh ai page --prd=docs/prd/核心功能_PRD.md
bash scripts/quick.sh ai tests --for=MyService

# 或传统生成
bash scripts/quick.sh gen model MyModel
bash scripts/quick.sh gen service MyService
bash scripts/quick.sh gen list-page MyList

# 4. TDD开发
bash scripts/quick.sh tdd start MyService myMethod

# 5. 架构可视化
bash scripts/quick.sh viz html

# 6. 质量报告
bash scripts/quick.sh report

# 7. 性能分析 (v2.0)
bash scripts/quick.sh perf analyze

# 8. 协作同步 (v2.0)
bash scripts/quick.sh sync status

# 9. 自动化流水线
bash scripts/quick.sh pipeline run --from=generate --to=verify
bash scripts/fill-logic.sh MyService myMethod
bash scripts/tdd.sh run

# 5. 编译验证
bash scripts/build-check.sh

# 6. 版本归档
./update.sh minor "完成核心功能"

六阶段开发流程

阶段1：产品功能设计（1小时）

目标：产出可开发的PRD文档

# 初始化PRD
bash scripts/prd.sh init '功能名称'

# 生成用户流程
bash scripts/prd.sh flow '功能名称'

# 设计数据埋点
bash scripts/prd.sh tracking '功能名称'

输出：

• docs/prd/功能名称_PRD.md - 完整需求文档
• docs/prd/功能名称_flow.md - 用户流程图
• docs/prd/功能名称_tracking.md - 埋点设计

阶段2：规划（30分钟）

目标：明确技术方案与排期

编辑 PROJECT.md：

# PROJECT.md

## 需求概述
- 功能名称：UserService
- 功能描述：用户管理核心服务
- 复杂度评估：中
- Fallback方案：本地缓存兜底

## 接口定义

interface UserRequest { userId: string; options?: UserOptions; }

interface UserResponse { user: User; permissions: string[]; }

## 检查点
- [ ] 数据模型定义
- [ ] 核心算法实现
- [ ] DevEco编译通过
- [ ] 单元测试覆盖>60%
- [ ] 规范检查通过>90分

阶段3：生成（1小时）

# 生成数据模型
bash scripts/generate.sh model User

# 生成服务骨架
bash scripts/generate.sh service UserService

# 生成页面骨架
bash scripts/generate.sh page UserPage

# 生成Mock数据
bash scripts/generate.sh mock UserAPI

阶段4：实现（2-4小时）

4.1 TDD开发流程（推荐）

# 1. 启动TDD流程
bash scripts/tdd.sh start UserService getUserInfo

# 2. 运行测试（Red Phase）
bash scripts/tdd.sh run

# 3. 智能填充代码
bash scripts/fill-logic.sh UserService getUserInfo

# 4. 运行测试（Green Phase）
bash scripts/tdd.sh run

# 5. 重构检查
bash scripts/tdd.sh refactor

4.2 调试诊断

# 查看日志
bash scripts/debug.sh . logs 100

# 检查Service状态
bash scripts/debug.sh . state

# 性能分析
bash scripts/debug.sh . perf

# 全面诊断
bash scripts/debug.sh . analyze

阶段5：验证（30分钟）

# DevEco编译检查
bash scripts/build-check.sh

# 规范检查
bash scripts/lint.sh src/services/UserService.ts

# 单元测试
bash scripts/test.sh UserService

# 验收清单
bash scripts/prd.sh checklist '功能名称'

阶段6：集成（30分钟）

# 更新版本
./update.sh minor "完成用户管理功能"

# 自动执行：
# - 更新 version.json
# - 写入 CHANGELOG.md
# - 运行规范检查
# - 运行编译验证
# - 生成代码统计报告
# - 备份到 versions/

工具脚本清单

v1.2 新增工具

v2.0 新增工具 (AI辅助)

项目结构

MyApp/
├── docs/
│   ├── prd/                    # PRD文档
│   └── api/                    # API文档
├── src/
│   ├── models/                 # 数据模型
│   ├── services/               # 业务服务
│   ├── pages/                  # 页面组件
│   ├── viewmodels/             # 状态管理
│   └── common/                 # 公共工具
├── test/
│   ├── unittest/               # 单元测试
│   └── e2e/                    # E2E测试
├── scripts/                    # 工作流脚本
├── templates/                  # 代码模板
├── references/                 # 参考资料
├── PROJECT.md                  # 项目配置
└── version.json                # 版本信息

规范检查规则

优先级定义

P0 - 必须完成（阻塞演示）
├── 核心功能接口
├── 基础页面结构
└── 数据流打通

P1 - 应该完成（完整体验）
├── 增强交互
├── 错误处理
└── 性能优化

P2 - 可以延后（锦上添花）
├── 动效细节
├── 高级功能
└── 统计分析

故障排查

编译失败

bash scripts/build-check.sh --verbose

运行时崩溃

bash scripts/debug.sh . logs 100
hdc hilog | grep MyApp

测试失败

bash scripts/tdd.sh status
bash scripts/debug.sh . analyze

版本历史

版本：v2.0 评分：98/100 状态：已完成全部规划功能 适用范围：HarmonyOS 4.0+ 应用开发 许可证：MIT