# Flutter_Skill 技能

**Repository Path**: wick/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**: 15
- **Created**: 2026-06-05
- **Last Updated**: 2026-06-05

## 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 检查）。分析项目配置与 README，生成 OpenHarmony/HarmonyOS 项目规格书与交付 README，仅汇总鸿蒙平台功能 | 「生成规格书」「鸿蒙规格书」 |
| `flutter-ohos-readme` | OpenHarmony README 生成。创建 `README.OpenHarmony_CN.md`、`README.OpenHarmony.md`、`README.OpenSource.md` 及鸿蒙 CHANGELOG | 「生成 OpenHarmony README」 |
| `flutter-ohos-spechtml` | 规格书 HTML 导出。将单个项目规格书 Markdown 转为固定模板 HTML 片段，包含用户场景描述表、系统需求基线表、API 表 | 「导出规格书 HTML」 |
| `flutter-ohos-deliverables` | 交付件生成。生成拼写检查报告、接口文档（Excel）、README 检查、源码链接、XTS 测试截图、设计说明书、测试方案、Android APK 等，支持并行/异步生成 | 「生成交付件」 |
| `flutter-ohos-design-specification` | 设计说明书生成（docx）。生成鸿蒙设计说明书 Word 文档，含 Mermaid 图（系统上下文、模块划分、时序图）、文件结构及占位替换 | 「生成设计说明书」 |
| `flutter-ohos-deliverables-testPlan` | 测试方案生成（docx）。生成测试方案 Word 文档，含模板占位替换及鸿蒙功能测试描述 | 「生成测试方案」 |
| `flutter-ohos-test-report-generator` | 自测试报告生成（docx） | 「生成自测试报告」 |

### 代码迁移与生成类

| 技能名称 | 功能说明 | 触发示例 |
|----------|----------|----------|
| `flutter-ohos-generator` | 生成 ohos 工程骨架。在现有 Flutter 插件项目中快速创建临时 OpenHarmony 插件工程结构，与 Android 包名 1:1 对齐 | 「生成鸿蒙插件工程」 |
| `flutter-ohos-auto-adapt` | Android→鸿蒙代码迁移。自动扫描 `android/src/main` 代码 1:1 生成对应 OpenHarmony 目录与 ArkTS/ETS/资源文件，支持 GLM5/GLM5.1 双模型协作，准确率目标 ≥90% | 「自动鸿蒙化」 |
| `flutter-ohos-unit-test` | Dart 单元测试自动生成。分析 `lib/` Dart 代码，在 `test/` 目录生成或追加鸿蒙相关单元测试，支持 MethodChannel/EventChannel Mock、异步测试、边界条件覆盖，编译失败自动修复 | 「生成单元测试」 |

### 分析评估类

| 技能名称 | 功能说明 | 触发示例 |
|----------|----------|----------|
| `flutter-ohos-plugin-feasibility` | 鸿蒙化可行性评估（HTML 报告）。分析 Android Flutter 插件源码，提取代码规模与接口，评估 OpenHarmony 迁移工作量（人天），输出 Web 风格 HTML 报告，支持批量评估 | 「鸿蒙化评估」 |
| `flutter-ohos-api-analyzer` | 鸿蒙 API 版本分析。扫描 `.ets` 文件识别 API 调用，从 harmony-next 技能文档库查询版本信息，生成 API 版本统计报告（含废弃信息） | 「分析 API 版本」 |
| `ohos-flutter-library-spec-analyzer` | Flutter 库接口规范分析。对 `lib/` 目录做静态源码分析，提取所有导出的类、抽象类、mixin、函数、typedef、枚举、常量、扩展，生成标准化接口规范文档 | 「分析库接口规范」 |
| `ohos-library-migration-analyzer` | 三方库鸿蒙迁移分析。生成综合分析报告：库概览、目录结构、代码统计、依赖分析、构建系统分析、权限分析、鸿蒙迁移方案（平台差异、ArkTS 约束、API Level 兼容性、修改方案、可行性评估、工作量估算）、风险分析与总结 | 「鸿蒙迁移分析」 |
| `ohos-flutter-code-check` | 鸿蒙 Flutter 库代码对比审查。将鸿蒙（ohos）实现逻辑与 Android/iOS 实现对比，按接口逐项检查功能一致性，识别差异与潜在影响，生成结构化对比分析报告 | 「代码对比检查」 |
| `harmonyos-porting-requirement-spec` | 鸿蒙移植需求规格书（SRS）生成。生成完整 SRS，涵盖需求概览、竞品分析、KANO 模型、用户旅程、关键体验指标、5W1H1E 场景设计，API Level 最低要求 API 12 | 「生成移植需求规格书」 |

### 构建发布类

| 技能名称 | 功能说明 | 触发示例 |
|----------|----------|----------|
| `flutter-ohos-pubdev-check` | pub.dev 预发布检查。验证 Flutter 包是否符合 pub.dev 发布要求：pubspec.yaml 校验、README 调整、CHANGELOG 检查、依赖解析、编译验证、dry-run 发布 | 「pub.dev 预检」 |
| `flutter-build-android-apk` | Android APK 构建安装运行。编译 Flutter Android 示例，生成 Debug/Release APK，通过 `adb install -r` 安装并 `flutter run` 运行 | 「编译 apk 并安装」 |
| `ohos-pr-commit` | Git Tag 提交汇总生成。在两个 Git Tag 之间生成提交汇总表，按项目/包名筛选，AI 分析每个提交是否需要 OHOS 适配 | 「生成提交汇总」 |

### 文档导航与质量类

