teach について
teachは、学習者の知識に合わせてソフトウェアのサブシステムを段階的に説明するスキルです。コードの解説、根拠に基づく設計理由の説明、動作予測の確認を組み合わせます。
主な機能
- 01基礎知識に応じた説明の深さ
- 02ファイル名と行番号付きのコード解説
- 03設計判断の根拠提示
- 04動作予測による理解確認
活用シーン
- 01学習者へのサブシステム紹介
- 02コード構成の理由の説明
- 03学習者が動作を予測できるか確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ yeachan-heo/ oh-my-claudecode --skill teachインストール後、Claude Code で/teachを入力して読み込まれたか確認します。
README(原文)English
プロジェクトの README よりこの README の日本語訳はまだありません。以下は英語の原文です。日本語の紹介はページ上部をご覧ください。
Teach
Teaching is how and why composed for a learner: what the subsystem does
and the reasons it is shaped that way, in an order a person can absorb.
Workflow
- Ask the learner's baseline: one question — familiar with the domain, the language, or neither. Size the explanation to the answer.
- How first (
howskill): the walkthrough, entry to exit, cited to file:line, at the depth the baseline supports. - Then why (
whyskill): the 2-4 decisions that shaped it, each with its evidence and the alternative it beat. Human rulings quoted verbatim. - Check the landing: ask the learner to predict one behavior — "if X happens, what does the subsystem do?" A correct prediction ends the lesson; a wrong one names the layer to redo. The check is for pacing, not grading.
Rules
- One new concept per paragraph; jargon defined at first use in one clause.
- Cite code for behavior, cite records for reasons; label anything you inferred.
- Stop when the learner can predict behavior — completeness is not the goal, transfer is.
コメント
Markdown 対応