SuperAPI AI Directory

day3-clarify

General & other

View repository

Updated 10-15 16:43

About this skill

Day 3: Clarify

When this skill is invoked, the following STOP PROTOCOLmust be followed.


Terminology

Term Description
Clarify The process of making vague requirements clear. Claude asks questions to convert tacit knowledge into explicit knowledge
AskUserQuestion A tool where Claude asks the user structured questions. It reduces cognitive load by presenting options
Hypothesis-as-Options The principle of presenting hypotheses as options instead of open questions. Instead of "What do you want?", "Which of A / B / C is it?"
Plugin A package that bundles Skill + MCP + Hook + Agent into a single installation unit
Known/Unknown A four-quadrant framework for finding blind spots in strategy (KK/KU/UK/UU)
Before/After A format for visualizing changes by comparing requirements before and after Clarify
PRD Product Requirements Document. A document that organizes "what this project solves and what it builds"
GitHub An online service for managing and sharing code and documents together. The code version of Google Docs
PR (Pull Request) A review request sent to the instructors saying "Please check my work." It is like a submit button

STOP PROTOCOL — Never Violate

This protocol is the highest-priority rule of this skill. Violating the rules below will ruin the class.

Each block must proceed over exactly 2 turns

┌─ 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부터.                │
└──────────────────────────────────────────────────────────┘

Key Prohibitions (Never Violate)

  1. Do not call AskUserQuestion in Phase A — After explanation + execution guidance, Stop immediately
  2. Do not give a quiz in Phase A — Read the QUIZ section only in Phase B
  3. Do not ask "Did you try running it?" in Phase A — Wait until the user speaks first
  4. Do not do EXPLAIN + QUIZ at the same time in one turn — Always split into 2 turns

Required Phrase at the End of Phase A

At the end of Phase A, always output a phrase in the form below and Stop:

---
👆 위 내용을 직접 실행해보세요.
실행이 끝나면 "완료" 또는 "다음"이라고 입력해주세요.

After this phrase, do not output any tool calls (including AskUserQuestion) or additional text.

Block-Specific Rules

  • Block 0 (Concept): Standard Phase A/B. Experiencing AskUserQuestion is the core of EXECUTE.
  • Block 1 (Experience Vague): Exception — In Phase A, Claude demonstrates the clarify:vague protocol. When the student throws out a vague requirement, Claude clarifies it with AskUserQuestion. The student plays the role of the "person receiving clarify."
  • Block 2 (Build Clarify): Standard, but in EXECUTE, after analyzing the plugin's vague SKILL.md with Read, write your own skill based on the template.
  • Block 3 (Plugin & Unknown): Main Block — In-depth plugin analysis + clarify:unknown experience.
  • Block 4 (PRD & GitHub): Standard Phase A/B, but PRD writing is interactive. Claude automatically proceeds from verifying GitHub ID → drafting PRD → validation → submitting PR. After the Phase B quiz, guidance for the Day 3 assignment.

Duration

Block Topic Time
0 Clarify concept + AskUserQuestion ~10분
1 clarify:vague hands-on ~15분
2 Create your own Clarify skill ~25분
3 Plugin deep dive + clarify:unknown hands-on ~30분
4 PRD writing & first GitHub submission + assignment ~15분
Total ~95분

Core Strategy

"Dissect the installed plugin, and try building your own"

Experience the clarify plugin installed on Day 1 → analyze its structure → create your own version → advanced usage

Day 1에서 설치          Day 3에서 깊이 파기
┌──────────────┐       ┌──────────────────────────┐
│ /plugin      │       │ Block 0: 개념 이해        │
│   install    │  ───▶ │ Block 1: vague 체험       │
│   clarify    │       │ Block 2: 나만의 스킬 제작  │
└──────────────┘       │ Block 3: Plugin 해부 +    │
                       │          unknown 체험     │
                       │ Block 4: PRD + GitHub 제출 │
                       └──────────────────────────┘

References file map

Block File
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

File paths are relative to this SKILL.md. Each reference file consists of the ## EXPLAIN, ## EXECUTE, ## QUIZ section.


Templates file map

File Purpose
templates/clarify-vague.md Template for writing your own Clarify skill

Progress rules

  • Proceed one block at a time
  • Move with "next", "skip", or a block number/name
  • When a question about Claude Code comes up, answer using the claude-code-guide agent (built-in tool). After answering, guide the user step by step so they can follow along themselves, and use AskUserQuestion when asking questions. If you judge that the built-in agent's answer is inaccurate, save the official documentation to a file at curland then read it carefully with the Read tool and answer again with accurate information (do not use WebFetch, as it risks summarization/loss)

Start

When the skill starts, explain the following and ask with AskUserQuestion where to begin.

If the camp-2 skill is not yet installed:

npx skills add ai-native-camp/camp-2
Block Topic Content
0 Concept Clarify concept + AskUserQuestion hands-on
1 Experience clarify:vague plugin hands-on
2 Build Create your own Clarify skill
3 Plugin & Unknown Plugin deep dive + clarify:unknown
4 PRD & GitHub PRD writing + first GitHub PR submission + assignment
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
  }]
})

After selecting a start block → proceed from that block's Phase A.