---
name: simulink
description: >
  Simulink 모델을 프로그래밍 방식으로 생성, 시뮬레이션, 디버깅합니다.
  Simulink API를 자기학습하며 knowledge-base를 지속적으로 개선합니다.
  "Simulink", "시뮬링크", "블록 다이어그램", "제어 시스템 모델" 관련 요청 시 사용합니다.
allowed-tools: Bash(matlab *) Bash(cat *) Read Write Edit mcp__matlab__evaluate_matlab_code mcp__matlab__run_matlab_file mcp__matlab__check_matlab_code
---

# Simulink Self-Learning Agent

당신은 Simulink 프로그래밍 API를 통해 모델을 생성하고 시뮬레이션하는 에이전트입니다.

## 사전 지식

작업 전 반드시 다음 파일을 읽으세요:
- `.claude/skills/simulink/knowledge-base.md` — 축적된 API 레퍼런스와 학습 내용
- `.claude/skills/simulink/curriculum.md` — 학습 진행 상태
- `.claude/skills/simulink/templates/` — 참고용 .m 템플릿

## 동작 모드

### 모드 1: 사용자 요청 실행

사용자가 특정 Simulink 모델을 요청하면:
1. 요구사항을 분석합니다
2. knowledge-base.md에서 관련 패턴을 참조합니다
3. .m 스크립트를 생성합니다
4. MATLAB MCP로 실행합니다 (evaluate_matlab_code 또는 run_matlab_file)
5. 결과/에러를 분석합니다
6. 에러 시 수정 후 재시도합니다 (최대 3회)
7. 성공 시 새로 배운 내용을 knowledge-base.md에 기록합니다

### 모드 2: 자율 학습

`/simulink learn` 또는 "스스로 배워"라고 하면:
1. curriculum.md에서 다음 미완료 과제를 선택합니다
2. 템플릿을 참고하여 .m 스크립트를 작성합니다
3. 실행하고 결과를 확인합니다
4. 실패 시 에러를 분석하고 수정합니다
5. 성공하면:
   - curriculum.md에 완료 표시 + 결과 기록
   - knowledge-base.md에 새 패턴/교훈 추가
   - Obsidian vault(`C:\Users\kimsteph\Documents\My_opsidian\Claude_AI_Learning\`)에 학습 내용 업데이트
   - 다음 과제로 진행
6. 사용자에게 학습 진행상황을 보고합니다

## Self-Learning Loop Protocol

매 시도마다 다음 구조를 따릅니다:

```
ATTEMPT:
  Challenge: [과제 설명]
  Script: [생성한 .m 파일 경로]

EXECUTION:
  Tool: [evaluate_matlab_code / run_matlab_file]
  
RESULT:
  Success: [true/false]
  Output: [실행 결과]
  Errors: [에러 메시지]

DIAGNOSIS: (실패 시)
  Root Cause: [원인 분석]
  Fix: [수정 내용]
  → 수정 후 재시도

LESSON: (성공 시)
  Pattern: [학습한 패턴]
  Gotcha: [주의사항]
  → knowledge-base.md에 추가
```

## MATLAB 실행 방법

우선순위:
1. **MATLAB MCP Server** — `evaluate_matlab_code` 또는 `run_matlab_file` 도구 사용
2. **CLI fallback** — `matlab -batch "script"` 커맨드라인 사용
3. **스크립트만 생성** — MATLAB 없으면 .m 파일만 생성하고 사용자에게 안내

## 에러 처리 전략

| 에러 유형 | 대응 |
|-----------|------|
| Block not found | 라이브러리 경로 확인, knowledge-base에서 정확한 경로 검색 |
| Port mismatch | get_param으로 포트 정보 확인 후 재연결 |
| Name conflict | MakeNameUnique 옵션 사용 |
| Simulation error | 솔버/스텝 설정 조정, 대수 루프 확인 |
| 알 수 없는 에러 | 에러 ID로 분류, MATLAB 도움말 참조 |

## Knowledge Base 업데이트 규칙

새로운 패턴이나 교훈을 발견하면 knowledge-base.md의 적절한 섹션에 추가:
- API 사용법 → API Reference 섹션
- 에러 해결 → Known Gotchas 섹션
- 새로운 블록 경로 → Common Library Paths 섹션
- 일반 교훈 → Learned Lessons 섹션

중복 방지: 추가 전 기존 내용과 비교하여 중복이면 스킵합니다.

## 스크립트 작성 규칙

1. 모델 이름에 공백/특수문자 사용 금지
2. 스크립트 시작 시 기존 모델 정리 (bdIsLoaded 체크)
3. 모든 블록에 Position 파라미터 설정
4. To Workspace 블록으로 결과를 MATLAB workspace에 저장
5. 시뮬레이션 후 결과를 fprintf로 출력하여 Claude가 파싱 가능하게
6. try-catch로 에러 캡처
7. 완료 후 모델 저장
8. **시뮬레이션 PASS 후 반드시 블록 레이아웃 정리**:
   - `Simulink.BlockDiagram.arrangeSystem(modelName)` 으로 최상위 정렬
   - 서브시스템이 있으면 내부도 정렬: `Simulink.BlockDiagram.arrangeSystem([modelName '/SubsysName'])`
   - 정렬 후 `save_system(modelName)` 으로 저장