day3-clarify
Clarifyプラグインを活用し、曖昧な要求を明確化、独自のスキル構築、PRD作成を通じて、GitHubへの最初のプルリクエスト提出を支援するSkill。
📜 元の英語説明(参考)
AI Native Camp Day 3 Clarify & GitHub. Clarify 플러그인으로 모호한 요구사항을 명확하게 만들고, 나만의 스킬을 만들고, PRD를 작성하여 GitHub에 첫 PR을 제출한다. "3일차", "Day 3", "clarify", "클래리파이", "PRD", "GitHub" 요청에 사용.
🇯🇵 日本人クリエイター向け解説
Clarifyプラグインを活用し、曖昧な要求を明確化、独自のスキル構築、PRD作成を通じて、GitHubへの最初のプルリクエスト提出を支援するSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o day3-clarify.zip https://jpskill.com/download/16457.zip && unzip -o day3-clarify.zip && rm day3-clarify.zip
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/16457.zip -OutFile "$d\day3-clarify.zip"; Expand-Archive "$d\day3-clarify.zip" -DestinationPath $d -Force; ri "$d\day3-clarify.zip"
完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
day3-clarify.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
day3-clarifyフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-18
- 取得日時
- 2026-05-18
- 同梱ファイル
- 6
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
Day 3: Clarify
このスキルが呼び出されたら、下記の STOP PROTOCOL を必ず守ってください。
用語整理
| 用語 | 説明 |
|---|---|
| Clarify | 曖昧な要求事項を明確にする過程。Claudeが質問を投げかけ、暗黙知を明示知に変換します |
| AskUserQuestion | Claudeがユーザーに構造化された質問をするツール。選択肢を提示して認知負荷を減らします |
| Hypothesis-as-Options | 開かれた質問の代わりに仮説を選択肢として提示する原則。「何が欲しいですか?」ではなく「A / B / C のどれですか?」 |
| Plugin | Skill + MCP + Hook + Agent を一つのインストール単位としてまとめたパッケージ |
| Known/Unknown | 戦略の死角を探す4象限フレームワーク (KK/KU/UK/UU) |
| Before/After | Clarify 前後の要求事項を比較して変化を可視化するフォーマット |
| PRD | Product Requirements Document。「このプロジェクトが何を解決し、何を作るのか」をまとめた文書 |
| GitHub | コードとドキュメントを一緒に管理し共有するオンラインサービス。Google Docs のコード版 |
| PR (Pull Request) | 「私の作業を確認してください」と運営陣に送るレビュー依頼。提出ボタンと同じ |
STOP PROTOCOL — 絶対違反禁止
このプロトコルはこのスキルの最優先ルールです。 下記のルールを違反すると授業が台無しになります。
各ブロックは必ず2ターンに分けて進行する
┌─ Phase A (最初のターン) ──────────────────────────────┐
│ 1. references/ から該当ブロックファイルの EXPLAIN セクションを読む │
│ 2. 機能を説明する │
│ 3. references/ から該当ブロックファイルの EXECUTE セクションを読む │
│ 4. 「今すぐ直接実行してみてください」と案内する │
│ 5. ⛔ ここで必ず STOP。ターンを終了する。 │
│ │
│ ❌ 絶対にしないこと: クイズの出題、QUIZ セクションを読む │
│ ❌ 絶対にしないこと: AskUserQuestion を呼び出す │
│ ❌ 絶対にしないこと: 「実行しましたか?」と質問する │
└──────────────────────────────────────────────────────────┘
⬇️ ユーザーが戻ってきて「やった」、「完了」、「次」などを入力する
┌─ Phase B (2番目のターン) ──────────────────────────────┐
│ 1. references/ から該当ブロックファイルの QUIZ セクションを読む │
│ 2. AskUserQuestion でクイズを出題する │
│ 3. 正解/不正解のフィードバックを与える │
│ 4. 次のブロックに移動するか AskUserQuestion で尋ねる │
│ 5. ⛔ 次のブロックを開始すると再び Phase A から。 │
└──────────────────────────────────────────────────────────┘
核心禁止事項 (絶対違反禁止)
- Phase A で AskUserQuestion を呼び出さない — 説明 + 実行案内後すぐに Stop
- Phase A でクイズを出さない — QUIZ セクションは Phase B でのみ読む
- Phase A で「実行しましたか?」と尋ねない — ユーザーが先に言うまで待つ
- 1ターンに EXPLAIN + QUIZ を同時に行わない — 必ず2ターンに分ける
Phase A 終了時の必須文言
Phase A の最後には必ず下記のような文言を出力して Stop します:
---
👆 上記の内容を直接実行してみてください。
実行が終わったら「完了」または「次」と入力してください。
この文言以降に、いかなるツール呼び出し(AskUserQuestion を含む)や追加テキストも出力しません。
ブロック特殊ルール
- Block 0 (Concept): 標準 Phase A/B。AskUserQuestion 体験が EXECUTE の核心。
- Block 1 (Experience Vague): 例外 — Phase A で Claude が clarify:vague プロトコルをデモンストレーションします。学生が曖昧な要求事項を投げかけると Claude が AskUserQuestion で clarify します。学生は「clarify を受ける人」の役割。
- Block 2 (Build Clarify): 標準ですが EXECUTE でプラグインの vague SKILL.md を Read で分析した後、テンプレートベースで自分だけのスキルを作成します。
- Block 3 (Plugin & Unknown): メインブロック — Plugin 深堀り分析 + clarify:unknown 体験。
- Block 4 (PRD & GitHub): 標準 Phase A/B ですが PRD 作成はインタラクティブ。Claude が GitHub ID 確認 → PRD 草案作成 → 検証 → PR 提出まで自動的に進行。Phase B クイズ後 Day 3 課題案内。
所要時間
| Block | テーマ | 時間 |
|---|---|---|
| 0 | Clarify 概念 + AskUserQuestion | ~10分 |
| 1 | clarify:vague 体験 | ~15分 |
| 2 | 自分だけの Clarify スキル作成 | ~25分 |
| 3 | Plugin 深堀り + clarify:unknown 体験 | ~30分 |
| 4 | PRD 作成 & GitHub 初提出 + 課題 | ~15分 |
| 合計 | ~95分 |
核心戦略
「インストールしたプラグインを解剖し、直接作ってみる」
Day 1 でインストールした clarify プラグインを体験 → 構造分析 → 自分だけのバージョン製作 → 深堀り活用
Day 1 でインストール Day 3 で深く掘り下げる
┌──────────────┐ ┌──────────────────────────┐
│ /plugin │ │ Block 0: 概念理解 │
│ install │ ───▶ │ Block 1: vague 体験 │
│ clarify │ │ Block 2: 自分だけのスキル製作 │
└──────────────┘ │ Block 3: Plugin 解剖 + │
│ unknown 体験 │
│ Block 4: PRD + GitHub 提出 │
└──────────────────────────┘
References ファイルマップ
| ブロック | ファイル |
|---|---|
| Block 0 | references/block0-concept.md |
| Block 1 | references/block1-experience-vague.md |
| Block 2 | references/block2-build-clarify.md |
| Block 3 | references/block3-plugin-and-unknown.md |
| Block 4 | references/block4-prd-and-github.md |
ファイルパスはこの SKILL.md 基準の相対パスです。 各 reference ファイルは
## EXPLAIN、## EXECUTE、## QUIZセクションで構成されます。
Templates ファイルマップ
| ファイル | 用途 |
|---|---|
templates/clarify-vague.md |
自分だけの Clarify スキル作成用テンプレート |
進行ルール
- 一度に一つのブロックずつ進行する
- 「次」、「skip」、ブロック番号/名前で移動する
- Claude Code 関連の質問が来たら claude-code-guide エージェント(内蔵ツール)で回答する。回答後、ユーザーが直接真似できるように段階別に案内し、質問する時は AskUserQuestion を使用する。内蔵エージェントの回答が不正確だと判断されたら、公式ドキュメントを
curlでファイルに保存した後、Read ツールで丁寧に読んで正確な情報で再び答える (WebFetch は要約/損失の危険があるので使用しない)
開始
スキル開始時、下記を案内し AskUserQuestion でどこから始めるか尋ねます。
まだ camp-2 スキルがインストールされていない場合は:
npx skills add ai-native-camp/camp-2
| Block | テーマ | 内容 |
|---|---|---|
| 0 | Concept | Clarify 概念 + AskUserQuestion 体験 |
| 1 | Experience | clarify:vague プラグイン体験 |
| 2 | Build | 自分だけの Clarify スキル作成 |
| 3 | Plugin & Unknown | Plugin 深堀り + clarify:unknown |
| 4 | PRD & GitHub | PRD 作成 + GitHub 初 PR 提出 + 課題 |
AskUserQuestion({
"questions": [{
"question": "どこから始めますか?",
"header": "開始ブロック",
"options": [
{"label": "Block 0: Concept", "description": "Clarify 概念 + AskUserQuestion 体験"},
{"label": "Block 1: Experience", "description": "clarify:vague プラグイン体験"},
{"label": "Block 2: Build", "description": "自分だけの Clarify スキル作成"},
{"label": "Block 3: Plugin & Unknown", "description": "Plugin 深堀り + unknown 体験"},
{"label": "Block 4: PRD & GitHub", "description": "PRD 作成 + GitHub 初 PR 提出"}
],
"multiSelect": false
}]
})
開始ブロック選択後 → 該当ブロックの Phase A から進行します。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Day 3: Clarify
이 스킬이 호출되면 아래 STOP PROTOCOL을 반드시 따른다.
용어 정리
| 용어 | 설명 |
|---|---|
| Clarify | 모호한 요구사항을 명확하게 만드는 과정. Claude가 질문을 던져서 암묵지를 명시지로 변환한다 |
| AskUserQuestion | Claude가 사용자에게 구조화된 질문을 하는 도구. 선택지를 제시하여 인지 부하를 줄인다 |
| Hypothesis-as-Options | 열린 질문 대신 가설을 선택지로 제시하는 원칙. "뭘 원해요?" 대신 "A / B / C 중 어떤 건가요?" |
| Plugin | Skill + MCP + Hook + Agent를 하나의 설치 단위로 묶은 패키지 |
| Known/Unknown | 전략의 사각지대를 찾는 4분면 프레임워크 (KK/KU/UK/UU) |
| Before/After | Clarify 전후의 요구사항을 비교하여 변화를 시각화하는 포맷 |
| PRD | Product Requirements Document. "이 프로젝트가 뭘 해결하고, 뭘 만드는지" 정리한 문서 |
| GitHub | 코드와 문서를 함께 관리하고 공유하는 온라인 서비스. Google Docs의 코드 버전 |
| PR (Pull Request) | "내 작업을 확인해주세요"라고 운영진에게 보내는 검토 요청. 제출 버튼과 같다 |
STOP PROTOCOL — 절대 위반 금지
이 프로토콜은 이 스킬의 최우선 규칙이다. 아래 규칙을 위반하면 수업이 망가진다.
각 블록은 반드시 2턴에 걸쳐 진행한다
┌─ Phase A (첫 번째 턴) ──────────────────────────────┐
│ 1. references/에서 해당 블록 파일의 EXPLAIN 섹션을 읽는다 │
│ 2. 기능을 설명한다 │
│ 3. references/에서 해당 블록 파일의 EXECUTE 섹션을 읽는다 │
│ 4. "지금 직접 실행해보세요"라고 안내한다 │
│ 5. ⛔ 여기서 반드시 STOP. 턴을 종료한다. │
│ │
│ ❌ 절대 하지 않는 것: 퀴즈 출제, QUIZ 섹션 읽기 │
│ ❌ 절대 하지 않는 것: AskUserQuestion 호출 │
│ ❌ 절대 하지 않는 것: "실행해봤나요?" 질문 │
└──────────────────────────────────────────────────────────┘
⬇️ 사용자가 돌아와서 "했어", "완료", "다음" 등을 입력한다
┌─ Phase B (두 번째 턴) ──────────────────────────────┐
│ 1. references/에서 해당 블록 파일의 QUIZ 섹션을 읽는다 │
│ 2. AskUserQuestion으로 퀴즈를 출제한다 │
│ 3. 정답/오답 피드백을 준다 │
│ 4. 다음 블록으로 이동할지 AskUserQuestion으로 묻는다 │
│ 5. ⛔ 다음 블록을 시작하면 다시 Phase A부터. │
└──────────────────────────────────────────────────────────┘
핵심 금지 사항 (절대 위반 금지)
- Phase A에서 AskUserQuestion을 호출하지 않는다 — 설명 + 실행 안내 후 바로 Stop
- Phase A에서 퀴즈를 내지 않는다 — QUIZ 섹션은 Phase B에서만 읽는다
- Phase A에서 "실행해봤나요?"를 묻지 않는다 — 사용자가 먼저 말할 때까지 기다린다
- 한 턴에 EXPLAIN + QUIZ를 동시에 하지 않는다 — 반드시 2턴으로 나눈다
Phase A 종료 시 필수 문구
Phase A의 마지막에는 반드시 아래 형태의 문구를 출력하고 Stop한다:
---
👆 위 내용을 직접 실행해보세요.
실행이 끝나면 "완료" 또는 "다음"이라고 입력해주세요.
이 문구 이후에 어떤 도구 호출(AskUserQuestion 포함)이나 추가 텍스트도 출력하지 않는다.
블록 특수 규칙
- Block 0 (Concept): 표준 Phase A/B. AskUserQuestion 체험이 EXECUTE의 핵심.
- Block 1 (Experience Vague): 예외 — Phase A에서 Claude가 clarify:vague 프로토콜을 시연한다. 학생이 모호한 요구사항을 던지면 Claude가 AskUserQuestion으로 clarify한다. 학생은 "clarify 받는 사람" 역할.
- Block 2 (Build Clarify): 표준이지만 EXECUTE에서 플러그인의 vague SKILL.md를 Read로 분석한 후, 템플릿 기반으로 나만의 스킬을 작성한다.
- Block 3 (Plugin & Unknown): 메인 블록 — Plugin 심화 분석 + clarify:unknown 체험.
- Block 4 (PRD & GitHub): 표준 Phase A/B이지만 PRD 작성은 인터랙티브. Claude가 GitHub ID 확인 → PRD 초안 작성 → 검증 → PR 제출까지 자동으로 진행. Phase B 퀴즈 후 Day 3 과제 안내.
소요 시간
| Block | 주제 | 시간 |
|---|---|---|
| 0 | Clarify 개념 + AskUserQuestion | ~10분 |
| 1 | clarify:vague 체험 | ~15분 |
| 2 | 나만의 Clarify 스킬 만들기 | ~25분 |
| 3 | Plugin 심화 + clarify:unknown 체험 | ~30분 |
| 4 | PRD 작성 & GitHub 첫 제출 + 과제 | ~15분 |
| 합계 | ~95분 |
핵심 전략
"설치한 플러그인을 해부하고, 직접 만들어보기"
Day 1에서 설치한 clarify 플러그인을 체험 → 구조 분석 → 나만의 버전 제작 → 심화 활용
Day 1에서 설치 Day 3에서 깊이 파기
┌──────────────┐ ┌──────────────────────────┐
│ /plugin │ │ Block 0: 개념 이해 │
│ install │ ───▶ │ Block 1: vague 체험 │
│ clarify │ │ Block 2: 나만의 스킬 제작 │
└──────────────┘ │ Block 3: Plugin 해부 + │
│ unknown 체험 │
│ Block 4: PRD + GitHub 제출 │
└──────────────────────────┘
References 파일 맵
| 블록 | 파일 |
|---|---|
| Block 0 | references/block0-concept.md |
| Block 1 | references/block1-experience-vague.md |
| Block 2 | references/block2-build-clarify.md |
| Block 3 | references/block3-plugin-and-unknown.md |
| Block 4 | references/block4-prd-and-github.md |
파일 경로는 이 SKILL.md 기준 상대경로다. 각 reference 파일은
## EXPLAIN,## EXECUTE,## QUIZ섹션으로 구성된다.
Templates 파일 맵
| 파일 | 용도 |
|---|---|
templates/clarify-vague.md |
나만의 Clarify 스킬 작성용 템플릿 |
진행 규칙
- 한 번에 한 블록씩 진행한다
- "다음", "skip", 블록 번호/이름으로 이동한다
- Claude Code 관련 질문이 오면 claude-code-guide 에이전트(내장 도구)로 답변한다. 답변 후 사용자가 직접 따라할 수 있게 단계별로 안내하고, 질문할 때는 AskUserQuestion을 사용한다. 내장 에이전트 답변이 부정확하다고 판단되면, 공식 문서를
curl로 파일에 저장한 뒤 Read 툴로 꼼꼼히 읽고 정확한 정보로 다시 답한다 (WebFetch는 요약/손실 위험이 있으므로 사용하지 않는다)
시작
스킬 시작 시 아래를 안내하고 AskUserQuestion으로 어디서 시작할지 물어본다.
아직 camp-2 스킬이 설치되지 않았다면:
npx skills add ai-native-camp/camp-2
| Block | 주제 | 내용 |
|---|---|---|
| 0 | Concept | Clarify 개념 + AskUserQuestion 체험 |
| 1 | Experience | clarify:vague 플러그인 체험 |
| 2 | Build | 나만의 Clarify 스킬 만들기 |
| 3 | Plugin & Unknown | Plugin 심화 + clarify:unknown |
| 4 | PRD & GitHub | PRD 작성 + GitHub 첫 PR 제출 + 과제 |
AskUserQuestion({
"questions": [{
"question": "어디서부터 시작할까요?",
"header": "시작 블록",
"options": [
{"label": "Block 0: Concept", "description": "Clarify 개념 + AskUserQuestion 체험"},
{"label": "Block 1: Experience", "description": "clarify:vague 플러그인 체험"},
{"label": "Block 2: Build", "description": "나만의 Clarify 스킬 만들기"},
{"label": "Block 3: Plugin & Unknown", "description": "Plugin 심화 + unknown 체험"},
{"label": "Block 4: PRD & GitHub", "description": "PRD 작성 + GitHub 첫 PR 제출"}
],
"multiSelect": false
}]
})
시작 블록 선택 후 → 해당 블록의 Phase A부터 진행한다.
同梱ファイル
※ ZIPに含まれるファイル一覧。`SKILL.md` 本体に加え、参考資料・サンプル・スクリプトが入っている場合があります。
- 📄 SKILL.md (9,173 bytes)
- 📎 references/block0-concept.md (10,364 bytes)
- 📎 references/block1-experience-vague.md (4,446 bytes)
- 📎 references/block2-build-clarify.md (5,219 bytes)
- 📎 references/block3-plugin-and-unknown.md (10,853 bytes)
- 📎 references/block4-prd-and-github.md (7,604 bytes)