القائمة
Commits code changes with automated CHANGELOG and design document updates. Runs build/lint verification before commit. Use after completing a feature, bug fix, or refactoring.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Generates numbered SQL migration files for tables, indexes, and views. Use when adding or modifying database schema.
Crawls exchange API documentation and generates structured markdown specs. Use when integrating a new exchange or updating API specifications.
Systematically diagnoses build, runtime, DB, API, and frontend errors with classification and fix workflow. Use when encountering errors or test failures.
Scaffolds a new API endpoint with router, handler, OpenAPI docs, and TS bindings. Use when adding REST endpoints to trader-api.
Scaffolds a new exchange connector with connector, provider, and trait implementations. Use when integrating a new exchange.
Adds a new trading strategy across 5 locations (mod.rs, routes, backtest, SDUI schema, frontend). Use when implementing a new strategy.
| name | shipping-code |
| description | Commits code changes with automated CHANGELOG and design document updates. Runs build/lint verification before commit. Use after completing a feature, bug fix, or refactoring. |
| disable-model-invocation | true |
| user-invocable | true |
| argument-hint | [커밋 메시지] [--dry-run | --docs-only] |
| allowed-tools | Bash(git *), Bash(cargo *), Bash(npx *), Read, Grep, Edit, Write |
| context | fork |
$ARGUMENTS 가 비어있으면 → 전체 워크플로우 실행$ARGUMENTS에 --dry-run 포함 → 문서 업데이트 + 커밋 메시지 미리보기만 (실제 커밋/푸시 안함)$ARGUMENTS에 --docs-only 포함 → CHANGELOG/설계 문서만 업데이트 (커밋/푸시 수동)1. 변경사항 분석 → 2. CHANGELOG → 3. 설계 문서 갱신 → 4. 빌드/린트 검증 → 5. 커밋 메시지 확인 → 6. 커밋 (푸시는 명시 요청 시에만)
다음 명령어를 병렬 실행하여 현재 상태를 파악합니다:
git status
git diff --cached --stat
git diff --cached --name-only
git log --oneline -5
변경 파일을 다음 카테고리로 분류합니다:
| 카테고리 | 경로 패턴 | CHANGELOG 섹션 |
|---|---|---|
| API 서버 | crates/trader-api/ | Added/Changed/Performance |
| Collector | crates/trader-collector/ | Performance/Changed |
| Core/전략 | crates/trader-core/, crates/trader-strategy/ | Added/Changed |
| 프론트엔드 | frontend/ | Added/Changed |
| CLI | crates/trader-cli/ | Added/Changed |
| 마이그레이션 | migrations/, migrations_v2/ | Added (DB) |
| 문서 | docs/, CLAUDE.md | (CHANGELOG에 미포함) |
| 변경 유형 | 버전 증가 |
|---|---|
| Breaking API 변경 | Major (x.0.0) |
| 새 기능, 대규모 개선 | Minor (0.x.0) |
| 버그 수정, 성능 개선, 문서 | Patch (0.0.x) |
형식: Keep a Changelog 기반
## [x.y.z] - YYYY-MM-DD
> **한 줄 요약**: 이번 릴리즈의 핵심 내용
### Performance (성능 개선이 있는 경우)
- 변경 내용
### Added (새 기능)
- 변경 내용
### Changed (기존 기능 변경)
- 변경 내용
### Fixed (버그 수정)
- 변경 내용
### Removed (제거된 기능)
- 변경 내용
backtick으로 표시(global_score.rs))다음 문서들을 순서대로 확인하고 필요시 갱신합니다:
| 항목 | 위치 | 갱신 조건 |
|---|---|---|
| 버전 | 헤더 > v0.x.y | 항상 |
| 마이그레이션 수 | 프로젝트 개요 테이블 | 마이그레이션 추가 시 |
| 프로젝트 구조 | 프로젝트 구조 섹션 | 새 crate/디렉토리 추가 시 |
| Crate 수, API 라우트 수 | 프로젝트 개요 수치 | 변경 시 |
| 항목 | 갱신 조건 |
|---|---|
| 버전 헤더 | 항상 (버전 + 주요 변경 설명) |
| 시스템 구성도 | 새 컴포넌트 추가 시 |
| 기술 스택 테이블 | 의존성 변경 시 |
| 크레이트 설명 | 크레이트 기능 변경 시 |
| 항목 | 갱신 조건 |
|---|---|
| 통합 그룹 테이블 | 새 마이그레이션 그룹 변경 시 |
| 검출 항목 | 새 검증 규칙 추가 시 |
| 항목 | 갱신 조건 |
|---|---|
| 완료 항목 | 구현 완료된 작업을 ✅ 처리 |
| 버전 정보 | 항상 |
마이그레이션 파일이 추가/변경된 경우:
trader migrate verify
trader migrate consolidate --output migrations_v2
trader migrate verify --dir migrations_v2
변경된 코드 종류에 따라 검증을 수행합니다:
# 1. 포맷 검사
cargo fmt --all -- --check
# 실패 시 → cargo fmt --all 실행 후 재스테이지
# 2. Clippy 검사 (경고를 에러로 처리)
cargo clippy --all-targets -- -D warnings
# 실패 시 → 경고 항목을 직접 수정 (#[allow] 사용 금지)
# 3. 빌드 검증
cargo build --release
# 실패 시 → 컴파일 에러 수정
Push-Location frontend
# 1. ESLint 검사
npx eslint src --max-warnings 0
# 실패 시 → 린트 에러 직접 수정 (eslint-disable 금지)
# 2. 타입 검사
npx tsc --noEmit
# 실패 시 → 타입 에러 수정
Pop-Location
git add로 다시 스테이지한다⚠️ --dry-run 모드에서도 검증은 수행하되, 수정은 보고만 한다.
<type>: <version> - <subject>
<body>
Co-Authored-By: Claude <noreply@anthropic.com>
Type 선택 기준:
| Type | 사용 조건 |
|---|---|
feat | 새 기능 추가, 대규모 개선 |
fix | 버그 수정 |
perf | 성능 개선 |
refactor | 리팩토링 (기능 변경 없음) |
docs | 문서만 변경 |
test | 테스트만 추가/수정 |
chore | 빌드, CI, 의존성 등 |
⚠️ 커밋 실행 전 반드시 사용자에게 메시지를 보여주고 확인을 받습니다.
다음 내용을 사용자에게 제시합니다:
사용자가 승인하면 커밋을 진행합니다.
⚠️ --dry-run 모드에서는 여기서 종료합니다.
# 업데이트된 문서 스테이징
git add CHANGELOG.md CLAUDE.md docs/architecture.md docs/migration_guide.md docs/todo.md
# PowerShell에서 멀티라인 커밋 메시지
git commit -m "<type>: <version> - <subject>" -m "<body>" -m "Co-Authored-By: Claude <noreply@anthropic.com>"
⚠️ 푸시는 자동 수행하지 않습니다. 사용자가 명시적으로 "push 해줘" 또는 "푸시해"라고 요청한 경우에만 git push를 실행합니다.
git add 완료)