mcpField
F
flutter-engineering

flutter-engineering

github.com/heyeddi-com开发096 次安装1 天前更新
代码仓库

关于 flutter-engineering

flutter-engineering 是面向 HeyEddi 应用开发的工程技能，可审查并补齐 Flutter、FastAPI 和 Firebase 项目的脚手架。它通过分层审计、构建、测试和变更检查组织开发流程。

主要功能

  1. 01识别 Flutter、FastAPI 与 Firebase 技术栈
  2. 02审计并补齐项目脚手架
  3. 03提供本地开发服务器流程
  4. 04运行前端与后端测试及构建验证
  5. 05设置计划与变更检查关卡

适用场景

  1. 01为移动端或 Web 前端搭建 Flutter 项目
  2. 02为 REST API 配置 FastAPI 后端
  3. 03为 Firestore 或 Auth 配置 Firebase
  4. 04按检查流程验证功能变更

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/heyeddi-com/heyeddi-skills --skill flutter-engineering

安装后在 Claude Code 中输入/flutter-engineering确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

manifest.json
context/
ANTI_PATTERNS.md
EXAMPLES.md
PROSE_ANTI_SLOP.md
VOCABULARY.md
reference/
design-handoff.md
dev-server.md
fastapi-client.md
firebase-client.md
subagents.md
scaffold/
stack-flutter-fastapi.json
stack-flutter-full.json
stack-flutter.json
scaffold/flutter/
analysis_options.yaml
pubspec.yaml
scaffold/flutter/lib/
app.dart
main.dart
scaffold/flutter/lib/config/
env.dart
scaffold/flutter/lib/router/
app_router.dart
scaffold/flutter/lib/screens/
home_screen.dart
settings_screen.dart
scaffold/flutter/lib/services/
api_client.dart
scaffold/flutter/lib/theme/
app_theme.dart
scaffold/flutter/lib/widgets/
app_shell.dart
scaffold/flutter/test/
widget_test.dart
scripts/
_heyeddi_paths.py
_project_detect.py
_skill_cli.py
audit_scaffold.py
dev_server_info.py

详细介绍

Flutter 工程开发

适用于 HeyEddi 应用的基础 Flutter 工程开发。检测适用的技术栈并添加相应工具：Vue 项目应改用 @project-engineering。

子 Agent（默认）

将脚手架搭建、审计和测试脚本委派给 Task shell；将仓库探索委派给 explore。主聊天根据审计 JSON 选择技术栈。参见 reference/subagents.md。

技术栈

技术栈适用场景添加的工具
Flutter移动端 / Web 前端pubspec.yaml、Riverpod、go_router、Material 3、widget 测试
FastAPIREST API 后端backend/、pytest、openapi.json、运行于 8090 的 uvicorn
FirebaseFirestore / Authfirebase.json、规则、模拟器

在 .heyeddi/stack.json 中声明意图：

{
  "frontend": "flutter",
  "backends": ["fastapi"],
  "web_port": 8085,
  "api_port": 8090
}

或者使用 "backends": ["firebase"] 或 ["fastapi", "firebase"]。

工作流

  1. 偏好设置门禁（始终启用的硬性要求）： 在假设 git / CI / 提交状态前，运行 @heyeddi-setup verify_setup --check；若未完成 → 运行设置流程，直至通过。
  2. audit_scaffold：按层生成 JSON（flutter / fastapi / firebase）。
  3. scaffold_stack --stack auto：补齐缺项（flutter、fastapi、firebase 或 full）。
  4. 按需运行 ensure_flutter 和 ensure_python（通过 @project-engineering）。
  5. dev_server_info：Flutter Web :8085、API :8090、Firebase 模拟器 :4000。
  6. 计划门禁（始终启用）： 在编写功能代码前运行 @engineering-excellence check_engineering_plan --check。
  7. 实现功能（@design-handoff-flutter、@flutter-patterns、@dart-type-bridger）。
  8. run_tests + run_backend_tests + verify_build。
  9. 变更门禁（始终启用）： audit_engineering --check（错误会导致失败；警告仅供参考）。

本地开发服务器

技术栈命令URL
Flutter Webflutter run -d web-server --web-port=8085 --web-hostname=127.0.0.1http://127.0.0.1:8085
Flutter 移动端flutter run设备 / 模拟器
FastAPIcd backend && poetry run uvicorn app.main:app --reload --port 8090http://127.0.0.1:8090/docs
Firebasefirebase emulators:starthttp://localhost:4000

在审计 Flutter Web 时，为 @visual-auditor 设置 FLUTTER_WEB_URL（或 DEV_SERVER_URL）。

参考资料

  • reference/dev-server.md：Flutter Web + 移动端
  • reference/fastapi-client.md：Dio + OpenAPI 类型
  • reference/firebase-client.md：firebase_core + Firestore
  • reference/heyeddi-handoff.md：串联 @design-handoff-flutter

相关技能

  • @dart-type-bridger：OpenAPI / Firestore → Dart 模型
  • @flutter-patterns：仓库、Riverpod providers、身份验证
  • @design-handoff-flutter：截图 → Material widgets
  • @project-engineering：共享的 FastAPI/Firebase 脚手架（由 scaffold_stack 调用）

任务完成后：建议后续技能

完成此技能的用户请求后（而非每次工具调用或子 Agent 阶段结束后），建议接下来运行：

  1. 运行：

    python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill flutter-engineering --project-root .

    如果处理的是特定路由，请添加 --route /path。

  2. 在最终回复中包含脚本的 ### Next step 部分。用户可将其中的 Prompt 行复制到聊天中（例如 @heyeddi-design craft /settings）。

如果知道刚完成的是哪个子命令，请传入 --mode shape（或 craft、audit 等）。

参见 @heyeddi → reference/next-skill-handoff.md。

评论

支持 Markdown