원클릭으로 Manus에서 모든 스킬 실행

integration-test-skill

스타2

포크0

업데이트2026년 5월 25일 20:59

Use when: adding or extending Flutter integration/E2E tests for Beacon with fake backend, ProviderScope overrides, and reusable test robots.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

Minhduc7904

Minhduc7904/Beacon

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

Skill: Integration Test cho Beacon Flutter

Mục tiêu

Viết integration test deterministic cho các flow nhiều màn hình của Beacon mà không gọi API/realtime/notification/storage thật, trừ khi task yêu cầu test environment riêng.

Khi dùng

Thêm flow integration_test/.
Verify auth/session/routing guard/splash bootstrap.
Thêm smoke regression trước release.
Mở rộng flow forgot password, refresh token, notification, safety setting, check-in.

Context bắt buộc

.agents/copilot-instructions.md
.agents/instructions/project-context.md
.agents/instructions/architecture-rules.md
docs/integration-tests.md
lib/core/providers/providers.dart
lib/core/config/app_routes.dart
lib/core/config/app_router.dart
Flow/page/controller liên quan trong lib/features/<feature>/

Nếu GitNexus index stale, chạy npx gitnexus analyze trước. Trước khi sửa production symbol, chạy impact analysis theo AGENTS.md.

Cấu trúc chuẩn

integration_test/
  <feature>/
    <flow>_test.dart
  config/
  fakes/
  helpers/
  robots/

Không tạo cây thư mục rỗng. Chỉ tạo file/folder khi flow cần.

Nguyên tắc fake/mock

Fake tại boundary: repository, datasource, realtime service, notification service, local storage.
Không fake page/widget nội bộ nếu flow đang verify UI thật.
Fake có state khi cần test nhiều bước liên tiếp, ví dụ register tạo account rồi login account đó.
Test data đặt trong integration_test/config/.
Nếu dùng backend test thật, phải có env riêng, seed/cleanup deterministic, và không dùng production account.

Robot convention

Mỗi flow nhiều bước nên có robot trong integration_test/robots/.
Robot chứa các thao tác người dùng: open screen, enter form, submit, wait/assert navigation.
Test file chỉ nên đọc như kịch bản nghiệp vụ.
Tránh pumpAndSettle() trên màn có timer/animation lặp lại. Dùng pumpUntilFound, pumpUntilTextFieldCount, hoặc helper có timeout rõ ràng.
Khi finder bằng text dễ vỡ do encoding/copy, ưu tiên helper gom candidate labels; nếu production đã có key ổn định thì ưu tiên key.

App harness convention

Pump MyApp thật trong ProviderScope.
Override provider boundary trong helper, không override từng widget.
Tắt dev UI bằng dotenv.testLoad(fileInput: 'APP_ENV=production\n').
Dùng SharedPreferences.setMockInitialValues({}) cho mỗi test.
Không gọi main() trong integration test; tự khởi tạo dependency cần thiết trong harness.

Verify bắt buộc

flutter analyze integration_test
flutter test --no-pub integration_test\<feature>\<flow>_test.dart -r expanded
flutter test nếu thay đổi có nguy cơ ảnh hưởng unit/widget test hiện có
gitnexus_detect_changes(scope: "all") trước commit

Done khi

Flow test đọc được như hành vi người dùng.
Fake backend không gọi network/realtime/notification thật.
Test có data/config riêng, không hard-code rải rác.
Docs hoặc skill được cập nhật nếu thêm convention mới.

이 저장소의 다른 Skills

같은 저장소

taste-skill-loader

Minhduc7904/Beacon

Use when: any task involves Flutter UI, UX, animation, motion, redesign, image-to-code, or mobile visual implementation quality.

2026-06-012

local-database-skill

Minhduc7904/Beacon

Use when: planning or implementing Flutter local database, cache, offline-read, local datasources, repository cache orchestration, stale data handling, and deterministic tests.

2026-06-012

test-strategy-skill

