day3-clarify by ai-native-camp/camp-2
npx skills add https://github.com/ai-native-camp/camp-2 --skill day3-clarify이 스킬이 호출되면 아래 STOP PROTOCOL 을 반드시 따른다.
| 术语 | 说明 |
|---|---|
| Clarify | 将模糊需求明确化的过程。Claude通过提问将隐性知识转化为显性知识 |
| AskUserQuestion | Claude向用户提出结构化问题的工具。通过提供选项来降低认知负荷 |
| Hypothesis-as-Options | 用假设作为选项而非开放式提问的原则。不是问"你想要什么?",而是问"是A/B/C中的哪一个?" |
| Plugin | 将 Skill + MCP + Hook + Agent 打包成一个安装单元的包 |
| Known/Unknown | 用于发现策略盲区的四象限框架 (KK/KU/UK/UU) |
| Before/After | 通过比较 Clarify 前后的需求来可视化变化的格式 |
| PRD | 产品需求文档。整理"这个项目要解决什么问题,要做什么"的文档 |
| GitHub | 共同管理和共享代码与文档的在线服务。相当于代码版的 Google Docs |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| PR (Pull Request) | 向维护者发送的"请检查我的工作"的审查请求。相当于提交按钮 |
此协议是本技能的最高优先规则。违反以下规则会导致课程失败。
┌─ 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 的最后必须输出以下形式的语句并 Stop:
---
👆 请亲自执行以上内容。
执行结束后,请输入"完成"或"下一步"。
此语句之后不输出任何工具调用(包括 AskUserQuestion)或附加文本。
| 区块 | 主题 | 时间 |
|---|---|---|
| 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 提交 │
└──────────────────────────┘
| 区块 | 文件 |
|---|---|
| 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/clarify-vague.md | 用于编写自己的 Clarify 技能的模板 |
curl 将官方文档保存到文件,然后用 Read 工具仔细阅读,用准确信息重新回答(不使用 WebFetch,因为有摘要/丢失风险)技能开始时引导以下内容,并用 AskUserQuestion 询问从哪里开始。
如果尚未安装 camp-2 技能:
npx skills add ai-native-camp/camp-2
| 区块 | 主题 | 内容 |
|---|---|---|
| 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 开始进行。
Weekly Installs
338
Repository
GitHub Stars
9
First Seen
11 days ago
Security Audits
Installed on
claude-code334
opencode19
codex19
github-copilot18
kimi-cli18
gemini-cli18
이 스킬이 호출되면 아래 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) | "내 작업을 확인해주세요"라고 운영진에게 보내는 검토 요청. 제출 버튼과 같다 |
이 프로토콜은 이 스킬의 최우선 규칙이다. 아래 규칙을 위반하면 수업이 망가진다.
┌─ 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의 마지막에는 반드시 아래 형태의 문구를 출력하고 Stop한다:
---
👆 위 내용을 직접 실행해보세요.
실행이 끝나면 "완료" 또는 "다음"이라고 입력해주세요.
이 문구 이후에 어떤 도구 호출(AskUserQuestion 포함)이나 추가 텍스트도 출력하지 않는다.
| 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 제출 │
└──────────────────────────┘
| 블록 | 파일 |
|---|---|
| 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/clarify-vague.md | 나만의 Clarify 스킬 작성용 템플릿 |
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부터 진행한다.
Weekly Installs
338
Repository
GitHub Stars
9
First Seen
11 days ago
Security Audits
Gen Agent Trust HubPassSocketWarnSnykWarn
Installed on
claude-code334
opencode19
codex19
github-copilot18
kimi-cli18
gemini-cli18
超能力技能使用指南:AI助手技能调用优先级与工作流程详解
39,200 周安装
FlowStudio MCP 构建部署 Power Automate 云流指南 | 自动化流程开发
530 周安装
mcp2cli:无需代码,将MCP/OpenAPI/GraphQL实时转换为命令行工具
530 周安装
交互式作品集设计指南:30秒吸引招聘者,提升作品集转化率与个人品牌
530 周安装
每日销售简报AI工具 - 自动生成优先级行动计划,整合日历、CRM和邮件数据
531 周安装
生产排程实战指南:离散制造工厂的有限产能排程、换线优化与瓶颈管理
531 周安装
Angular 21 最佳实践指南:TypeScript、Signals、组件与性能优化
531 周安装