/product-new
워크벤치에 하나의 제품 폴더를 생성합니다: 짧은 인터뷰, 폴더를 작성하는 하나의 스크립트, 그리고 폴더를 채우는 두 개의 모델 호출 스킬(source-recon은 코드를 가져오고, product-kit은 토큰, 폰트, 아이콘, 로고, 캐스트 및 이름을 추출합니다).
무엇보다 먼저 인터뷰를 진행하는 이유: 이 스킬이 비롯된 실제 제작 과정에서 캐스트, 제품명 및 포지셔닝은 검토 때마다 하나씩 결정되었고, 각 결정은 리렌더링을 강제했습니다. 여기서 수집된 모든 답변은 나중에 발생하지 않는 하나의 검토 단계입니다.
시작하기 전에
이 스킬의 실제 경로에서 워크벤치를 확인합니다 (워크벤치 및 제품 폴더에서 작동합니다):
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
인수에서 슬러그를 확인합니다: 2~40자의 소문자, 숫자 또는 대시로 구성되며 문자로 시작해야 합니다. $PVS_HOME/products/<slug>가 이미 존재하면 중단하고 그 사실을 알립니다: 제품은 자체 히스토리와 서명된 브리프가 있을 수 있으므로 절대 덮어쓰지 마십시오. 사용자가 --from examples/acme (또는 다른 폴더)를 전달한 경우, 인터뷰는 해당 폴더와 다른 부분만 필요합니다.
저장소를 연결하기 전에 사용자에게 한 번 알립니다: Claude는 제품의 코드를 읽습니다. 즉, 코드가 모델에 컨텍스트로 전송된다는 의미입니다. 사용자는 회사에서 이를 허용하는지 확인해야 합니다.
1. 인터뷰
작은 그룹으로 질문합니다 (메시지당 두세 개의 질문). 사용자의 언어로 질문하세요. 추론할 수 있는 항목에 대해서는 기본값을 제안하여 사용자가 대부분 확인만 하도록 합니다. 전체 질문 목록과 각 질문의 이유는 references/interview.md에 있습니다. 질문하기 전에 읽어보세요.
- 제품: 이름, 한 문장으로 설명(포지셔닝), 대상 사용자.
- 절대 사용하지 않을 표현: 팀에서 거부하는 설명 (회사 문서에 사용되더라도).
- 소스: 각 소스(프론트엔드, 백엔드, 디자인, 문서)에 대해 git URL 또는 로컬 경로, 프로덕션에 있는 브랜치, 앱 디렉토리 및 프레임워크(
angular-primeng,react,vue,svelte,html,other). 실제로 배포된 브랜치가 무엇인지 물어보세요: 오래된 체크아웃은 원래 프로덕션에서 실제 시간을 소모했습니다. - 문서: URL, 저장소 경로 또는
mcp:<name>(읽기 전용). - 브랜드: 프론트엔드에 없는 경우에만 (로고 및 폰트 파일). 그렇지 않으면
product-kit이 찾습니다. - 가상 캐스트: 회사와 두세 명의 인물(전체 이름, 555 전화번호,
example/.test도메인의 이메일)을 제안합니다. 기본값으로 제안을 포함한 폐쇄형 질문으로 거부권을 행사할 기회를 제공합니다. 검토자는 평범하거나 실제처럼 들리는 이름에 강하게 반응하며, 비디오 간에 성이 변경되는 인물은 출시되는 버그입니다. - 이름 및 발음: 공식 이름, 라이브 UI에 여전히 표시될 수 있는 레거시 문자열, 브랜드 단어의 발음.
- 금지 용어: 경쟁사, 공급업체, 실제 고객 등 절대 보이거나 들려서는 안 되는 모든 것.
- 검토자: 각 비디오의 적용 범위 매트릭스 및 클레임 시트에 서명하는 사람.
절대 토큰, 비밀번호 또는 SSH 키를 요청하지 말고, 저장을 제안하지도 마십시오. 소스는 머신이 이미 가지고 있는 git 액세스 권한으로 가져옵니다. URL에 자격 증명이 포함된 경우(https://user:token@...), 사용자에게 제거하도록 요청하십시오. 스크립트는 어쨌든 거부합니다.
2. 폴더 작성
답변을 product.yaml 형태의 임시 파일(모든 하위 집합, references/answers.example.json 참조)로 저장소 외부에 기록한 후 다음을 실행합니다:
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/product-new/scripts/new_product.py" <slug> \
--answers <scratch>/answers.json [--from examples/acme]
스크립트는 _template/product를 복사한 다음 --from 폴더를 그 위에 복사합니다(파일이 누락된 예제(예: kit/RULES.md)는 여전히 템플릿의 파일을 가져옵니다). 답변을 product.yaml에 한 줄씩 병합하고(템플릿의 주석은 사용자 문서이므로 유지됨), 템플릿에 없는 경우 CLAUDE.md 및 .gitignore를 작성하고, scripts/link-skills.sh를 실행하여 cd products/<slug> && claude가 동일한 스킬을 보게 한 후 첫 번째 git 커밋을 만듭니다. 기존 슬러그, URL 내 자격 증명, 그리고 명백히 가상이 아닌 캐스트 이메일 또는 전화번호는 거부합니다. 실패하면 오류가 발생한 답변을 수정하고 다시 실행하십시오. 폴더를 수동으로 생성하지 마십시오.
"여전히 채워야 할 product.yaml"이 출력되면 인터뷰에서 다루지 않은 템플릿 플레이스홀더입니다. 이에 대해 질문하거나 사용자에게 남은 항목을 알려주십시오.
3. 채우기
Skill 도구를 통해 다음 모델 호출 스킬을 이 순서대로 호출합니다:
source-recon: 모든 소스를products/<slug>/sources/로 가져오고sources.lock에 고정합니다. 액세스 문제로 가져오기가 실패하면 정확한 git 오류를 보고하고 중단합니다: 사용자는 자격 증명을 제공하는 것이 아니라 자신의 머신에서 액세스 권한을 수정합니다.product-kit:kit/tokens.css, 폰트, 아이콘, 로고를 추출하고 캐스트, 이름 및 발음을 키트와kit/RULES.md에 기록합니다.
두 스킬 모두 제품 폴더 내에서만 씁니다. sources/ 안의 어떤 것도 절대 편집하지 마십시오.
4. 보고
하나의 짧은 테이블과 함께 다음 명령어를 표시합니다:
| 항목 | 값 |
|---|---|
| 폴더 | products/<slug>/ (git: 첫 번째 커밋 또는 그렇지 않은 이유) |
| 소스 | 역할, 브랜치, sources.lock의 커밋 |
| 키트 | product-kit이 추출한 것과 찾을 수 없었던 것 |
| 캐스트 | 최종 거부권 행사를 위한 확정된 이름 |
| 미해결 | product.yaml에 남아 있는 플레이스홀더, 확인되지 않은 모든 것 |
다음: cd products/<slug> && claude, 그 다음 /video-new <video>.