| name | taskforge-help |
| description | Guides the user through the full TaskForge Pro usage and workflow. Use when the user says "/taskforge-help", "help", "how do I use this", "how does this work", "what do I do first", or similar. Also suggests the appropriate next step based on the current situation. |
Help — Usage Guide v2
Explain all TaskForge Pro features and recommend the appropriate next step based on the current project state.
On Execution
1. Detect Current State
Check project state files to determine which stage the project is at.
Check _workspace/projects/ for existing projects. If multiple exist, show all with their states.
Files present (under _workspace/projects/{projectId}/) | State | Recommended next step |
|---|
Nothing in _workspace/projects/ | 시작 전 | /taskforge-discover — 프로젝트 정의 시작 |
| spec-card.json only | 정의 완료 | /taskforge-plan — 작업 계획 수립 |
| project-plan.json (unapproved) | 계획 검토 중 | /taskforge-plan 에서 승인 |
| execution-state.json | 실행 중 | /taskforge-execute 또는 /taskforge-execute-all |
| Sprint complete state | 스프린트 완료 | /taskforge-validate 또는 /taskforge-status 확인 |
| Milestone complete state | 마일스톤 완료 | /taskforge-validate milestone — 품질 검증 필수 |
| Fully complete | 마무리 | /taskforge-retro — 회고 후 종료 |
2. Show Situation-Specific Guidance
TaskForge Pro — 현재 상황
프로젝트: {projectName}
진행: 마일스톤 {m}/{M} — 스프린트 {s}/{S} — 태스크 {t}/{T}
지금 할 수 있는 것:
- /taskforge-execute — 다음 태스크 1개 실행: "{nextTaskName}" [{difficultyLabel}]
- /taskforge-execute-all — 이번 스프린트 끝까지 자동 실행
- /taskforge-status — 전체 진행 상황 보기
3. First-Time User Guide
If no project files exist:
TaskForge Pro 처음 시작하기
1. /taskforge-discover — 만들고 싶은 것을 대화로 정의
2. /taskforge-plan — AI가 작업을 자동으로 쪼개줌
3. /taskforge-execute-all — 자동으로 실행 (또는 /taskforge-execute로 하나씩)
4. /taskforge-validate milestone — 완성도 자동 검증
5. /taskforge-playtest — 직접 확인
6. /taskforge-retro — 회고 + 다음 단계 계획
작은 수정 하나라면: /taskforge-quick 으로 바로 시작
전체 워크플로우 안내
대규모 프로젝트 (마일스톤 3개 이상)
/taskforge-vision → 전체 방향 + 마일스톤 스케치
/taskforge-discover → 이번 마일스톤 상세 정의
/taskforge-plan → 작업 쪼개기 + 승인
/taskforge-execute-all → 자동 실행
/taskforge-validate milestone → 품질 검증
/taskforge-playtest → 직접 확인
/taskforge-retro → 회고 + 다음 마일스톤 계획 갱신
(다음 마일스톤으로 반복)
소규모 프로젝트 (마일스톤 1-2개)
/taskforge-discover → 바로 정의 시작
/taskforge-plan → 작업 쪼개기
/taskforge-execute → 하나씩 실행
/taskforge-validate → 검증
빠른 수정
/taskforge-quick → 바로 실행 (계획 없이)
전체 스킬 목록 (v2)
| 스킬 | 용도 |
|---|
| /taskforge-vision | 전체 프로젝트 방향과 마일스톤을 큰 그림으로 스케치 (대규모 프로젝트용) |
| /taskforge-discover | 이번 마일스톤에서 만들 것을 대화로 구체적으로 정의 |
| /taskforge-plan | 정의된 내용을 작업 단위로 쪼개고 계획 수립 |
| /taskforge-plan-edit | 수립된 계획을 수정 (태스크 추가/삭제/변경) |
| /taskforge-execute | 다음 태스크 1개를 실행 |
| /taskforge-execute-all | 이번 스프린트의 모든 태스크를 자동으로 연속 실행 |
| /taskforge-quick | 계획 없이 지금 당장 작은 수정 하나를 실행 |
| /taskforge-validate | AI가 자동으로 완성도를 검증 (빌드, 코드 품질 등) |
| /taskforge-playtest | 직접 사용해보면서 재미나 완성도를 확인 |
| /taskforge-retro | 마일스톤 마친 후 회고 + 다음 마일스톤 계획 업데이트 |
| /taskforge-verify | 완성된 결과를 대화로 함께 확인 |
| /taskforge-status | 전체 진행 상황을 한눈에 보기 |
| /taskforge-cost | 지금까지 사용한 비용 요약 |
자주 묻는 질문
Q: 실행 중에 멈추고 싶어요.
A: "stop" 또는 "멈춰"라고 하면 현재 태스크가 끝난 뒤 멈춥니다. 이후 /taskforge-execute로 하나씩 이어갈 수 있습니다.
Q: 태스크가 실패했어요.
A: /taskforge-status에서 실패 위치를 확인하고, 자동으로 재시도가 이루어집니다. 계속 실패하면 /taskforge-quick으로 직접 다른 방식을 시도할 수 있습니다.
Q: 스프린트가 끝났는데 다음에 뭘 해야 해요?
A: /taskforge-status에서 백그라운드 검증 결과를 확인한 뒤, /taskforge-execute-all로 다음 스프린트를 이어가면 됩니다.
Q: 마일스톤이 끝났는데 다음에 뭘 해야 해요?
A: 반드시 /taskforge-validate milestone을 먼저 실행해 품질을 확인한 뒤, /taskforge-playtest로 직접 확인하고, /taskforge-retro로 회고하세요.
