LogoSkills

/cc-inspector:bloc — 화면 상태 들여다보기

실행 중인 앱의 BLoC/Cubit 목록과 각각의 현재 상태값·상태 변경 이력·이벤트 이력을 꺼내 보여줍니다 — 화면은 그대로인데 상태가 왜 안 바뀌는지 추적할 때.

/cc-inspector:bloc — 화면 상태 들여다보기#

항목내용
실행 명령/cc-inspector:bloc
분류개발
난이도●○○ 간단
MCP 서버flutter-inspector

한마디로#

앱이 지금 화면 안에서 "어떤 상태"인지(예: 로그인됨, 장바구니 비어 있음)를 실시간으로 들여다보는 돋보기입니다. 자동차 계기판처럼, 겉으로 보이는 화면 뒤에서 무슨 값이 켜지고 꺼졌는지 그대로 보여줍니다.

누가·언제 쓰나요#

  • 개발자나 QA 담당자가 앱이 실제로 돌아가는 중에 화면 동작을 점검할 때 사용합니다.
  • 특히 이런 상황에서 씁니다:
    • 버튼을 눌렀는데 화면이 바뀌지 않을 때 (상태가 안 바뀜)
    • 예상과 다른 화면이 떠 있을 때 (이상한 상태)
    • 화면이 깜빡이거나 불필요하게 자꾸 다시 그려질 때

무엇을 해주나요#

앱 안에서 화면 상태를 관리하는 부품(BLoC/Cubit)들의 현재 상태를 꺼내서 보여줍니다.

  • 지금 살아 있는 화면 상태 부품 목록 (예: AuthBloc, HomeBloc, CartCubit)
  • 특정 부품의 현재 상태 값 (예: "로딩 완료, 아이템 15개")
  • 상태가 어떻게 바뀌어 왔는지 변경 이력
  • 어떤 동작(이벤트)들이 일어났는지 이벤트 이력

어떻게 쓰나요#

# 지금 살아 있는 화면 상태 부품 목록 보기
/inspector/bloc list

# 특정 부품(HomeBloc)의 현재 상태 보기
/inspector/bloc state HomeBloc

# 특정 부품(AuthBloc)에서 일어난 동작(이벤트) 이력 보기
/inspector/bloc events AuthBloc

list는 전체 목록, state는 특정 부품의 현재 값, events는 그 부품에 어떤 일이 있었는지를 보여줍니다.

안에서 무슨 일이 벌어지나요#

문제 유형별로 정해진 순서대로 점검합니다.

  • 화면이 안 바뀔 때: 부품이 실제로 있는지 → 동작이 발생했는지 → 상태가 바뀌었는지 순서로 따라가며 어디서 막혔는지 찾습니다.
  • 이상한 화면일 때: 현재 상태 값을 확인하고, 어떻게 그 상태까지 왔는지 변경 과정을 되짚어 봅니다.
  • 화면이 자꾸 다시 그려질 때: 동작이 너무 자주 일어나는지 점검하고, 다시 그리는 조건이 올바른지 살펴봅니다.

⚙️ 상세 옵션·실행 명세 (개발자 / AI 에이전트용)

Triggers#

  • State change tracking
  • BLoC event debugging
  • State inconsistency issues

MCP Tools#

bloc_list_active#

Returns a list of currently active BLoC/Cubit instances.

Response example:

{
   " blocs " : [
    { " type " :  " AuthBloc " ,  " state " :  " Authenticated " },
    { " type " :  " HomeBloc " ,  " state " :  " Loaded " },
    { " type " :  " CartCubit " ,  " state " :  " Empty " }
  ]
}

bloc_get_state#

Returns the current state of a specific BLoC.

Response example:

{
   " type " :  " HomeBloc " ,
   " state " : {
     " status " :  " loaded " ,
     " items " : 15,
     " selectedCategory " :  " all " 
   }
}

bloc_get_history#

Returns the state change history of a BLoC.

bloc_get_events#

Returns the event history.

Common Diagnostics#

State not updating#

1. bloc_list_active - >   Confirm BLoC exists
2. bloc_get_events - >   Confirm event was fired
3. bloc_get_history - >   Track state changes

Unexpected state#

1. bloc_get_state - >   Check current state
2. bloc_get_history - >   Track change process
3. Review event handler logic

Excessive BLoC rebuilds#

1. bloc_get_events - >   Check event frequency
2. Review buildWhen conditions
3. Check state comparison logic

Examples#

Check active BLoC list#

/inspector/bloc list

Check specific BLoC state#

/inspector/bloc state HomeBloc

Check event history#

/inspector/bloc events AuthBloc

References#

  • Detailed implementation: .claude/agents/flutter-inspector-bloc.md
  • Master inspector: .claude/commands/inspector.md