메뉴
Health Trainer의 rule/tracker 단위 테스트에서 목표 각도의 합성 PoseFrame을 손쉽게 만드는 방법 — 검증된 공유 헬퍼 com.healthtrainer.core.testutil.SyntheticPose. 스쿼트/푸쉬업/플랭크 rule 테스트나 rep/set tracker 테스트를 새로 작성·수정할 때, "무릎 각도 90도인 프레임", "팔꿈치 ~170도", "깊이 부족 회차" 같은 합성 입력이 필요할 때 반드시 사용. 좌표를 손으로 계산하지 말 것.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | pose-test-fixtures |
| description | Health Trainer의 rule/tracker 단위 테스트에서 목표 각도의 합성 PoseFrame을 손쉽게 만드는 방법 — 검증된 공유 헬퍼 com.healthtrainer.core.testutil.SyntheticPose. 스쿼트/푸쉬업/플랭크 rule 테스트나 rep/set tracker 테스트를 새로 작성·수정할 때, "무릎 각도 90도인 프레임", "팔꿈치 ~170도", "깊이 부족 회차" 같은 합성 입력이 필요할 때 반드시 사용. 좌표를 손으로 계산하지 말 것. |
rule/tracker 테스트는 "특정 관절 각도"를 가진 PoseFrame이 필요하다(예: 무릎 90°, 팔꿈치 170°). 좌표를 손으로 계산해 각도를 맞추는 것은 반복적이고 오류가 잦다(이 프로젝트의 초기 rule 테스트들이 각자 그렇게 했고 매번 수치 검증을 해야 했다). 대신 검증된 공유 헬퍼를 쓴다.
core/src/test/kotlin/com/healthtrainer/core/testutil/SyntheticPose.kt
(자기 검증 테스트: 같은 폴더 SyntheticPoseTest.kt가 각도/길이/visibility 정확성을 고정한다.)
SyntheticPose.pointForAngle(a, b, degrees, length = 1f): Point3 — 각 A-B-C(꼭짓점 B)가 정확히 degrees가 되도록 점 C를 z=0 평면에 배치한다. 즉 AngleCalculator.angleDegrees(a, b, c) ≈ degrees(구성상 보장).SyntheticPose.frame(timestampMs, vararg name to Point3, visibility = 0.9f): PoseFrame — 프레임 조립. visibility를 0.55 미만으로 주면 저신뢰 경로를 테스트할 수 있다.SyntheticPose.lm(name, x, y, visibility) — 단일 랜드마크.무릎 각도 90°인 스쿼트 BOTTOM 프레임:
import com.healthtrainer.core.testutil.SyntheticPose
import com.healthtrainer.core.geometry.Point3
import com.healthtrainer.core.pose.LandmarkName.*
val hip = Point3(0f, 2f, 0f)
val knee = Point3(0f, 1f, 0f)
val ankle = SyntheticPose.pointForAngle(a = hip, b = knee, degrees = 90f) // 무릎 각도 = 90°
val frame = SyntheticPose.frame(
timestampMs = 0L,
LEFT_HIP to hip, RIGHT_HIP to hip,
LEFT_KNEE to knee, RIGHT_KNEE to knee,
LEFT_ANKLE to ankle, RIGHT_ANKLE to ankle,
// 스쿼트 torso 평가용 어깨도 필요하면 추가
)
얕은(깊이 부족) 회차는 degrees = 130f처럼 BOTTOM 밴드(70~110) 밖이지만 깊이 실패(>120)에 해당하는 값을 주면 된다. 저신뢰 프레임은 visibility = 0.3f.
pointForAngle로 만든다. 의도("90°를 원함")가 테스트에 그대로 드러나고, 수치 재검증이 불필요하다.SyntheticPoseTest로 재검증한다([core-build-test] 스킬의 core-test.sh).Health Trainer를 MVP 슬라이스 단위로 체계적으로 구현하는 오케스트레이터. main에서 슬라이스별 브랜치/워크트리를 만들고, 슬라이스마다 설계→TDD구현/골격→검증→리뷰→머지 파이프라인으로 진행한다. Health Trainer 기능 구현·MVP 진행·새 슬라이스 추가·이전 슬라이스 보완·재실행·워크트리 작업을 요청하면 사용. 단순 질문은 직접 응답.
이 프로젝트에서 실수·교정·발견을 docs/LESSONS.md에 기록하고, 그 교훈을 하네스(에이전트·스킬·CLAUDE.md)·규약·코드에 되먹여 같은 실수가 재발하지 않게 하는 실천. 버그를 고쳤거나, 사용자에게 교정받았거나, "이렇게 했어야 했다"는 깨달음이 생겼거나, 구조의 모순·개선점을 발견했을 때 반드시 사용. "교훈 기록", "lesson", "compound", "하네스 개선/업데이트" 상황에 사용.
Health Trainer를 빌드·테스트하는 운영 스킬 — system gradle이 없을 때 Gradle wrapper 부트스트랩, :core 단위 테스트 실행 + JUnit XML에서 정확한 통과/실패 수 집계 + :core 순수성(Android import 금지) 검사. Health Trainer에서 "테스트 돌려줘", ":core 빌드", "테스트 몇 개 통과", "gradle이 없다/안 된다", "빌드 환경 설정", 또는 변경 후 검증이 필요할 때 사용. 번들된 scripts/를 우선 쓴다.
Health Trainer의 운동별 정자세 rule engine을 작성·확장하는 도메인 지식 — ExerciseRule 인터페이스 계약, MovementPhase/FeedbackCode 의미, 스쿼트/푸쉬업/플랭크 자세 기준 임계값, rep state machine이 phase를 소비하는 방식. 새 운동 rule을 추가하거나 자세 판정 기준·임계값을 작성·튜닝할 때 반드시 참조.
Health Trainer 프로젝트의 코드 규약 — :core/:app 모듈 구조, 패키지 네이밍(com.healthtrainer.*), 랜드마크 데이터 모델(LandmarkName/PoseLandmark/PoseFrame/Point3), :core 순수성 규칙, Gradle 멀티모듈 + Android SDK 조건부 include 설정, JUnit4+Truth 테스트 패턴. Health Trainer의 Kotlin 코드를 작성·수정·리뷰하거나 모듈 구조·패키지·테스트 위치를 결정할 때 반드시 참조.