Minhduc7904/Beacon

Use when: selecting Flutter test levels, planning unit/widget/integration coverage, and creating verification checklists for risky or cross-layer changes.

2026-05-252

context-engineering-skill

Minhduc7904/Beacon

Use when: starting a task and loading Beacon source-of-truth context before writing code.

2026-05-182

documentation-adr-skill

Minhduc7904/Beacon

Use when: documenting architecture decisions, tradeoffs, impacts, and rollback guidance after important changes.

2026-05-182

api-integration-skill

Minhduc7904/Beacon

Use when: integrating or modifying backend APIs, endpoint contracts, request/response mapping, and business error-code handling in Beacon.

2026-05-182

name	integration-test-skill
description	Use when: adding or extending Flutter integration/E2E tests for Beacon with fake backend, ProviderScope overrides, and reusable test robots.

Skill: Integration Test cho Beacon Flutter

Mục tiêu

Viết integration test deterministic cho các flow nhiều màn hình của Beacon mà không gọi API/realtime/notification/storage thật, trừ khi task yêu cầu test environment riêng.

Khi dùng

Thêm flow integration_test/.
Verify auth/session/routing guard/splash bootstrap.
Thêm smoke regression trước release.
Mở rộng flow forgot password, refresh token, notification, safety setting, check-in.

Context bắt buộc

.agents/copilot-instructions.md
.agents/instructions/project-context.md
.agents/instructions/architecture-rules.md
docs/integration-tests.md
lib/core/providers/providers.dart
lib/core/config/app_routes.dart
lib/core/config/app_router.dart
Flow/page/controller liên quan trong lib/features/<feature>/

Nếu GitNexus index stale, chạy npx gitnexus analyze trước. Trước khi sửa production symbol, chạy impact analysis theo AGENTS.md.

Cấu trúc chuẩn

integration_test/
  <feature>/
    <flow>_test.dart
  config/
  fakes/
  helpers/
  robots/

Không tạo cây thư mục rỗng. Chỉ tạo file/folder khi flow cần.

Nguyên tắc fake/mock

Fake tại boundary: repository, datasource, realtime service, notification service, local storage.
Không fake page/widget nội bộ nếu flow đang verify UI thật.
Fake có state khi cần test nhiều bước liên tiếp, ví dụ register tạo account rồi login account đó.
Test data đặt trong integration_test/config/.
Nếu dùng backend test thật, phải có env riêng, seed/cleanup deterministic, và không dùng production account.

Robot convention

Mỗi flow nhiều bước nên có robot trong integration_test/robots/.
Robot chứa các thao tác người dùng: open screen, enter form, submit, wait/assert navigation.
Test file chỉ nên đọc như kịch bản nghiệp vụ.
Tránh pumpAndSettle() trên màn có timer/animation lặp lại. Dùng pumpUntilFound, pumpUntilTextFieldCount, hoặc helper có timeout rõ ràng.
Khi finder bằng text dễ vỡ do encoding/copy, ưu tiên helper gom candidate labels; nếu production đã có key ổn định thì ưu tiên key.

App harness convention

Pump MyApp thật trong ProviderScope.
Override provider boundary trong helper, không override từng widget.
Tắt dev UI bằng dotenv.testLoad(fileInput: 'APP_ENV=production\n').
Dùng SharedPreferences.setMockInitialValues({}) cho mỗi test.
Không gọi main() trong integration test; tự khởi tạo dependency cần thiết trong harness.

Verify bắt buộc

flutter analyze integration_test
flutter test --no-pub integration_test\<feature>\<flow>_test.dart -r expanded
flutter test nếu thay đổi có nguy cơ ảnh hưởng unit/widget test hiện có
gitnexus_detect_changes(scope: "all") trước commit

Done khi

Flow test đọc được như hành vi người dùng.
Fake backend không gọi network/realtime/notification thật.
Test có data/config riêng, không hard-code rải rác.
Docs hoặc skill được cập nhật nếu thêm convention mới.