flutter-bloc-clean-architecture-skill
指导AI助手构建遵循BLoC状态管理和清晰分层架构的Flutter应用。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：flutter-bloc-clean-architecture-skill。 它的用途是：指导AI助手构建遵循BLoC状态管理和清晰分层架构的Flutter应用。 完整的 Skill 内容见：https://321skill.com/skills/flutter-bloc-clean-architecture-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我想添加一个用户个人资料页面，需要显示头像、昵称和邮箱，并能编辑昵称。”，它会依据此Skill的规则，自动为你生成对应的BLoC事件与状态、Repository接口、数据模型以及遵循设计主题的Widget文件结构，并确保各层职责分离。
介绍
此Skill旨在解决开发者在利用AI助手构建Flutter应用时，代码结构混乱、业务逻辑与UI耦合、状态管理不当以及设计不一致的痛点。它提供了一套明确的架构规则和模式，引导AI将应用清晰地划分为UI、BLoC、Repository、Datasource等层次，确保代码的可维护性和可测试性。
使用方式非常简单，开发者只需将此Skill安装到其AI编码助手（如Claude、Cursor）中。之后，当向AI发出构建Flutter应用功能的指令时，AI会依据Skill内定义的规则，自动生成符合BLoC和Clean Architecture原则的代码结构、文件组织和命名规范，而非随意堆砌代码。
它非常适合希望借助AI提升开发效率，但又担心生成代码质量不佳、难以维护的Flutter开发者，特别是那些正在或计划在项目中采用BLoC状态管理和分层架构的团队。对于初学者，它也是一个学习规范架构的优秀实践指南。
建议在项目初期或引入新功能模块时使用此Skill，以确保架构一致性。需要注意的是，它主要提供架构范式和代码组织规则，不包含具体的业务逻辑实现，因此开发者仍需对业务需求有清晰理解，并与AI进行有效交互。
核心特点
与一般Flutter代码生成指令不同，它严格强制了“UI → BLoC → Repository → Datasource”的清晰数据流和分层隔离，明确禁止在Widget中编写业务逻辑、使用硬编码颜色和魔法数字，并通过附带的完整示例提供了可直接参考的“功能优先”项目结构。
注意事项
不适合需要快速原型验证、或项目已采用其他状态管理方案（如Provider、Riverpod）且不打算重构的场景。
常见问题
这个Skill能帮我直接写业务代码吗？
不能，它主要提供架构规则和代码组织模式，引导AI生成结构良好的代码框架，具体业务逻辑仍需您定义。
必须使用BLoC吗？
是的，此Skill的核心是基于BLoC状态管理来构建Clean Architecture，不适用于其他状态管理库。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/flutter-bloc-clean-architecture-skill/raw/index.md 读取 flutter-bloc-clean-architecture-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/flutter-bloc-clean-architecture-skill/raw/index.md（查看排版版本）