flutter-skills

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Flutter Skills

Flutter 技能

任务目标

本 Skill 用于：提供现代 Flutter 开发的完整指南，涵盖架构设计、测试流程、故障排除和代码生成
能力包含：Clean Architecture 规范、TDD 工作流、BLoC 状态管理、故障诊断、代码生成脚本、智能助手
触发条件：用户询问 Flutter 架构设计、TDD 测试、状态管理、项目结构、代码生成、故障排除或第三方库选型

本 Skill 用于：提供现代 Flutter 开发的完整指南，涵盖架构设计、测试流程、故障排查和代码生成
能力包含：Clean Architecture 规范、TDD 工作流、BLoC 状态管理、故障诊断、代码生成脚本、智能助手
触发条件：用户询问 Flutter 架构设计、TDD 测试、状态管理、项目结构、代码生成、故障排查或第三方库选型

前置准备

依赖说明：无额外依赖
项目环境：Flutter SDK 3.x、Dart SDK 3.x

依赖说明：无额外依赖
项目环境：Flutter SDK 3.x、Dart SDK 3.x

快速导航

📚 文档索引

快速查找：INDEX.md - 所有资源的快速索引
场景映射：SCENARIOS.md - 用户意图到资源的映射

快速查找：INDEX.md - 所有资源的快速索引
场景映射：SCENARIOS.md - 用户意图到资源的映射

🤖 智能助手触发

触发方式	Agent
"请帮我用 TDD 实现"	TDD Coach
"请审查这段代码"	Code Reviewer
"编写测试"	Test Writer
"审查架构"	Architecture Reviewer

触发方式	Agent
"请帮我用 TDD 实现"	TDD Coach
"请审查这段代码"	Code Reviewer
"编写测试"	Test Writer
"审查架构"	Architecture Reviewer

操作步骤

标准流程

架构设计与规划
- 阅读 architecture-guide.md
- 使用 INDEX.md 快速查找相关资源

功能模块生成（脚本）

bash

python scripts/generate_feature.py --feature-name <name>
python scripts/generate_model.py --model-name <name> --fields <spec>
python scripts/generate_bloc.py --bloc-name <name> --feature <feature>
python scripts/generate_test.py --source <file_path>

TDD 开发流程（Agent + 指导）
- 触发 TDD Coach Agent
- 参考 testing-guide.md
- 触发 Test Writer Agent 生成测试
代码质量保障（Agent）
- 触发 Code Reviewer Agent 审查代码
- 触发 Architecture Reviewer Agent 审计架构
故障排除（诊断）
- 构建错误 → build-errors.md
- 运行时错误 → runtime-errors.md
- 状态问题 → state-debugging.md
- 性能问题 → performance-profiler.md

架构设计与规划
- 阅读 architecture-guide.md
- 使用 INDEX.md 快速查找相关资源

功能模块生成（脚本）

bash

python scripts/generate_feature.py --feature-name <name>
python scripts/generate_model.py --model-name <name> --fields <spec>
python scripts/generate_bloc.py --bloc-name <name> --feature <feature>
python scripts/generate_test.py --source <file_path>

TDD 开发流程（Agent + 指导）
- 触发 TDD Coach Agent
- 参考 testing-guide.md
- 触发 Test Writer Agent 生成测试
代码质量保障（Agent）
- 触发 Code Reviewer Agent 审查代码
- 触发 Architecture Reviewer Agent 审计架构
故障排查（诊断）
- 构建错误 → build-errors.md
- 运行时错误 → runtime-errors.md
- 状态问题 → state-debugging.md
- 性能问题 → performance-profiler.md

决策流程

使用 SCENARIOS.md 中的决策树快速定位：

用户请求
├─ 创建/生成 → scripts/ + commands-guide.md
├─ TDD 开发 → agents/tdd-coach.md + testing-guide.md
├─ 审查代码 → agents/code-reviewer.md
├─ 审查架构 → agents/architecture-reviewer.md
├─ 编写测试 → agents/test-writer.md
└─ 故障排除 → references/diagnostic/

