morning-start 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.pyscripts/generate_model.pyscripts/generate_bloc.pyscripts/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](references/diagnostic/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+