/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 changesUnexpected state#
1. bloc_get_state - > Check current state
2. bloc_get_history - > Track change process
3. Review event handler logicExcessive BLoC rebuilds#
1. bloc_get_events - > Check event frequency
2. Review buildWhen conditions
3. Check state comparison logicExamples#
Check active BLoC list#
/inspector/bloc listCheck specific BLoC state#
/inspector/bloc state HomeBlocCheck event history#
/inspector/bloc events AuthBlocReferences#
- Detailed implementation:
.claude/agents/flutter-inspector-bloc.md - Master inspector:
.claude/commands/inspector.md