Motion Retrospective
완성된 모든 작품은 에이전트를 더 나은 상태로 남겨야 합니다. 렌더링이 확인되면, 증거가 런타임에 남아 있는 동안 (처리된 명령은 7일 후 제거됨) 전체 빌드를 검토하고 다음 세션이 재사용할 수 있는 지식으로 전환합니다.
트리거
사용자가 최종 렌더링/내보내기를 확인하는 동일한 턴에 이 스킬을 시작하세요. 예를 들어: "렌더링 됐어요 / 내보냈어요 / 이 버전으로 / ship it / looks good, exporting". 브릿지는 또한 모든 렌더링 명령의 결과에 bridgeHealth.retrospective를 알림으로 추가합니다. 다시 요청받기 전에 실행하세요.
단계
-
수집. 세션이 시작된 시간을 기록한 후, 다음 명령을 실행하세요:
python3 tools/retrospective.py --slug <작품명> --since <세션 시작 시간 또는 예: 6h> [--match "<메인 컴포지션 이름>"]이 명령은
cases/_inbox/<날짜>-<slug>/디렉토리에TIMELINE.md,FAILURES.md,scripts/(성공한 모든 변형 스크립트, 중복 제거됨),stats.json을 생성합니다. -
증거 수집. 최종 렌더링에서 4~6프레임을 캡처(
captureFrame또는tools/run_capture.sh사용)하고tools/sheet.py로 연락처 시트를 만드세요.evidence/에 저장하세요. 비디오,.aep, 클라이언트 영상 또는 폰트는 절대 커밋하지 마세요. -
타임라인 검토. 각 명령어 실행에 대해 다음을 기록하세요:
- 사용자가 요청한 내용 (대화 내용에서), 변경된 사항, 그리고 이를 수행한 스크립트
- 메커니즘 (외형뿐만 아니라; 리그 구조, 표현식, 키 값, 레이어 순서)
- 작동하게 만든 숫자들 (지속 시간, 이징 영향도, 오프셋, 크기)
FAILURES.md의 모든 실패: 원인과 해결 방법.
-
레시피로 분할. 한 작품은 보통 여러 재사용 가능한 기법을 포함합니다. 각 기법에 대해
cases/<카테고리>/<기법>/폴더를 생성하세요 (카테고리: text-animation, shape-animation, ui-animation, transitions, effects). 각 폴더에는RECIPE.md, 정리된 재사용 가능한.jsx파일,PROMPT_TEMPLATE.md, 증거 자료를 포함하세요.cases/projects/<작품>/RECIPE.md에 이들을 연결하는 프로젝트 인덱스를 유지하세요 (예:sync-dubbing-studio). 프로젝트별 레이어 이름은 전이 가능한 방법과 분리하세요. -
규칙 승격. 이 작품을 넘어 적용될 수 있는 모든 내용을
skill/SKILL.md에 복사하세요: 새로운 함정 (坑位速查), 새로운 사용자 피드백 번역 (反馈翻译表), 레시피 인덱스.LEARNING_MAP.md에서 항목을 체크하거나 추가하세요.README.md/README.zh-CN.md의 사례 개수와 프로젝트 테이블을 변경 시 업데이트하세요. -
게시.
tools/publish_case.sh cases/<카테고리>/<기법> "배운 점" --push이 스크립트는
/Users/<이름>/경로를 정리하고, 비디오/오디오/.aep 파일을 거부하며,tools/health_check.py를 실행하고, 커밋 및 푸시합니다. 저장소 소유자가 동의한 경우에만 자동으로 푸시합니다 (MOTION_AGENT_AUTO_PUBLISH=1, 또는 요청한 경우). 그렇지 않으면 커밋하고 물어보세요. -
보고 사용자에게 몇 줄로: 추가된 레시피 수, 승격된 규칙, 커밋 링크를 알려주세요.
품질 기준
- 레시피는 메커니즘을 명명하고 다른 사람이 재현할 수 있는 숫자를 제공해야 합니다.
- 모든 함정은 무엇이 고장 났는지, 그 이유, 해결 방법을 설명해야 합니다.
- 공개 저장소에 클라이언트 자산, 개인 경로, 미공개 자료가 없어야 합니다.
- 작품이 새로운 것을 가르쳐주지 않았다면, 그렇게 말하고 기존 사례에 증거만 추가하세요.