jpskill.com
🛠️ 開発・MCP コミュニティ

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本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux
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
🪟 Windows (PowerShell)
$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. 1. 下の青いボタンを押して day3-clarify.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → day3-clarify フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

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 から。                │
└──────────────────────────────────────────────────────────┘

核心禁止事項 (絶対違反禁止)

  1. Phase A で AskUserQuestion を呼び出さない — 説明 + 実行案内後すぐに Stop
  2. Phase A でクイズを出さない — QUIZ セクションは Phase B でのみ読む
  3. Phase A で「実行しましたか?」と尋ねない — ユーザーが先に言うまで待つ
  4. 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부터.                │
└──────────────────────────────────────────────────────────┘

핵심 금지 사항 (절대 위반 금지)

  1. Phase A에서 AskUserQuestion을 호출하지 않는다 — 설명 + 실행 안내 후 바로 Stop
  2. Phase A에서 퀴즈를 내지 않는다 — QUIZ 섹션은 Phase B에서만 읽는다
  3. Phase A에서 "실행해봤나요?"를 묻지 않는다 — 사용자가 먼저 말할 때까지 기다린다
  4. 한 턴에 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` 本体に加え、参考資料・サンプル・スクリプトが入っている場合があります。