Flutter Skills

任务目标

• 本 Skill 用于：提供现代 Flutter 开发的完整指南，涵盖架构设计、测试流程、故障排除和代码生成

• 能力包含：Clean Architecture 规范、TDD 工作流、BLoC 状态管理、故障诊断、代码生成脚本、智能助手

• 触发条件：用户询问 Flutter 架构设计、TDD 测试、状态管理、项目结构、代码生成、故障排除或第三方库选型

前置准备

• 依赖说明：无额外依赖

• 项目环境：Flutter SDK 3.x、Dart SDK 3.x

快速导航

📚 文档索引

• 快速查找：INDEX.md - 所有资源的快速索引

• 场景映射：SCENARIOS.md - 用户意图到资源的映射

🤖 智能助手触发

触发方式 Agent

"请帮我用 TDD 实现" TDD Coach

"请审查这段代码" Code Reviewer

"编写测试" Test Writer

"审查架构" Architecture Reviewer

操作步骤

标准流程

架构设计与规划

• 阅读 architecture-guide.md

• 使用 INDEX.md 快速查找相关资源

功能模块生成（脚本）

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/

资源索引

脚本工具（scripts/）

脚本 功能

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 命令参考

详细技能文档（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

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

• 代码生成：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 - 性能分析

智能助手（references/agents/）

• 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

2. Reference Skills（参考指南）

综合性的技术参考文档。

• architecture-guide.md

• testing-guide.md

• packages-guide.md - 40+ 库的完整指南

• commands-guide.md

3. Diagnostic Skills（故障排除）

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

• 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

5. Agents（智能助手）

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

• TDD Coach - 指导 TDD 流程

• Code Reviewer - 审查代码质量

• Test Writer - 生成测试代码

• Architecture Reviewer - 审计架构合规性

使用示例

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

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

示例 2：诊断运行时错误

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

智能体:

1. 查阅 runtime-errors.md
2. 分析错误信息和堆栈跟踪
3. 提供修复建议和预防措施

示例 3：代码审查

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

智能体:

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

注意事项

• Agent 优先：遇到复杂任务时优先触发对应的 Agent

• 渐进式加载：先读取核心指南，需要时再读取详细技能

• 场景映射：使用 SCENARIOS.md 快速定位资源

• 快速索引：使用 INDEX.md 查找特定主题

• 上下文保持：在同一会话中保持上下文，避免重复读取

技术栈版本

• Flutter SDK: 3.x

• Dart SDK: 3.x

• 关键库版本：见 packages-guide.md

项目统计

• 总文档数: 26+

• 脚本工具: 4

• 智能助手: 4

• 详细技能文档: 11

• 详细命令文档: 9

• 诊断指南: 4

• 覆盖库数量: 40+