--- name: tk-grill description: "[user/auto] 아이디어·계획·의사결정을 철저히 검토하고 숨은 가정·절충·결정 분기를 사용자와 확인해 달라는 명확한 요청에 사용합니다. 단순 의견·브레인스토밍, 일반 구현 준비, 질문 수 증가만을 이유로 자동 진입하지 않습니다." disable-model-invocation: false argument-hint: "" metadata: tigerkit: kind: hybrid origin: mattpocock/skills relationship: adapted upstream-skill: grilling --- ## 공통 저작 품질 관문 이 스킬에서 질문·메시지·설명·보고서·Markdown·HTML·대본·자막·문서·스킬 본문 등 사람이 읽는 텍스트를 **새로 작성하거나 의미·표현을 수정하기 전에**, 설치된 `tk-writing`의 [모든 저작의 공통 관문](../tk-writing/references/authoring-gate.md)과 [명확한 글쓰기](../tk-writing/references/clear-writing.md)를 이번 작업에서 읽고 적용합니다. 최종 산출물을 인계하기 전에 같은 기준으로 원고를 검사하고 문제를 수정합니다. 이미 읽은 기준을 반복 로드하거나 별도 재작성 스킬·에이전트·승인 라운드를 추가하지 않습니다. 코드·명령·식별자·기계 판독 형식·인용과 고정 문구는 보호하며, 이 참조로 변경·전송·발행 권한이 생기지 않습니다. 이 스킬이 작성 작업을 수행하지 않는 경우에는 추가 읽기가 필요하지 않습니다. # 의사결정 심층 검토 ## 공통 참조 현재 설치된 담당 스킬에서 분기 조건에 해당하는 기준을 읽습니다. 담당 스킬이나 자원이 없거나 일치하지 않으면 해당 행동을 중단합니다. 기억, 다른 설치본이나 승인받지 않은 설치로 우회하지 말고 `tk-setup-skills`를 사용합니다. 참조 읽기는 업무 실행이나 변경 권한을 부여하지 않습니다. - 사용자 소유 결정·누락된 승인·미충족 선행 조건을 질문이나 질문 도구 입력으로 제시하기 직전에 [질문 라운드](../tk-questioning/references/questions.md)를 이번 작업에서 읽었는지 확인하고 누락했으면 먼저 읽습니다. 독립적인 결정과 승인은 각각 별도 질문으로 두며, 승인 선택지를 결정 질문에 섞지 않습니다. - 사용자에게 완료 보고, 산출물 경로 인계나 여러 속성을 비교하는 채팅을 전달하기 전에 [채팅 전달](../tk-writing/references/delivery.md)을 읽습니다. 해당 작업의 구체적인 출력 계약이 우선합니다. `/tk-grill`, `$tk-grill`, 호스트의 스킬 선택 또는 아이디어·계획·결정의 허점과 숨은 가정까지 깊게 검토해 달라는 명확한 자연어 요청으로 시작합니다. 단순 의견, 일반적인 브레인스토밍, 저장소 설명, 구체적인 구현 요청이나 `tk-prep` 중 질문이 늘어난 상황만으로 자동 호출하지 않습니다. 실제 구현 준비는 `tk-prep`, 질문 방식의 공통 기준은 `tk-questioning`이 소유하며 같은 요청에서 중복 인터뷰를 시작하지 않습니다. ## 경계 대략적인 아이디어, 결정이나 계획에서 출발하여 서로 같은 내용을 이해했는지 확인할 때까지 질의 과정을 담당합니다. 모든 상태는 현재 대화에만 둡니다. 소스, 테스트, 설정, Git 상태, 티켓, `Seed`, SDD, 도메인 산출물, 일반 임시 파일, 원장이나 작업 그래프를 만들거나 수정하지 않습니다. 시각 질문 분기에서만 `.tigerkit/tmp/tk-grill//` 아래 HTML 비교 자료 하나와 그에 필요한 제외 설정을 허용합니다. 다른 스킬을 호출하거나 구현을 자동으로 시작하지 않습니다. 다른 준비 스킬이 이 인터뷰 기준을 참고하더라도 `tk-grill` 자체의 계획 작성·구현 금지와 종료 경계를 바꾸지 않습니다. 전체 실행의 승인과 권한은 각각의 실제 담당자가 별도로 확인합니다. 종합한 뒤에는 관련 있는 선택적 경로만 제안합니다. - 결과가 구현 요청이나 티켓이 되었으면 `tk-prep`을 제안합니다. - 사용자가 저장소 고유 용어나 지속해서 보존할 결정을 원하면 `tk-domain`을 제안합니다. - 더 할 일이 없으면 중단합니다. 다음 단계가 명시 호출 전용 스킬이면 `/`을 넣어 한 줄로 안내합니다. 자동 호출 가능한 스킬도 이 검토만으로 시작할 권한이 생기지 않으며, 사용자의 후속 요청에 따라 담당 범위를 전환합니다. 다른 세션으로 넘길 때만 전체 인계 프롬프트를 제공합니다. ## 결정 트리와 현재 질문 집합 검토할 주제를 결정 트리로 정리합니다. 어떤 분기는 선행 조건이 확정된 뒤에야 답할 수 있습니다. **현재 질문 집합**은 다른 미해결 답을 추측하지 않고 지금 답할 수 있는 모든 미해결 결정입니다. 다음 순서로 라운드를 진행합니다. 1. 확인된 사실, 해결되지 않은 가정과 사용자가 결정해야 할 사항을 구분합니다. 2. 대화, 제공된 파일, 저장소, 연결된 도구나 범위가 제한된 공개 출처에서 안전하게 조사할 수 있는 사실을 확인합니다. 이용 가능한 근거로 답할 수 있는 사실을 사용자에게 묻지 않습니다. 셸 조회는 확인된 저장소 루트에 한정하고, 검색 glob은 따옴표로 감쌉니다. 예를 들면 `rg --glob '*.ts'` 또는 `grep --include='*.ts'`입니다. 구분자만 있는 명령은 생략하며, 특히 zsh에서 `=`로 시작하는 단어를 따옴표 없이 사용하지 않습니다. 3. 현재 질문 집합 전체를 한 라운드로 다루고 독립적인 질문만 묶습니다. 임의로 질문 수를 고정하지 않되, 현재 질문 도구의 개수·선택지 제한을 넘으면 묶음을 나눕니다. 질문이나 도구 호출 직전에 [질문 라운드](../tk-questioning/references/questions.md)를 읽었는지 확인하고, 그 도구 우선순위와 대체 형식을 모든 라운드에 적용합니다. 현재 질문 중 레이아웃, 계층, 밀도나 탐색 대안을 비교하는 질문이 하나라도 있으면 같은 라운드에 [시각 질문 보조 자료](../tk-questioning/references/visual-questions.md)를 첨부합니다. 4. 답이 미해결 선행 조건에 의존하는 질문은 미룹니다. 조사할 사실이 미해결이면 그 사실에 의존하는 분기만 막히며, 나머지 현재 질문은 막히지 않습니다. 5. 사용자가 답하면 트리를 갱신하고 모순이나 새롭게 드러난 가정을 찾아 현재 질문 집합을 다시 계산한 뒤 계속 진행합니다. 사실 확인을 끝없는 조사로 확대하지 않습니다. 현재 결정 트리를 실질적으로 바꿀 수 있는 사실만 조사합니다. 결과에 중요한 영향을 주는 대안 선택에서는 추천을 좌우하는 가정과 우선순위에 비추어 추천을 검토합니다. 다른 선택이 더 나아지는 조건의 변화를 알고 있다면 근거에 따라 그 변화를 밝힙니다. 확인할 수 있는 제약은 사용자에게 묻지 말고 조사하며, 사용자에게 속한 우선순위만 묻습니다. 선택이 바뀌는 조건을 모르면 임계값을 지어내지 말고 불확실성을 유지합니다. 사소하고 쉽게 되돌릴 수 있는 선택에는 이 분석을 생략합니다. ## 시각 질문 해결되지 않은 공간적 대안이 있으면 [시각 질문](../tk-questioning/references/visual-questions.md)을 읽고 공통 질문 계약에 따른 네이티브 질문 또는 채팅 라운드에 HTML 비교 자료 하나를 첨부합니다. 모든 결정은 질문 자체만으로도 완결되게 제시하며, 보조 자료에서도 같은 라운드의 비시각적 선택을 수집합니다. 경계 절에서는 이 질문 보조 자료와 정해진 산출물 설정만 허용합니다. ## 질문 계약 목표, 우선순위, 절충에 대한 선호, 범위, 의미, 어조와 수용할 위험은 사용자가 결정합니다. 이를 말없이 대신 선택하지 않습니다. 유용한 추천이 가능하면 중립적인 선택지만 나열하여 모든 판단을 떠넘기지 말고 추천과 그 이유를 함께 제시합니다. 추천이 기존 메커니즘이나 데이터가 존재하는 시점에 의존하면, 이를 입증하는 `path:line`을 인용합니다. 그렇지 않으면 추천 전에 조사합니다. 철저해 보이려고 후속 질문을 묻지 않습니다. 집요함은 질문량을 최대화하는 것이 아니라 말없이 남겨 둔 결정 분기가 없게 하는 것입니다. ## 완료 현재 질문 집합이 비어 있는 것으로 보이면 다음을 수행합니다. 1. 전체 트리에서 살펴보지 않은 분기, 숨은 가정, 모순이나 의도적으로 열어 둔 위험이 있는지 확인합니다. 2. 현재 이해한 내용을 짧게 요약하고, 서로 같은 내용을 이해했으며 빠진 내용이 없는지 사용자에게 확인을 요청합니다. 3. 확인 전에는 결과에 따라 행동하지 않습니다. 사용자가 정정하면 트리를 갱신하고 새 현재 질문 집합에서 이어갑니다. 4. 확인 후에는 목적이나 결론, 주요 결정과 그 이유, 의도적으로 열어 둔 가정이나 위험, 선택적인 다음 경로를 간결하게 종합하여 반환합니다. 중요한 전환 조건을 파악했다면 포함합니다. 추가 산출물은 만들지 않고, 이미 승인된 시각 질문 보조 자료만 유지합니다. ## 출처 결정 트리, 선행 조건을 고려한 현재 질문 집합, 현재 질문 집합 전체를 묻는 라운드, 사실과 결정의 소유권 구분, 추천과 상호 이해 확인 관문은 `mattpocock/skills`의 `skills/productivity/grilling`, 커밋 `6654f6b60cd9d5be8b54c6fafe44346dabeb3b76`에서 가져와 조정했습니다. TigerKit에서는 필수 하위 에이전트 런타임 가정, `grill-me`와 `grill-with-docs` 같은 래퍼, 자동 구현 전환과 영속 상태를 제거합니다. 원본 저작권 및 MIT 고지는 [LICENSE.txt](LICENSE.txt)에 있습니다. ## 산출물 경로 승인된 산출물 쓰기, 체크아웃, 전송, 제외 설정이나 임시 입력 소비 전에 [산출물 경로](../tk-artifacts/references/artifact-paths.md)를 읽습니다. 저장소 임시 파일에는 소유권이 확인된 안전한 비심볼릭 링크 경로와 입증된 Git 제외를 사용합니다. 검사에 실패하면 해당 파일 분기를 중단합니다. 명시된 최종 목적지와 담당 스킬별 기본값을 보존합니다. 미리 채운 입력은 완료된 입력이 아닙니다. 정리는 경로 해석이 완료되어 기록된 실행 소유 절대 경로 문자열만 그대로 대상으로 삼습니다. 현재 작업 디렉터리 기준 상대 경로나 glob은 대상으로 삼지 않습니다.