/video-ask
사용자를 한 화면에서 안내합니다: 현재 위치, 상황 상태, 다음에 입력할 내용.
1. 상태를 메모리가 아닌 파일에서 읽기
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/video-ask/scripts/status.py"
사용자가 현재 폴더가 아닌 다른 폴더에 대해 질문할 경우 첫 번째 인수로 폴더를 전달하세요.
정확한 질문에 답변하기 위해 필드(경로, 버전, 단계)가 필요하면 --json을 추가하세요.
이 스크립트는 docs/contracts.md가 정의한 파일을 기반으로 각 비디오의 단계를 추론하며,
도달한 가장 최신 단계는 다음과 같습니다: brief unsigned(브리프 미서명), signed(서명됨), sources fetched(소스 가져옴),
truth(진실), specs(명세), voice(음성), built(빌드됨), rendered(렌더링됨), QA failed(QA 실패),
QA passed(QA 통과), delivered(전달됨). QA 보고서는 해당 sha256이 최신 렌더와 일치할 때만 카운트되므로,
QA 이후 재렌더링하면 다시 rendered로 표시됩니다. 이전 대화에서 말한 내용보다 스크립트의 결과를 신뢰하세요:
하위 에이전트가 그 이후로 파일을 변경했을 수 있습니다.
2. 답변하기
스크립트 출력을 그대로 보여준 후(이미 짧습니다), 다음 명령어를 별도 줄에 표시하세요. 사용자가 질문(인수)을 한 경우, 상태 이후에 다음 순서로 소스를 참조하여 답변하고, 사용한 파일을 명시하세요:
$PVS_HOME/README.md(스킬이 무엇인지, 설치 방법, 제품에 필요한 입력)$PVS_HOME/docs/contracts.md(파일 형식, 폴더 레이아웃, 명령줄)- 질문과 관련된 스킬의
SKILL.md,$PVS_HOME/skills/아래 위치 - "이 규칙이 왜 여기에 있나요?" 질문에 대해서는 제품의
kit/RULES.md
해당 파일에서 답을 찾을 수 없으면 추측하지 말고 그렇게 말하세요.
3. 발견 시 알려야 할 사항
- 설정이 완료되지 않음: 다음 명령어는
/video-setup입니다. 그 전에는 다른 작업이 안정적으로 작동하지 않습니다. - 음성 키가 설정되지 않음: 사용자는 자신의 편집기에서 작업 공간
.env에 키를 붙여넣어야 하며, 채팅에서는 절대 안 됩니다.voice.provider: say는 키 없이도 작동합니다. 확인을 위해.env를 절대 읽지 마세요: 스크립트가 이미 설정 여부를 보고합니다. - 작업 공간 루트에 제품이 있음: 각 제품은 고유한 스킬과 훅이 있는 별도의 Claude Code 프로젝트입니다.
사용자는
cd products/<slug> && claude를 실행하여 작업합니다. - 브리프 미서명: 빌드는 리뷰어의 두 서명을 의도적으로 기다립니다. 이 스킬이 비롯된 프로덕션에서는 26개 버전 중 9개가 비디오가 설명해야 할 기능에 대해 누구도 동의하지 않았기 때문에 발생했습니다. 리뷰어의 서명 필드를 편집하지 말라고 제안하지 마세요.
- QA 실패: 해당 비디오의
qa/REPORT.md를 가리켜 실패한 검사를 확인하세요.
여기서부터 빌드, 수정 또는 전달을 시작하지 마세요. 이 스킬은 보고만 합니다; 사용자가 다음 명령어를 입력합니다.