wshobson/track-management

track-management은(는) 무엇을 하나요?

Conductor 트랙(기능, 버그, 리팩터링을 위한 논리적 작업 단위)을 생성, 관리 또는 작업할 때 이 스킬을 사용하세요. spec.md, plan.md 및 트랙 수명 주기 작업에 적용됩니다.

개요

트랙 관리는 개발 작업을 명확하고 추적 가능한 단위로 분할하여, AI 어시스턴트와 개발자가 함께 작업을 진행할 수 있도록 돕습니다. 각 트랙은 고유한 식별자와 상태를 가지며, 프로젝트의 진행 상황을 한눈에 파악할 수 있게 해줍니다.

주요 기능

• 트랙 생성: 새로운 기능, 버그 수정 또는 리팩터링 작업을 위한 트랙을 생성합니다.
• 트랙 업데이트: 트랙의 설명, 상태, 우선순위 등을 수정합니다.
• 트랙 상태 관리: open, in-progress, review, completed 등 트랙의 수명 주기를 관리합니다.
• 트랙 조회: 현재 진행 중인 모든 트랙 또는 특정 트랙의 상세 정보를 조회합니다.

사용 예시

# 새 트랙 생성
conductor track create "사용자 인증 모듈 리팩터링" --type refactor --priority high

# 트랙 상태 변경
conductor track update TRACK-123 --status in-progress

# 모든 트랙 조회
conductor track list

파일 구조

트랙 관련 파일은 일반적으로 .conductor/tracks/ 디렉토리에 저장됩니다. 각 트랙은 고유한 JSON 또는 YAML 파일로 관리됩니다.

.conductor/
├── tracks/
│   ├── TRACK-001.json
│   ├── TRACK-002.json
│   └── ...
├── spec.md
└── plan.md

환경 변수

트랙 관리를 위해 다음 환경 변수를 설정할 수 있습니다:

• CONDUCTOR_TRACK_DIR: 트랙 파일이 저장되는 디렉토리 경로 (기본값: .conductor/tracks/)
• CONDUCTOR_DEFAULT_STATUS: 새 트랙 생성 시 기본 상태 (기본값: open)

참고 사항

• 트랙 이름은 고유해야 하며, 공백 대신 하이픈(-)을 사용하는 것을 권장합니다.
• 모든 트랙 명령어는 프로젝트 루트 디렉토리에서 실행해야 합니다.