使用 SCENARIOS.md 中的决策树快速定位：

用户请求
├─ 创建/生成 → scripts/ + commands-guide.md
├─ TDD 开发 → agents/tdd-coach.md + testing-guide.md
├─ 审查代码 → agents/code-reviewer.md
├─ 审查架构 → agents/architecture-reviewer.md
├─ 编写测试 → agents/test-writer.md
└─ 故障排查 → references/diagnostic/

资源索引

脚本工具（scripts/）

脚本	功能
generate_feature.py	生成 Feature 结构
generate_model.py	生成 Freezed 模型
generate_bloc.py	生成 BLoC 结构
generate_test.py	生成测试模板

脚本	功能
generate_feature.py	生成 Feature 结构
generate_model.py	生成 Freezed 模型
generate_bloc.py	生成 BLoC 结构
generate_test.py	生成测试模板

核心参考文档

architecture-guide.md - Clean Architecture、BLoC、依赖注入
testing-guide.md - TDD、测试模式、Mocking
packages-guide.md - 库选型指南（40+ 库）
commands-guide.md - Flutter 命令参考

architecture-guide.md - Clean Architecture、BLoC、依赖注入
testing-guide.md - TDD、测试模式、Mocking
packages-guide.md - 库选型指南（40+ 库）
commands-guide.md - Flutter 命令参考

详细技能文档（references/skills/）

Architecture（5个）：bloc-architecture, clean-architecture, dependency-injection, error-handling, feature-structure
Testing（5个）：bloc-testing, mocking-patterns, tdd-workflow, unit-testing, widget-testing
Generation（1个）：screen

Architecture（5个）：bloc-architecture, clean-architecture, dependency-injection, error-handling, feature-structure
Testing（5个）：bloc-testing, mocking-patterns, tdd-workflow, unit-testing, widget-testing
Generation（1个）：screen

详细命令文档（references/commands/）

代码生成：generate-bloc, generate-feature, generate-model, generate-test
构建工具：build-runner, clean-rebuild
测试工具：flutter-test, flutter-coverage
代码质量：flutter-lint

代码生成：generate-bloc, generate-feature, generate-model, generate-test
构建工具：build-runner, clean-rebuild
测试工具：flutter-test, flutter-coverage
代码质量：flutter-lint

诊断指南（references/diagnostic/）

build-errors.md - 构建错误诊断
runtime-errors.md - 运行时错误诊断
state-debugging.md - 状态调试
performance-profiler.md - 性能分析

build-errors.md - 构建错误诊断
runtime-errors.md - 运行时错误诊断
state-debugging.md - 状态调试
performance-profiler.md - 性能分析

智能助手（references/agents/）

tdd-coach.md - TDD 流程指导
code-reviewer.md - 代码审查
test-writer.md - 测试生成
architecture-reviewer.md - 架构审计

tdd-coach.md - TDD 流程指导
code-reviewer.md - 代码审查
test-writer.md - 测试生成
architecture-reviewer.md - 架构审计

五类能力概览

1. Discipline-Enforcing Skills（强制工作流）

强制执行的开发规范和流程。

testing-guide.md - TDD 流程和测试模式
architecture-guide.md - 架构规范
相关 Agents：TDD Coach, Code Reviewer

强制执行的开发规范和流程。

testing-guide.md - TDD 流程和测试模式
architecture-guide.md - 架构规范
相关 Agents：TDD Coach, Code Reviewer

2. Reference Skills（参考指南）

综合性的技术参考文档。

architecture-guide.md
testing-guide.md
packages-guide.md - 40+ 库的完整指南
commands-guide.md

综合性的技术参考文档。

architecture-guide.md
testing-guide.md
packages-guide.md - 40+ 库的完整指南
commands-guide.md

3. Diagnostic Skills（故障排除）

