App Dev Workflow

---
name: app-dev-workflow
description: |
  通用应用软件开发完整工作流（HarmonyOS版）。支持从需求到部署的全流程开发管理。
  包含：产品功能设计、代码生成、TDD开发、调试诊断、编译验证、版本管理。
  适用于各类HarmonyOS应用的快速开发。
  当用户需要开发HarmonyOS应用、生成代码、管理开发进度、进行TDD开发时触发。
  关键词：开发应用、生成代码、TDD、调试、编译检查、版本管理
---

# 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+

---

## 快速开始

```bash
# 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文档

```bash
# 初始化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`：

```markdown
# PROJECT.md

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

## 接口定义
```typescript
interface UserRequest {
  userId: string;
  options?: UserOptions;
}

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

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

---

### 阶段3：生成（1小时）

```bash
# 生成数据模型
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开发流程（推荐）

```bash
# 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
# 查看日志
bash scripts/debug.sh . logs 100

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

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

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

---

### 阶段5：验证（30分钟）

```bash
# 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分钟）

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

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

---

## 工具脚本清单

| 脚本 | 用途 | 使用阶段 |
|-----|------|---------|
| `init-project.sh` | 项目初始化 | 开始 |
| `prd.sh` | PRD/流程/埋点 | 产品设计 |
| `generate.sh` | 代码生成 | 生成 |
| `tdd.sh` | TDD流程 | 实现 |
| `fill-logic.sh` | 代码填充 | 实现 |
| `update-logic.sh` | 增量更新 | 实现 |
| `debug.sh` | 调试诊断 | 实现/验证 |
| `build-check.sh` | 编译验证 | 验证 |
| `lint.sh` | 规范检查 | 验证 |
| `test.sh` | 测试运行 | 验证 |
| `demo-prep.sh` | 演示准备 | 集成 |
| `update.sh` | 版本管理 | 集成 |

### v1.2 新增工具

| 脚本 | 用途 | 使用阶段 |
|-----|------|---------|
| `quick.sh` | 快捷命令集 | 全流程 |
| `visualize.sh` | 架构可视化 | 规划/验证 |
| `setup-hooks.sh` | Git Hooks 安装 | 全流程 |
| `mock-server.sh` | Mock API 服务 | 实现 |
| `quality-report.sh` | 质量报告生成 | 验证 |
| `suggest.sh` | 智能建议 | 全流程 |
| `pipeline.sh` | 自动化流水线 | 全流程 |

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

| 脚本 | 用途 | 使用阶段 |
|-----|------|---------|
| `ai-generate.sh` | AI辅助代码生成 | 生成/实现 |
| `sync.sh` | 多开发者协作 | 全流程 |
| `perf-report.sh` | 性能监控报告 | 验证 |

---

## 项目结构

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

---

## 规范检查规则

| 规则ID | 级别 | 说明 |
|-------|------|------|
| HOS-001 | 警告 | 使用@ObservedV2替代@Observed |
| HOS-002 | 错误 | 禁止使用any类型 |
| HOS-003 | 错误 | 硬编码字符串必须使用$r引用 |
| PERF-001 | 警告 | 避免在循环中使用await |
| PERF-002 | 错误 | 大列表必须使用LazyForEach |
| SEC-001 | 错误 | 敏感数据使用SecureStorage |
| SEC-002 | 错误 | 日志禁止输出敏感信息 |
| ERR-001 | 警告 | async函数必须有错误处理 |
| BUILD-001 | 错误 | DevEco编译必须通过 |

---

## 优先级定义

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

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

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

---

## 故障排查

### 编译失败
```bash
bash scripts/build-check.sh --verbose
```

### 运行时崩溃
```bash
bash scripts/debug.sh . logs 100
hdc hilog | grep MyApp
```

### 测试失败
```bash
bash scripts/tdd.sh status
bash scripts/debug.sh . analyze
```

---

## 版本历史

| 版本 | 日期 | 更新内容 |
|-----|------|---------|
| v2.0 | 2026-03-20 | AI辅助生成、实时协作、性能监控 (98分) |
| v1.2 | 2026-03-20 | 架构可视化、Git Hooks、Mock服务、质量报告 (97分) |
| v1.1 | 2026-03-20 | 快捷命令、健康检查、智能建议、自动化流水线、增强模板 (95分) |
| v1.0 | 2026-03-20 | 初始版本，六阶段流程 (92分) |

---

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