# Flutter_Skill 技能

**Repository Path**: treatment/flutter_skill

## Basic Information

- **Project Name**: Flutter_Skill 技能
- **Description**: 本库是flutter项目，用于训练skill技能，根据项目情况逐步训练完善中
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 9
- **Created**: 2026-04-28
- **Last Updated**: 2026-04-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Flutter OpenHarmony 技能包

> 面向 Flutter 三方库鸿蒙化交付的自动化工具链，支持规格书、README、设计说明书、测试方案、自测试报告等文档自动生成。

[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)

---

## 技能一览

| 技能名称 | 功能说明 | 触发示例 |
|----------|----------|----------|
| `flutter-ohos-spec` | 规格书生成（含 README 检查） | 「生成规格书」「鸿蒙规格书」 |
| `flutter-ohos-readme` | OpenHarmony README 生成 | 「生成 OpenHarmony README」 |
| `flutter-ohos-spechtml` | 规格书 HTML 导出 | 「导出规格书 HTML」 |
| `flutter-ohos-pubdev-check` | pub.dev 预发布检查 | 「pub.dev 预检」 |
| `flutter-ohos-generator` | 生成 ohos 工程骨架 | 「生成鸿蒙插件工程」 |
| `flutter-ohos-auto-adapt` | Android→鸿蒙代码迁移 | 「自动鸿蒙化」 |
| `flutter-ohos-plugin-feasibility` | 鸿蒙化可行性评估（HTML 报告） | 「鸿蒙化评估」 |
| `flutter-ohos-deliverables` | 交付件生成（readme检查/codespell/接口文档） | 「生成交付件」 |
| `flutter-ohos-design-specification` | 设计说明书生成（docx） | 「生成设计说明书」 |
| `flutter-ohos-deliverables-testPlan` | 测试方案生成（docx） | 「生成测试方案」 |
| `flutter-ohos-test-report-generator` | 自测试报告生成（docx） | 「生成自测试报告」 |
| `flutter-ohos-unit-test` | Dart 单元测试自动生成 | 「生成单元测试」 |
| `flutter-ohos-api-analyzer` | 鸿蒙 API 版本分析 | 「分析 API 版本」 |
| `flutter-build-android-apk` | Android APK 构建安装运行 | 「编译 apk 并安装」 |
| `harmony-next` | HarmonyOS NEXT 离线文档导航 | 查询鸿蒙 API 文档 |
| `harmony-pre-commit-lint` | Git 提交前 ESLint 检查 | 提交前代码检查 |
| `harmonyos-kb-generator` | 项目鸿蒙知识库导航 | 查询项目知识库 |

---

## 快速开始

### 1. 安装

```bash
git clone https://gitee.com/your-username/flutter_skill.git
```

### 2. 在 Cursor 中使用

将 `skills/` 目录复制到项目的 `.cursor/skills/`：

```bash
cp -r flutter_skill/skills/* your-project/.cursor/skills/
```

### 3. 触发技能

在 Cursor 对话中直接说出需求：

```
「生成测试方案」
「生成设计说明书」
「生成交付件」
```

---

## 文档生成技能详解

### 设计说明书 (`flutter-ohos-design-specification`)

**输出**：`交付件/<项目名>/设计说明书/【Flutter三方库】<项目名>_设计说明书.docx`

**配置文件**：
- `references/personnel_info.md` — 人员信息（姓名、工号）
- `assets/template_cn.docx` — Word 模板

**使用**：
```
「生成设计说明书」
```

---

### 测试方案 (`flutter-ohos-deliverables-testPlan`)

**输出**：`交付件/<项目名>/测试方案/【Flutter三方库】<项目名>_测试方案.docx`

**配置文件**：
- `references/personnel_info.md` — 人员信息（3列表格：角色、姓名、工号）
- `assets/template_cn.docx` — Word 模板

**使用**：
```
「生成测试方案」
```

**注意**：生成前需在技能目录创建 `functional_test_desc.md`，写入一行鸿蒙功能测试描述。

---

### 自测试报告 (`flutter-ohos-test-report-generator`)

**输出**：`交付件/<项目名>/自测试报告/【Flutter三方库】<项目名>_自测试报告.docx`

**使用**：
```
「生成自测试报告」
```

---

### 交付件 (`flutter-ohos-deliverables`)

**输出**：
- `readme检查结论.docx` — README 检查报告
- `codespell报告` — 拼写检查
- `接口文档.xlsx` — API 接口文档
- `源代码.txt` — 源码打包

**使用**：
```
「生成交付件」
```

---

## 人员信息配置

设计说明书、测试方案等技能共用 `references/personnel_info.md`：

```markdown
# 人员信息配置

## 项目人员

| 角色 | 姓名 | 工号 |
|------|------|------|
| Prepared by (拟制) | 张希希 | XW1370052 |
| Reviewed by (评审人) | 夏峰/韩乐 | 00655817/00911903 |
| Approved by (批准) | 夏峰 | 00655817 |
| Test Manager (测试经理) | 朗云庆 | 30061016 |
| Author (作者) | 侯友进 | - |
```

**说明**：
- 多人员用 `/` 分隔，如 `夏峰/韩乐`
- 工号 `-` 表示无工号

---

## 目录结构

```
flutter_skill/
├── skills/
│   ├── flutter-ohos-spec/              # 规格书生成
│   ├── flutter-ohos-readme/            # README 生成
│   ├── flutter-ohos-deliverables/      # 交付件生成
│   ├── flutter-ohos-design-specification/  # 设计说明书
│   ├── flutter-ohos-deliverables-testPlan/ # 测试方案
│   ├── flutter-ohos-test-report-generator/ # 自测试报告
│   ├── flutter-ohos-unit-test/         # 单元测试生成
│   ├── flutter-ohos-api-analyzer/      # API 版本分析
│   ├── flutter-ohos-plugin-feasibility/    # 可行性评估
│   ├── flutter-build-android-apk/      # APK 构建
│   ├── harmony-next/                   # 鸿蒙文档导航
│   └── ...
├── README.md
└── LICENSE
```

---

## 许可证

[Apache License 2.0](LICENSE) — 允许商业使用、修改与再分发。