feat(skill): absorb external design skills, restore interview gate, add review route
- Restore the step-0 interview as a mechanical gate the skill explicitly depends on; add harness.md (per-harness question tools, limits, fallbacks) and brief-interview.md (slots, question cards, rounds). - Add 10 reference docs absorbed from external design skills (accessibility, interaction-feel, elevation, color, icons, product-copy, component-systems, critique, change-review, print-email) and extend existing references. - Add a review-only route and two hard-gate clauses (truncated content reachability, three-flashes limit). - design-gate: split tap targets into WCAG 2.5.8 and 44px contract layers, run axe-core when available, and fix false positives found on a real site (decorative alt="", stacked wordmark line count, url-only pages). - lint-skill: fail if the interview gate section or its links disappear. - Ship agents/openai.yaml and THIRD_PARTY_NOTICES.md.
This commit is contained in:
parent
79e79c120b
commit
6805fb2be7
37 changed files with 5688 additions and 128 deletions
190
packages/skill/references/harness.md
Normal file
190
packages/skill/references/harness.md
Normal file
|
|
@ -0,0 +1,190 @@
|
|||
# harness — 하네스별 기능과 질문 방법 원장
|
||||
|
||||
0단계에서, 그리고 하네스 기능(계획 도구·서브에이전트·브라우저 검증)을 쓸 때 읽는다. [brief-interview.md](brief-interview.md)가 "무엇을 언제 묻는가"를 정한다면, 이 문서는 "이 하네스에서 그것을 어떤 도구로, 몇 개까지, 어떤 조건에서 물을 수 있는가"를 정한다. [SKILL.md](../SKILL.md)의 인터뷰 게이트 여섯 규칙은 여기서 바뀌지 않는다.
|
||||
|
||||
## 이 문서를 읽는 법
|
||||
|
||||
| 상황 | 읽을 곳 |
|
||||
|---|---|
|
||||
| 지금 세션이 어떤 하네스인지 확인하고 질문 도구를 고른다 | §1 |
|
||||
| 몇 개까지 묻고 어떤 순서로 배치할지 정한다 | §2 |
|
||||
| 사용자가 없거나(`claude -p`, `codex exec`, CI), 빈 답이 왔거나, 서브에이전트로 실행 중이다 | §3 |
|
||||
| 0~6단계를 계획·할 일 도구로 추적하고 싶다 | §4 |
|
||||
| 1단계 레퍼런스 조사를 서브에이전트에 나눠 맡기고 싶다 | §5 |
|
||||
| 스크린샷·감사 도구로 렌더를 검증한다 | §6 |
|
||||
| 지금 세션이 Plan 모드·auto 모드인지 확인한다 | §7 |
|
||||
| 이 스킬의 frontmatter를 왜 최소로 유지하는지 | §8 |
|
||||
| 이 문서 각 사실의 출처를 확인한다 | §9 |
|
||||
|
||||
---
|
||||
|
||||
## 0. 확인일과 재확인 규칙
|
||||
|
||||
이 문서의 사실은 **2026-09-24**에 1차 출처(공식 문서·소스코드·로컬 CLI `--help` 출력)로 확인했다. 하네스는 스킬보다 빠르게 바뀐다 — 도구 이름이 바뀌거나, 기본 모드가 바뀌거나, 자율성 압력 문구가 바뀔 수 있다.
|
||||
|
||||
- **릴리스 전에 재확인한다.** `packages/skill/CHANGELOG.md`에 하네스 행동 변화가 있으면 이 문서를 먼저 고치고 나서 태그를 올린다.
|
||||
- **사실이 바뀌면 이 문서만 고친다.** SKILL.md·brief-interview.md의 여섯 규칙과 슬롯표는 하네스 사실과 무관하게 성립하는 절차이므로, 하네스 쪽 변경이 두 문서를 흔들 필요는 없다.
|
||||
- **미확인 사실은 미확인이라고 쓴다.** 이 문서의 표에서 "미확인"은 조사하지 않았다는 뜻이 아니라, 1차 출처에서 확인을 시도했지만 확인하지 못했다는 뜻이다. 확인한 적 없는 값을 추정해 채우지 않는다.
|
||||
|
||||
---
|
||||
|
||||
## 1. 질문 도구 표
|
||||
|
||||
기계적으로 판정한다. 세션의 도구 목록에 아래 이름의 구조화 질문 도구가 있으면 그것을 쓰고, 없으면 대화형 평문으로 번호 매긴 질문을 내고 턴을 끝낸다. "시스템 프롬프트가 자율 진행을 권한다"는 도구 유무 판정에 영향을 주지 않는다.
|
||||
|
||||
| 하네스 | 질문 도구와 한도 | 쓸 수 있는 조건 | 질문을 억누르는 압력 |
|
||||
|---|---|---|---|
|
||||
| Claude Code | `AskUserQuestion` — 질문 1~4개, 선택지 2~4개, header 12자, multiSelect, preview 지원 | 메인 세션에서만 호출할 수 있다. `Agent` 도구로 띄운 서브에이전트에서는 이 도구 자체가 제외되어 쓸 수 없다(공식 문서 명시). `context: fork` 스킬에서도 깨진다(공개 이슈 #19751, §9) | `auto` 모드가 Pro·Max·Team 플랜에서 기본 시작 모드다(2026-08-14 새 세션부터, macOS·Linux·WSL은 v2.1.228 이상, Windows 네이티브는 v2.1.233 이상 — 그 이전 버전은 기본이 Manual, §9). 공식 문서: "nudges Claude to keep working without stopping for clarifying questions, though Claude still asks when your prompt or a skill explicitly relies on it." 이 스킬은 §0(SKILL.md 인터뷰 게이트)에서 명시적으로 의존한다고 선언해 그 탈출구를 쓴다 |
|
||||
| Codex | `request_user_input` — 질문당 상호 배타적 선택지 2~3개, 추천 선택지에 "(Recommended)" 접미사, "Other"는 클라이언트가 자동으로 추가한다(직접 넣지 않는다) | Plan 모드에서 기본 허용된다. Default 협업 모드에서는 `default_mode_request_user_input` 기능 플래그가 켜져 있어야 한다. `codex exec`(비대화형)는 서버발 상호작용 요청을 전부 즉시 거부한다 — 질문 도구도, 실행 승인도 기다리지 않고 하드코딩된 거부 메시지로 응답한다 | 내장 프롬프트의 "Autonomy and Persistence" 절: 턴 안에서 끝까지 처리하라. Prompting Guide: "Bias to action … do not end your turn with clarifications unless truly blocked" |
|
||||
| Gemini CLI | `ask_user` — 질문 1~4개, choice·text·yesno 혼합, multiSelect | Plan 모드가 기본 활성이다. Plan을 벗어나면 YOLO 모드로 전환된다. YOLO 모드에서는 빈 답이 자동으로 통과되는 버그가 보고돼 있다(공개 이슈 #18540, §9) | 실행 단계로 자동 전환되는 것 자체가 질문 라운드를 건너뛰는 경로가 된다 |
|
||||
| VS Code Copilot | `askQuestions` — 질문 캐러셀 UI, 질문 사이 이동(Alt+N/Alt+P), 스크린리더용 위치 안내("Question 1 of 3"). v1.110(2026-02)에서 VS Code 코어로 들어왔다(§9) | agent 모드에서 메인 에이전트가 쓴다. 서브에이전트에는 질문 도구가 없다(공식 문서 명시) | 클라우드 에이전트는 비동기 실행이라 대화 자체가 없다 |
|
||||
| Cursor | 공식 문서는 "Agent asks clarifying questions to understand your requirements"라고만 설명할 뿐, 특정 이름의 전용 도구를 명시하지 않는다. **도구명은 미확인** — 평문 폴백을 기본으로 삼는다 | Plan Mode에서 하네스가 질문 흐름을 주입한다. Agent 모드에서는 이 흐름을 쓸 수 없다 | — |
|
||||
| Windsurf, Antigravity, Zcode, AGENTS.md 경로(그 외 하네스) | 공개 문서로 확인되는 구조화 질문 도구가 없다 | 채팅으로 직접 묻는 것은 가능하다 | Zcode의 일반 질문에 5분 타임아웃이 있다는 것은 2차 조사 결과이며 이번 확인 범위에서 1차 출처로 재확인하지 못했다 — 재확인 필요로 남긴다 |
|
||||
|
||||
도구가 없거나 확인되지 않는 행에서는 [brief-interview.md §6(c) 평문 폴백판](brief-interview.md)을 쓴다. "도구 이름을 모른다"는 질문을 생략할 근거가 아니다 — 평문으로 대체하고 턴을 끝낸다.
|
||||
|
||||
---
|
||||
|
||||
## 2. 질문 예산과 배치
|
||||
|
||||
| 하네스 | 방법 | 예산과 배치 |
|
||||
|---|---|---|
|
||||
| Claude Code | `AskUserQuestion` | 질문 4개: 업종·성격 / 목표 행동(multiSelect) / 톤(preview로 ASCII 목업 비교) / 브랜드 자산. 고유명사는 Other 자유 답이나 2라운드로 |
|
||||
| Codex(Plan 모드, 또는 Default + 플래그) | `request_user_input` | 질문 3개(업종·성격, 가장 중요한 목표 행동 하나, 톤), 선택지 2~3개. 선택지가 서로 배타적이라 나머지 목표 행동과 다른 슬롯은 같은 턴에 평문 한 블록 |
|
||||
| Codex(Default 모드, 도구 없음) | 평문 번호 질문 + 턴 종료 | 첫 응답에서 "긴 디자인 작업은 Plan 모드에서 시작하면 선택지 UI로 답할 수 있다"를 한 줄 안내 |
|
||||
| Gemini CLI | `ask_user` | 질문 4개, choice·text 혼합 |
|
||||
| VS Code Copilot | `askQuestions` | 질문 4개 |
|
||||
| Cursor | Plan 모드면 하네스가 주입한 질문 흐름, Agent 모드면 평문 | — |
|
||||
| 그 밖의 하네스, AGENTS.md 경로 | 평문 번호 질문(선택지는 알파벳, 자유 답 허용) + 턴 종료 | — |
|
||||
|
||||
배치 순서와 카드 형식은 [brief-interview.md §5·§6](brief-interview.md)을 따른다 — 결과를 크게 바꾸는 축(업종·성격, 목표 행동)을 톤·고유명사보다 앞에 낸다.
|
||||
|
||||
빈 답 처리도 여기서 정한다. 자동 해제로 들어온 빈 답(Codex의 autoResolution, Gemini의 YOLO)은 **무응답**으로 취급한다. §3의 가정 처리로 넘기고, 어떤 선택지를 고른 것으로 해석하지 않는다.
|
||||
|
||||
---
|
||||
|
||||
## 3. 비대화형·빈 답·서브에이전트
|
||||
|
||||
`claude -p`, `codex exec`, CI 실행은 구조화 질문 도구로 답을 기다릴 수 없는 실행이다. 이 절은 [SKILL.md 인터뷰 게이트](../SKILL.md) 규칙 3·5를 구체화한다.
|
||||
|
||||
1. **자동 해제로 들어온 빈 답은 무응답이다.** Codex의 autoResolution(60~240초 뒤 빈 답 자동 제출), Gemini CLI YOLO 모드의 자동 통과가 여기 해당한다. 이 빈 답을 특정 선택지로 해석하지 않는다.
|
||||
2. **한 번 실행하고 끝나는 실행도 평문으로 묻고 끝낸다.** `codex exec`는 `request_user_input`·실행 승인·패치 승인·권한 요청을 모두 하드코딩된 거부 메시지로 즉시 돌려보낸다(소스코드로 확인). 그러니 구조화 도구로 기다릴 수는 없다. 그래도 최종 응답에 브리프 카드 초안과 번호 질문을 남기고 파일을 만들지 않은 채 끝낼 수는 있다 — 답은 세션 재개나 다음 실행 프롬프트로 온다. 빈 브리프로 가정 위에 전체 디자인을 만드는 것은 사용자가 명시적으로 위임했을 때만이다([brief-interview.md §11](brief-interview.md)).
|
||||
3. **서브에이전트는 사용자에게 직접 질문할 수 없다는 것이 여러 하네스에서 공식적으로 확인된다.**
|
||||
- Claude Code: `AskUserQuestion`은 서브에이전트 도구 목록에서 명시적으로 제외된다.
|
||||
- VS Code Copilot: "The built-in tools for asking clarifying questions and managing todo items are unavailable to subagents"라고 명시한다.
|
||||
- Codex: 위임 스레드(`codex_delegate`)는 승인 요청 자체를 절대 보내지 않으며 `approval_policy`가 `never`여야 한다.
|
||||
- Gemini CLI, Windsurf, Antigravity, Zcode: 서브에이전트가 사용자에게 직접 질문할 수 있는지 공식 문서에 명시가 없다(미확인). 명시가 없다는 것을 "질문할 수 있다"로 해석하지 않는다 — 확인되지 않은 것은 안전한 쪽(질문 불가로 가정)으로 취급한다.
|
||||
|
||||
따라서 서브에이전트로 실행 중이면 0단계를 끝내려 하지 않는다. 브리프 카드 초안과 남은 질문을 호출자에게 반환하고 멈춘다. 0단계는 반드시 메인 세션에서 끝낸다.
|
||||
4. **오케스트레이터가 워커에게 디자인 구현을 넘길 때는 브리프 카드를 작업 패킷에 포함한다.** 워커가 다시 사용자에게 묻는 일이 없도록 확정된 슬롯과 미확정 가정을 함께 넘긴다(§5도 참고).
|
||||
|
||||
---
|
||||
|
||||
## 4. 계획·할 일 도구
|
||||
|
||||
하네스의 계획·할 일 도구로 0단계(브리프 게이트)부터 6단계(결정을 남긴다)까지 항목화하면 단계 보고와 연결하기 쉽다. 도구 이름과 가용성은 모델·버전에 따라 갈린다.
|
||||
|
||||
| 하네스 | 도구 | 주의 |
|
||||
|---|---|---|
|
||||
| Claude Code | `TaskCreate`/`TaskGet`/`TaskUpdate`/`TaskList`(Task 도구 4종). `CLAUDE_CODE_ENABLE_TASKS=0`이면 `TodoWrite`로 대체된다 | 이 기본값은 Claude Code v2.1.268 이상에 적용된다. Task 도구(및 TodoWrite)는 **Claude 3.x, Opus 4~4.7, Sonnet 4~4.6, Haiku 4.5에서만 기본 제공**된다. 그 외 모델(인식되지 않는 모델 ID 포함)에서는 `allowedTools` 지정이나 `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`로 옵트인해야 쓸 수 있다 |
|
||||
| Codex | `update_plan`(체크리스트·진행상황·TODO 도구) | `update_plan`은 Plan 모드와는 **별개**다. Plan 모드 중에 `update_plan`을 쓰려고 하면 오류가 반환된다 — Plan 모드에서 계획을 추적하고 싶으면 Plan 모드 자체의 대화 흐름을 쓰고, `update_plan`은 Plan 모드를 벗어난 뒤(또는 Default 모드에서) 쓴다 |
|
||||
| Gemini CLI | `write_todos` | 다단계 요청의 내부 서브태스크 목록을 관리한다 |
|
||||
| VS Code Copilot | 서브에이전트 문서가 "할 일 관리 도구"의 존재는 간접 확인하지만, **정확한 공식 명칭은 미확인**이다 | 이름을 확정하지 않은 채 "할 일 도구가 있다"고만 안내한다 |
|
||||
| Zcode | Goal Mode(`/goal`, `/goal <objective>`, `/goal replace`, `/goal pause`, `/goal resume`, `/goal clear`) | 계획 나열이 아니라 **세션 목표**를 설정하는 도구다. 매 라운드 후 목표 달성 여부를 자동 검증하며, 검증은 변경된 파일·커맨드 출력·테스트 결과 같은 실제 증거를 요구하고 계획·체크리스트·그럴듯한 답변만으로는 인정하지 않는다. 0~6단계를 체크리스트로 나열하는 용도가 아니라 "이번 세션의 목표 = 6단계까지 완료"처럼 상위 목표를 거는 용도에 가깝다 |
|
||||
|
||||
**0~6단계 항목화 방법**: 도구가 있으면 단계마다 한 항목을 만든다(0 브리프 게이트, 1 레퍼런스 조사, 2 방향 결정, 3 디자인 토큰과 예산, 4 구현, 5 프리플라이트 감사, 6 결정을 남긴다). 국소·연장 경로에서 건너뛰는 단계는 항목을 만들지 않거나 "건너뜀 — 이유"로 바로 완료 처리한다. 도구가 없는 하네스에서는 항목화를 생략하고 텍스트로 단계 진행을 보고한다 — 항목화 자체가 게이트 조건은 아니다.
|
||||
|
||||
---
|
||||
|
||||
## 5. 서브에이전트
|
||||
|
||||
| 하네스 | 이름·호출 방식 | 제약 |
|
||||
|---|---|---|
|
||||
| Claude Code | `Agent`(v2.1.63 이전 이름 `Task`, 별칭으로 계속 동작) — 자동 위임, `@agent-<name>` 명시 호출, `claude --agent <name>`(세션 전체 지정) | 병렬 실행 가능. 세션당 동시 서브에이전트 20개 제한(`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`로 조정), 메인 대화 아래 중첩 최대 3단계. `AskUserQuestion` 사용 불가(§3) |
|
||||
| Codex | `multi_agent_v1`/`v2` 네임스페이스(spawn_agent 등, 기본값 비활성·설정으로 켬), 별도로 `codex_delegate`(승인 요청을 절대 보내지 않는 하위 스레드) | 동시 실행 개수 상한이 실제로 존재하는지, GA(정식) 상태인지는 1차 소스로 확인하지 못했다(미확인) — "다수 동시 실행이 무제한 보장된다"고 안내하지 않는다 |
|
||||
| Gemini CLI | 빌트인 4종(`codebase_investigator`, `cli_help`, `generalist`, `browser_agent`) — 자동 위임 또는 프롬프트 맨 앞 `@이름`으로 명시 지정. 커스텀 서브에이전트는 YAML frontmatter가 있는 `.md` 파일(`.gemini/agents/*.md` 또는 `~/.gemini/agents/*.md`) | 사용자에게 직접 질문 가능한지는 미확인(§3) |
|
||||
| VS Code Copilot | 서브에이전트 — 독립적인 조사·분석·리뷰 작업을 수행하고 메인 에이전트에 요약 보고, 대개 에이전트가 주도적으로 위임(agent-initiated) | 무상태(stateless), 후속 메시지 불가. 기본적으로 추가 서브에이전트를 스폰할 수 없다(활성화 가능). 중첩 최대 5단계. 요청 모델은 메인 모델의 비용 등급을 넘을 수 없다. 질문·할 일 도구 사용 불가(§3) |
|
||||
| Zcode | General-Purpose(모든 도구 접근) / Explore(읽기 전용, 파일 생성·수정·이동·삭제 불가) / 커스텀(베타) — 자동 또는 `@`로 수동 지정 | 서브에이전트는 다른 서브에이전트를 스폰할 수 없다. 세션 중간에 연결된 MCP 서버는 서브에이전트에 보이지 않는다. 사용자에게 직접 질문 가능한지는 미확인(§3) |
|
||||
| Windsurf/Cascade, Antigravity | Antigravity는 `/browser` 명령으로 부르는 Browser 서브에이전트를 공식 문서가 확인한다(§6). 그 밖의 서브에이전트 제약은 이번 확인 범위에서 1차 출처를 찾지 못했다(미확인) | — |
|
||||
|
||||
**설계 규칙**: 1단계(레퍼런스 조사)의 R1·R2·R3 실측은 서브에이전트를 지원하면 나눠 맡긴다. 단 **방향 결정과 판정은 항상 메인 세션이 한다** — 서브에이전트는 관찰과 원문 인용을 모아 올 뿐이다. **0단계(브리프 게이트)는 서브에이전트가 대신 끝낼 수 없다.** 위 표의 모든 하네스에서 서브에이전트는 사용자에게 직접 질문하는 경로가 없거나(확인됨) 미확인이므로, 미확인도 안전한 쪽(불가)으로 다룬다(§3-3).
|
||||
|
||||
**오케스트레이터 → 워커**: 디자인 구현을 서브에이전트·외부 워커에 넘길 때는 작업 패킷에 **브리프 카드**(브리프 세 줄, [brief-interview.md](brief-interview.md) §3 슬롯의 확정값, §12 형식의 가정 목록)를 포함한다. 브리프 카드가 없는 패킷은 워커가 사용자 대신 브리프를 다시 추측하게 만든다.
|
||||
|
||||
---
|
||||
|
||||
## 6. 브라우저·시각 도구
|
||||
|
||||
렌더 검증은 실제 브라우저 도구가 있으면 그것을 우선 쓴다. 증거 출처(에뮬레이션·실기기·엔진명)는 보고에 적는다 — "확인함"이라고만 쓰고 무엇으로 확인했는지 적지 않으면 재현할 수 없다.
|
||||
|
||||
| 도구 | 무엇을 하는가 |
|
||||
|---|---|
|
||||
| chrome-devtools MCP `lighthouse_audit` | 접근성·성능 카테고리 자동 감사(Lighthouse) |
|
||||
| chrome-devtools MCP `take_snapshot` | 접근성 트리(이름·역할·상태·랜드마크·헤딩) 스냅샷 |
|
||||
| chrome-devtools MCP `take_screenshot` | 실제 렌더 스크린샷 |
|
||||
| playwright MCP | 탐색·클릭·폼 입력·스크린샷·콘솔/네트워크 로그를 포함한 브라우저 자동화 |
|
||||
| Codex `view_image` | 로컬 파일시스템의 이미지 경로를 받아 시각적으로 확인한다(디스크에 이미 있는 이미지 전용 — 페이지를 직접 탐색하지 않는다) |
|
||||
| Gemini CLI `browser_agent` | 빌트인 서브에이전트로 브라우저 작업을 위임한다 |
|
||||
| Antigravity Browser 서브에이전트 | `/browser` 명령으로 호출하며 Chrome DevTools MCP와 네이티브로 통합되고 webm 녹화를 지원한다 |
|
||||
|
||||
**위 도구가 하나도 없으면** `designpaca tools`로 설치되는 headed 브라우저(방법은 `galleries.md` §5)와 `tools/design-gate.mjs`를 쓴다. design-gate.mjs가 하는 일과 한계는 [audit-gate.md](audit-gate.md)를 따른다 — 자동 검사는 계측이고 계측에는 공백이 있다는 원칙이 여기서도 그대로 적용된다.
|
||||
|
||||
---
|
||||
|
||||
## 7. 모드 안내
|
||||
|
||||
세션이 어떤 모드인지 한 줄로 먼저 확인한다.
|
||||
|
||||
- **Claude Code**: `auto` 모드는 "질문 없이 계속 진행"을 권하지만, 공식 문서 자체가 "스킬이 명시적으로 의존하면 묻는다"는 탈출구를 남겨 둔다. 이 스킬은 [SKILL.md 인터뷰 게이트](../SKILL.md)에서 그 의존을 명시적으로 선언했으므로, `auto` 모드에서도 0단계는 그대로 수행한다. Plan mode는 `EnterPlanMode`/`ExitPlanMode`(Shift+Tab 반복 또는 `--permission-mode plan`)로 켜며, §4의 계획 도구와 함께 쓰면 단계 진행을 사용자에게 보여주기 좋다.
|
||||
- **Codex**: 긴 디자인 작업은 Plan 모드로 시작하기를 권한다. Plan 모드에서는 `request_user_input`이 기본 허용되어 선택지 UI로 답할 수 있다. Default 모드는 기능 플래그가 없으면 질문 도구가 없다(§1).
|
||||
- **Gemini CLI**: Plan 모드가 기본이다. Plan을 벗어나 YOLO로 전환하면 질문 라운드와 승인 절차가 함께 약해진다는 것을 인지하고 진행한다.
|
||||
- **Cursor**: Plan 모드에서만 질문 흐름이 하네스에 의해 주입된다. Agent 모드에서 디자인 브리프 작업을 시작하게 되면 평문 폴백으로 0단계를 수행한다.
|
||||
|
||||
---
|
||||
|
||||
## 8. frontmatter는 하네스 공통 필드만 쓴다
|
||||
|
||||
이 스킬의 frontmatter는 `name`·`description`만 쓴다. Claude 전용 필드(`allowed-tools`, `context: fork`, 동적 명령 주입 `!command`)를 넣지 않는 이유는 다음과 같다.
|
||||
|
||||
1. **다른 하네스에서 무력화되거나 오작동한다.** Codex·Cursor·Gemini CLI 등은 이런 필드를 인식하지 않거나 다른 의미로 해석할 수 있다. 한 하네스에 맞춘 필드를 나머지 9개 설치 타깃에 그대로 복사하면, 해당 필드가 조용히 무시되거나(정보 손실 없이 끝나면 그나마 안전) 예상 밖으로 동작한다.
|
||||
2. **`context: fork`는 `AskUserQuestion`을 깨뜨린다.** 공개 이슈 #19751(§9)이 이를 확인한다. 이 스킬은 0단계 인터뷰에 명시적으로 의존하므로, 인터뷰 도구를 깨뜨릴 수 있는 필드는 애초에 후보가 아니다.
|
||||
3. **`allowed-tools`는 Claude Code 전용 권한 부여다.** 스킬을 호출한 턴 동안 특정 도구를 묻지 않고 쓰게 하는 필드인데, 다른 하네스에서는 의미가 없고 이 스킬은 특정 명령을 사전 허용할 필요가 없다.
|
||||
|
||||
---
|
||||
|
||||
## 9. 출처 표
|
||||
|
||||
| 주장 | URL | 확인일 |
|
||||
|---|---|---|
|
||||
| Claude Code Task 도구 4종·TodoWrite·모델별 가용성 | https://code.claude.com/docs/en/sdk/sdk-todo-tracking | 2026-09-24 |
|
||||
| Claude Code Plan mode(EnterPlanMode/ExitPlanMode) | https://code.claude.com/docs/en/common-workflows | 2026-09-24 |
|
||||
| Claude Code `Agent`(서브에이전트, 구 `Task`) 이름 변경·동시 실행 제한·중첩 깊이 | https://code.claude.com/docs/en/sub-agents | 2026-09-24 |
|
||||
| Claude Code `AskUserQuestion`과 서브에이전트 제외 | https://code.claude.com/docs/en/sub-agents | 2026-09-24 |
|
||||
| Claude Agent SDK `canUseTool`의 `AskUserQuestion` 처리(질문·응답 페이로드 형식) | https://code.claude.com/docs/en/agent-sdk/user-input | 2026-09-24 |
|
||||
| Claude Code `auto` 모드가 Pro·Max·Team 기본 시작 모드, 버전 조건(v2.1.228/v2.1.233), "nudges Claude to keep working…" 인용문 | https://code.claude.com/docs/en/permission-modes | 2026-09-24 |
|
||||
| Claude Code `auto` 모드 기본값 전환 날짜("Starting on August 14, new sessions on Pro, Max, and Team plans will run in auto mode.") | https://claude.com/blog/auto-mode-default-in-claude-code | 2026-09-24 |
|
||||
| Claude Code `context: fork` 스킬이 `AskUserQuestion`을 깨뜨리는 버그(이슈 #19751, Duplicate로 종료) | https://github.com/anthropics/claude-code/issues/19751 | 2026-09-24 |
|
||||
| Codex `update_plan`(Plan 모드와 별개, Plan 모드 중 오류) | https://raw.githubusercontent.com/openai/codex/main/codex-rs/collaboration-mode-templates/templates/plan.md | 2026-09-24 |
|
||||
| Codex `view_image` 도구 | https://raw.githubusercontent.com/openai/codex/main/codex-rs/core/src/tools/handlers/view_image_spec.rs | 2026-09-24 |
|
||||
| Codex 멀티에이전트 네임스페이스(v1/v2, 기본 비활성) | https://raw.githubusercontent.com/openai/codex/main/codex-rs/core/src/tools/handlers/multi_agents_spec.rs | 2026-09-24 |
|
||||
| Codex `codex_delegate`(승인 요청 없는 하위 스레드) | https://raw.githubusercontent.com/openai/codex/main/codex-rs/core/src/codex_delegate.rs | 2026-09-24 |
|
||||
| Codex `request_user_input`(선택지 2~3, 기능 플래그) | https://raw.githubusercontent.com/openai/codex/main/codex-rs/core/src/tools/handlers/request_user_input_spec.rs | 2026-09-24 |
|
||||
| Codex `codex exec` 비대화형 모드의 서버 요청 즉시 거부 | https://github.com/openai/codex/blob/main/codex-rs/exec/src/lib.rs | 2026-09-24 |
|
||||
| Gemini CLI `write_todos` | https://geminicli.com/docs/tools/todos/ | 2026-09-24 |
|
||||
| Gemini CLI 빌트인 서브에이전트 4종·호출 방식 | https://geminicli.com/docs/core/subagents/ | 2026-09-24 |
|
||||
| Gemini CLI YOLO 모드에서 `ask_user` 빈 답 자동 통과 버그(이슈 #18540, Closed) | https://github.com/google-gemini/gemini-cli/issues/18540 | 2026-09-24 |
|
||||
| Cursor Plan Mode 활성화, 전용 질문 도구명 미기재 | https://cursor.com/docs/agent/plan-mode | 2026-09-24 |
|
||||
| VS Code Copilot Plan mode 활성화 | https://code.visualstudio.com/docs/copilot/agents/planning | 2026-09-24 |
|
||||
| VS Code `askQuestions` 도구의 코어 편입(질문 캐러셀, Alt+N/Alt+P, 위치 안내) | https://code.visualstudio.com/updates/v1_110 | 2026-09-24 |
|
||||
| VS Code Copilot 서브에이전트 제약(질문·할 일 도구 사용 불가, 무상태, 중첩 5단계) | https://code.visualstudio.com/docs/agents/run/subagents | 2026-09-24 |
|
||||
| Zcode Goal Mode 명령 체계 | https://zcode.z.ai/en/docs/goal | 2026-09-24 |
|
||||
| Zcode 서브에이전트 종류·제약 | https://zcode.z.ai/en/docs/subagents | 2026-09-24 |
|
||||
| Antigravity `/plan`·Implementation Plan·Browser 서브에이전트 | https://antigravity.google/docs/features/ | 2026-09-24 |
|
||||
| Windsurf/Cascade 서브에이전트·투두 도구(1차 확인 실패, 미확인으로 남김) | https://docs.devin.ai/desktop/cascade/mcp | 2026-09-24 |
|
||||
| Gemini CLI Plan 모드 기본 활성·YOLO 전환 | https://raw.githubusercontent.com/google-gemini/gemini-cli/main/docs/cli/plan-mode.md | 2026-09-24 |
|
||||
| Gemini CLI `ask_user` | https://geminicli.com/docs/tools/ask-user/ | 2026-09-24 |
|
||||
| Codex Prompting Guide "Bias to action" | https://developers.openai.com/cookbook/examples/gpt-5/codex_prompting_guide | 2026-09-24 |
|
||||
| Codex 내장 프롬프트 "Autonomy and Persistence" | https://raw.githubusercontent.com/openai/codex/main/codex-rs/core/gpt_5_1_prompt.md | 2026-09-24 |
|
||||
| Codex `request_user_input` 자동 해제(autoResolution) 60~240초 | https://github.com/openai/codex/pull/27256 , https://github.com/openai/codex/pull/28235 | 2026-09-24 |
|
||||
|
||||
세부 인용문 일부는 `outputs/skill-intake/p0/facts.json`에, 나머지는 위 표의 URL 원문에 있다. 재확인할 때는 이 표의 URL을 다시 연다.
|
||||
Loading…
Add table
Add a link
Reference in a new issue