3. Diagnostic Skills（故障排查）

系统性的问题诊断和故障排除方法。

build-errors.md
runtime-errors.md
state-debugging.md
performance-profiler.md

系统性的问题诊断和故障排查方法。

build-errors.md
runtime-errors.md
state-debugging.md
performance-profiler.md

4. Commands（命令脚本）

快速自动化操作和脚手架工具。

```
scripts/generate_feature.py
```
```
scripts/generate_model.py
```
```
scripts/generate_bloc.py
```
```
scripts/generate_test.py
```

快速自动化操作和脚手架工具。

```
scripts/generate_feature.py
```
```
scripts/generate_model.py
```
```
scripts/generate_bloc.py
```
```
scripts/generate_test.py
```

5. Agents（智能助手）

自然语言触发的自动化助手。

TDD Coach - 指导 TDD 流程
Code Reviewer - 审查代码质量
Test Writer - 生成测试代码
Architecture Reviewer - 审计架构合规性

自然语言触发的自动化助手。

TDD Coach - 指导 TDD 流程
Code Reviewer - 审查代码质量
Test Writer - 生成测试代码
Architecture Reviewer - 审计架构合规性

使用示例

示例 1：创建用户认证功能（TDD 流程）

bash

undefined

bash

undefined

1. 生成结构

python scripts/generate_feature.py --feature-name auth python scripts/generate_model.py --model-name user --fields id:String,email:String,name:String

2. 请求 TDD Coach："请帮我用 TDD 实现用户登录功能"

→ 智能体扮演 TDD Coach 指导 Red/Green/Refactor 循环

3. 请求 Code Reviewer 审查代码

4. 生成代码

dart run build_runner build --delete-conflicting-outputs

undefined

dart run build_runner build --delete-conflicting-outputs

undefined

示例 2：诊断运行时错误

用户: "应用崩溃了，帮我诊断"

智能体:
1. 查阅 [runtime-errors.md](references/diagnostic/runtime-errors.md)
2. 分析错误信息和堆栈跟踪
3. 提供修复建议和预防措施

用户: "应用崩溃了，帮我诊断"

智能体:
1. 查阅 [runtime-errors.md](references/diagnostic/runtime-errors.md)
2. 分析错误信息和堆栈跟踪
3. 提供修复建议和预防措施

示例 3：代码审查

用户: "请审查这段代码"

智能体:
1. 触发 Code Reviewer Agent
2. 进行全面审查（架构、代码质量、安全性）
3. 提供问题列表和修复建议

用户: "请审查这段代码"

智能体:
1. 触发 Code Reviewer Agent
2. 进行全面审查（架构、代码质量、安全性）
3. 提供问题列表和修复建议

注意事项

Agent 优先：遇到复杂任务时优先触发对应的 Agent
渐进式加载：先读取核心指南，需要时再读取详细技能
场景映射：使用 SCENARIOS.md 快速定位资源
快速索引：使用 INDEX.md 查找特定主题
上下文保持：在同一会话中保持上下文，避免重复读取

Agent 优先：遇到复杂任务时优先触发对应的 Agent
渐进式加载：先读取核心指南，需要时再读取详细技能
场景映射：使用 SCENARIOS.md 快速定位资源
快速索引：使用 INDEX.md 查找特定主题
上下文保持：在同一会话中保持上下文，避免重复读取

技术栈版本

Flutter SDK: 3.x
Dart SDK: 3.x
关键库版本：见 packages-guide.md

Flutter SDK: 3.x
Dart SDK: 3.x
关键库版本：见 packages-guide.md

项目统计

总文档数: 26+
脚本工具: 4
智能助手: 4
详细技能文档: 11
详细命令文档: 9
诊断指南: 4
覆盖库数量: 40+

总文档数: 26+
脚本工具: 4
智能助手: 4
详细技能文档: 11
详细命令文档: 9
诊断指南: 4
覆盖库数量: 40+