진행 보고서은(는) 무엇을 하나요?
보고는 결정적 투영입니다. 보고서 유지만을 위해 에이전트를 스폰, 유지, 메시징 또는 폴링하지 마십시오. 누락된 할당, 결정 또는 블로커 사실만 기록하십시오.
CLI를 저장소 루트에서 실행하십시오: 아래 progress는 python <skill dir>/scripts/progress.py를 의미합니다.
(.claude/skills/progress-report, .agents/skills/progress-report 또는 $CLAUDE_PLUGIN_ROOT/skills/progress-report).
매번 전체 명령어를 입력하십시오. 동사는 한 줄을 출력합니다(refresh는 아무것도 출력하지 않음); 그대로 전달하십시오.
사용 시기
- 계획 파일(
- [ ]/- [x]항목이 있는 Markdown)이 작업을 주도하는 경우: plan 모드, Spec Kit 불필요. - Spec Kit 기능에
specs/<feature>/tasks.md가 있는 경우: feature 모드; Workflow 파일이 있으면 함께 수집됩니다.
Plan 모드 빠른 시작
progress hooks install --host claude(또는codex; 플러그인 설치 시--scope user추가)를 한 번 실행하여 모델, 노력, 컨텍스트 및 하위 에이전트를 설정합니다. 건너뛰어도 작업은 계속 추적됩니다.progress init --plan docs/plan.md는.progress/plan/을 생성하고(참고:--name,--dir)bind=<nonce>를 출력합니다; 다음 훅이 바인딩됩니다(hooks install은 보고서가 있으면 하나를 출력합니다).- 계획 파일에서 항목을 체크 해제하면 보고서가 업데이트됩니다. Progress는 계획을 절대 수정하지 않습니다.
progress status는 한 줄 상태를 제공합니다; 뷰는.progress/plan/.view/index.html에 있습니다.
항목에는 고유 id(T001)가 부여되고, 다른 항목은 안정적인 P001... id를 받습니다. 하나의 계획 또는 기능이 활성화된 경우 대상 플래그가 필요하지 않습니다; 그렇지 않으면 --plan NAME 또는 --feature DIR을 전달하십시오.
동사
| 필요 사항 | 명령어 |
|---|---|
| 보고서 생성 | progress init --plan PATH [--name N] [--dir D] 또는 progress init (Spec Kit) |
| 한 줄 상태 | progress status |
| 레인 할당 | progress lane L1 --tasks P001-P004 --owner ID --harness H --model M --effort E |
| 레인 종료 | progress lane L1 --close |
| 블로커 | progress block P007 --by L2 (또는 P003, ext:"text"); progress unblock B4 |
| 결정 | progress decide ask "질문" --options a,b; progress decide made D2 b --by user |
| 노트 | progress note "텍스트" --target P005 |
| 내보내기 | progress export --format md |
| 훅 | `progress hooks install |
규칙
- 작업을 할당할 때 레인을 기록하십시오(
L#; 호스트 하위 에이전트C#은 자동으로 나타납니다). 시작, 완료 및 재시도는 명령어가 필요하지 않습니다. - 노트에 비밀, 절대 경로 또는 대화 내용 텍스트를 절대 넣지 마십시오(최대 200자).
- 알 수 없는 값은 알 수 없는 상태로 둡니다. 모델, 노력, 컨텍스트 또는 시간을 추정하지 마십시오.
- 오류는
progress: error CODE로 표시됩니다; 원인을 수정하고 루프로 재시도하지 마십시오.
자세한 내용: references/verbs.md; 계약 docs/contracts.md; 플래그 docs/commands.md.