| 技能名称 | 功能说明 | 触发示例 |
|----------|----------|----------|
| `harmony-next` | HarmonyOS NEXT 离线文档导航。通过 Kit/task/index 渐进式披露定位 ArkTS/ArkUI/NDK 文档（聚焦 API 12-23） | 查询鸿蒙 API 文档 |
| `harmonyos-kb-generator` | 项目鸿蒙知识库导航。通过 module/task/index 渐进式披露定位文档，包含 Android→鸿蒙映射，确保自动化编码准确率 ≥95% | 查询项目知识库 |
| `harmony-pre-commit-lint` | Git 提交前 ESLint + AI 代码审查。两阶段检查：(1) ESLint 静态分析暂存 `.ets/.ts` 文件，(2) AI 代码审查分析修改对周围功能的影响 | 提交前代码检查 |

---

## 工具一览

### MCPService — RAGFlow MCP 服务

面向 RAGFlow 的 MCP 服务，为技能提供知识库检索能力。

- **技术栈**：Python 3.10+
- **提供工具**：`rag_healthcheck`（连通性）、`rag_list_datasets`（知识库列表）、`rag_search`（语义检索）
- **配置**：通过 `.env` 配置 RAGFlow API 地址、API Key、知识库 ID
- **集成方式**：作为 MCP Server 挂载到 Cursor，技能可通过 MCP 协议调用知识库检索

### ai-automate-tools — GitCode AI 自动化工具

面向 GitCode 的本地自动化辅助工具，将 PR 审查与 Issue 分析修复串成可观察、可回放的工作流。

- **技术栈**：Node.js + Claude Code CLI
- **核心功能**：
  - **PR 审查**：AI 代码审查，生成评论并跟踪任务进度
  - **Issue 流水线**：批量扫描、AI 分类（BUG/咨询/无效/需求）、自动分析修复、质量审核、总结报告
  - **项目缓存管理**：克隆/同步/删除本地仓库缓存
- **内嵌 Issue 工作流技能**（11 个）：

| 技能名称 | 功能说明 |
|----------|----------|
| `issue-triage` | Issue 分流，识别类型判断是否适合自动处理 |
| `issue-bug-analysis` | BUG 类 Issue 分析 |
| `issue-bug-analysis-fix` | BUG 分析与修复方案设计 |
| `issue-bug-fix` | BUG 代码修复执行 |
| `issue-bug-verify` | 修复质量验证 |
| `issue-consult-handler` | 咨询类 Issue 处理 |
| `issue-invalid-handler` | 无效 Issue 处理 |
| `issue-requirement-handler` | 需求类 Issue 处理 |
| `issue-dev-verify` | 开发验证 |
| `issue-pr-submit` | 修复 PR 提交 |
| `issue-workflow-orchestrator` | 工作流编排调度 |

- **前端**：浏览器操作界面，SSE 实时推送进度
- **安全**：本地运行，代码不上传第三方；AI 产物需人工复核

---

## 规则配置

`rules/` 目录包含项目级规则与策略配置：

| 文件 | 说明 |
|------|------|
| `arkts-more-cases-project-rules.mdc` | ArkTS 适配案例与规则（2000+ 行），用于 Android→鸿蒙代码迁移参考 |
| `harmony-api-priority.mdc` | 鸿蒙 API 优先级策略规则 |
| `ragflow-mcp-priority-policy.mdc` | RAGFlow MCP 优先级策略配置 |

---

## 快速开始

### 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-spechtml/                      # 规格书 HTML 导出
│   ├── flutter-ohos-deliverables/                  # 交付件生成
│   ├── flutter-ohos-design-specification/          # 设计说明书
│   ├── flutter-ohos-deliverables-testPlan/         # 测试方案
│   ├── flutter-ohos-test-report-generator/         # 自测试报告
│   ├── flutter-ohos-generator/                     # ohos 工程骨架生成
│   ├── flutter-ohos-auto-adapt/                    # Android→鸿蒙代码迁移
│   ├── flutter-ohos-unit-test/                     # 单元测试生成
│   ├── flutter-ohos-plugin-feasibility/            # 可行性评估
│   ├── flutter-ohos-api-analyzer/                  # API 版本分析
│   ├── flutter-ohos-pubdev-check/                  # pub.dev 预检
│   ├── flutter-build-android-apk/                  # APK 构建
│   ├── ohos-flutter-library-spec-analyzer/         # 库接口规范分析
│   ├── ohos-library-migration-analyzer/            # 鸿蒙迁移分析
│   ├── ohos-flutter-code-check/                    # 代码对比检查
│   ├── harmonyos-porting-requirement-spec/         # 移植需求规格书
│   ├── ohos-pr-commit/                             # Git Tag 提交汇总
│   ├── harmony-next/                               # 鸿蒙文档导航
│   ├── harmonyos-kb-generator/                     # 项目知识库导航
│   └── harmony-pre-commit-lint/                    # 提交前代码检查
├── Tools/
│   ├── MCPService/                                 # RAGFlow MCP 服务
│   └── ai-automate-tools/                          # GitCode AI 自动化工具
│       └── backend/agent-issues/.claude/skills/    # 内嵌 Issue 工作流技能（11 个）
├── rules/
│   ├── arkts-more-cases-project-rules.mdc          # ArkTS 适配案例规则
│   ├── harmony-api-priority.mdc                    # 鸿蒙 API 优先级策略
│   └── ragflow-mcp-priority-policy.mdc             # RAGFlow MCP 优先级策略
├── README.md
└── LICENSE
```

---

## 许可证

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