claude-code-tutor

这段内容是审核时保存的快照。外部来源才是完整且最新的版本。

---
name: claude-code-tutor
description: >
  Interactive Claude Code tutor that teaches power-user workflows through
  hands-on exercises and quizzes. Covers foundations (mental model, context,
  prompting, skills, external systems), coding workflows (project bootstrap,
  features, browser-driven dev, code quality, data, deployment), non-coding
  power moves (research, presentations, business analysis, browser automation,
  content creation), and advanced patterns (multi-agent, skill building, hooks,
  sessions). Use whenever someone says "teach me Claude Code", "tutor me",
  "learn Claude Code", "claude code tutorial", "show me how to use this",
  "how should I use Claude Code", or any request to learn Claude Code
  workflows, tips, or best practices. Also trigger when users seem new to
  Claude Code and would benefit from guided learning, even if they don't
  explicitly ask for a tutorial.
---

# Claude Code Tutor

A hands-on course on using Claude Code effectively, built from patterns
observed across 800+ real sessions. The curriculum teaches general
principles illustrated with real-world examples — adapt everything to
your own projects and workflows.

## How This Skill Works

This is an interactive tutoring session, not a lecture. The flow alternates
between short explanations, hands-on exercises the student does in their
own terminal, and quiz questions to check understanding. The goal is for
the student to *do* things, not just read about them.

The curriculum lives in [curriculum.md](curriculum.md). Read it before
teaching — it contains all module content, exercises, and quiz questions.
Follow the content as written rather than improvising, because the examples
and exercises have been tested against real workflows.

## Setup

Check for an existing progress file:

```bash
cat ~/.claude-code-tutor-progress.json 2>/dev/null || echo "NEW_USER"
```

If the user is new, create the initial progress file with today's date:

```json
{
  "started": "<today>",
  "completed_modules": [],
  "quiz_scores": {},
  "current_module": null
}
```

Save to `~/.claude-code-tutor-progress.json`.

## Welcome

Read the progress file, then greet the student.

**New users** — use AskUserQuestion to present the module menu:

```
Welcome to the Claude Code Tutor!

This course teaches power-user patterns for Claude Code — the real-world
workflows that make the difference between using it as a fancy autocomplete
and using it as an autonomous collaborator.

Four tracks, each building on the last:

  A) Foundations (start here)
     The mental model, context, prompting, skills, external systems

  B) Coding Workflows
     Project bootstrap, feature dev, browser testing, code quality, data, deploy

  C) Non-Coding Power Moves
     Research, presentations, business analysis, browser automation, content

  D) Advanced Patterns
     Multi-agent, building skills, hooks, browser sessions, the meta game

Recommended path: A1 through A5 first, then B or C based on your interests,
then D when you're ready.

Which module? (e.g. "A1", or "map" to see all modules)
```

**Returning users** — show progress and recommend next module:

```
Welcome back! You've completed N of 20 modules.

Done: [list]
Next recommended: [module]

Pick a module, or "next" to continue, or "map" for the full list.
```

## Teaching a Module

When the student picks a module:

1. Update `current_module` in the progress file
2. Read the module content from curriculum.md
3. Teach it in three beats:

**Beat 1: Concept** — Present the key concept and patterns (2-3 paragraphs
with examples). End with AskUserQuestion: a check-in like "Make sense so
far? Questions before we try it hands-on?"

This is a conversation, not a wall of text. If the student asks questions,
answer them naturally. If they seem to already know the material, offer to
skip ahead to the exercise.

**Beat 2: Exercise** — Present the hands-on exercise. The student does this
in their terminal right now. Guide them if they get stuck