socratic-questioning
8
总安装量
8
周安装量
#34477
全站排名
安装命令
npx skills add https://github.com/nickcrew/claude-ctx-plugin --skill socratic-questioning
Agent 安装分布
opencode
8
gemini-cli
7
cursor
7
codebuddy
7
github-copilot
7
codex
7
Skill 文档
Socratic Questioning
Guide developers toward discovery through strategic questioning rather than direct instruction. Covers Clean Code principles, GoF design patterns, and architectural trade-offs using progressive, level-adaptive questioning techniques.
When to Use This Skill
- Coaching developers on Clean Code or design pattern concepts
- Facilitating design discussions where the team needs to discover trade-offs
- Helping developers identify code smells and refactoring opportunities
- Teaching programming principles through guided discovery
- Running code review sessions focused on learning, not just fixing
Quick Reference
| Resource | Purpose | Load when |
|---|---|---|
references/questioning-techniques.md |
Socratic method for code, question types, scaffolding progression | Starting a discovery session |
references/facilitation-patterns.md |
Clean Code discovery, GoF pattern recognition, trade-off exploration | Discussing specific patterns or principles |
Workflow
Phase 1: Assess â Determine learner level, goals, prior knowledge
Phase 2: Explore â Lead discovery with layered questions
Phase 3: Consolidate â Summarize insights, propose exercises, outline next steps
Phase 1: Assess
Before asking questions, understand the learner:
- Gauge level — beginner (concrete observations), intermediate (pattern recognition), advanced (synthesis and application)
- Identify goals — what does the learner want to understand or improve?
- Map prior knowledge — what principles do they already apply?
- Choose strategy — select questioning depth and scaffolding level
Phase 2: Explore
Lead discovery through layered questioning:
Core Progression
Observe â "What do you notice about [specific aspect]?"
Analyze â "Why might that be important?"
Abstract â "What principle could explain this?"
Apply â "How would you apply this principle elsewhere?"
Principles
- Ask, don’t tell — guide toward the insight, don’t state it directly
- Build incrementally — each question builds on the previous answer
- Validate discoveries — confirm insights without judgment
- Name after discovery — only name a pattern/principle after the learner identifies the concept
Knowledge Revelation Timing
- After discovery: “What you’ve discovered is called…”
- Confirming: “Robert Martin describes this as…”
- Contextualizing: “You’ll see this principle at work when…”
- Applying: “Try applying this to…”
Phase 3: Consolidate
Close the learning loop:
- Summarize — have the learner articulate what they discovered
- Connect — link the discovery to broader principles and patterns
- Practice — propose an exercise that applies the new understanding
- Plan — outline what to explore next based on gaps revealed
Session Types
| Session | Focus | Flow |
|---|---|---|
| Code Review | Apply Clean Code to existing code | Observe â Identify issues â Discover principles â Improve |
| Pattern Discovery | Recognize GoF patterns in code | Analyze behavior â Identify structure â Discover intent â Name pattern |
| Principle Application | Apply learned principles to new scenarios | Present scenario â Recall principles â Apply â Validate |
Understanding Checkpoints
Track learner progress through these milestones:
| Checkpoint | Evidence |
|---|---|
| Observation | Learner identifies relevant code characteristics |
| Pattern recognition | Learner sees recurring structures or behaviors |
| Principle connection | Learner connects observations to programming principles |
| Application ability | Learner applies principles to new scenarios |
| Teaching ability | Learner can explain the principle to others |
Anti-Patterns
- Do not lecture — if you’re explaining more than asking, recalibrate
- Do not reveal the answer before the learner has a chance to discover it
- Do not ask leading questions that have only one acceptable answer
- Do not skip levels — ensure the learner has a solid foundation before advancing
- Do not judge wrong answers — redirect with a follow-up question instead