teaching-notes-writing について
配布資料、ワークシート、学習ガイド、チュートリアルなど、学習者向け教材の執筆に使えるポータブルなスキルです。固定の章テンプレートを設けず、柔軟な構成、説明方法、例、演習設計の指針を示します。
主な機能
- 01学習者の既存の理解から始める
- 02関連概念を比べてから規則を説明
- 03状態変化を示しながら手順を説明
- 04演習形式と解答の配置を提案
- 05図解が役立つ箇所を見極める
活用シーン
- 01学習者向けガイドの草稿作成
- 02手順を段階的に説明
- 03演習問題と解答の流れを設計
- 04教材ページで図解が必要な箇所を判断
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/teaching-notes-writingを入力して読み込まれたか確認します。
同梱ファイルreferences/programming.mdreferences/teaching-patterns.md
詳細
ティーチングノートの作成
これはポータブルなライティングスキルです。単独で使用でき、ページの内容が学習者向けの教材（配布資料、ワークシート、学習ガイド、チュートリアルの章）である場合に、openpress-create-pages によって読み込まれます。トリガーと競合解決のルールは openpress-create-pages が担います。
ティーチングノートは、まだメンタルモデルを構築中の学習者を対象としています。このスキルでは、コンテンツの構成案、説明方法、例、練習のアイデア、解答の提示方法に関するガイダンスを提供します。固定の章テンプレートを必須とするものではありません。
責任範囲
- 学習者が抱いている可能性の高いメンタルモデルを出発点にします。
- 形式的なルールを紹介する前に、似た考え方を比較します。
- 状態の変化を明示しながら、手順を段階ごとに示します。
- 図に情報を詰め込みすぎず、理由や警告、解釈は文章で説明します。
- 章の内容に合った練習形式を提案します。
- 学習者が挑戦する機会を得た後に解答を提示します。
- 構造、関係、状態の変化を図にすべきタイミングを提案します。実際の図の意味づけには
openpress-diagram-drawingを使用します。
境界
- ページ形式の成果物における公開コンテンツの整備とH1/H2/H3/H4の構成は、
openpress-create-pagesが担います。 - 図の意味づけは
openpress-diagram-drawingが担います。 - ページのビジュアルスタイルとコンポーネントの実装は、
openpress-create-pagesが担います。 - CLI、検証／エクスポート／レンダリングコマンド、およびソースと生成物の境界は、
openpressが担います。 - このスキルが担うのは、学習者向けの説明に関する提案と演習設計のパターンのみです。
推奨する構成案
必須のテンプレートではなく、出発点として次の構成案を使用します。
- 学習者が直面している具体的な問題や混乱から始めます。
- 似た概念、状態、表現を比較します。
- 操作や考え方を段階ごとに示します。
- 効果がある場合は、簡単な確認問題、トレース、または練習課題を加えます。
- 学習者が挑戦する機会を得た後に、解答全体を提示します。
概念が空間的な構造、所有関係、矢印、状態遷移、または前後関係に依存する場合は、視覚的な意味づけを openpress-diagram-drawing に委ねます。
学習者向けコンテンツの境界
レンダリングされる教材ページは、教師やエージェントではなく、学習者に向けて書きます。
- 教師向けの注意事項、制作メモ、内部的な理由づけ、スキルの初期設定に関する説明は含めないでください。
- 内部ルールは、スキル、設計ドキュメント、またはソースの参照資料に記載してください。
- 文章、図、表、コード全体で用語と変数名を統一してください。
参照資料を読むタイミング
- 比較を用いた文章の書き方、説明の順序、練習問題の種類、解答を提示するタイミングについては、
references/teaching-patterns.mdを読んでください。 - コード、擬似コード、データ構造、ポインタの図、メモリの状態、プログラムのトレースを教える場合は、
references/programming.mdを読んでください。
コメント
Markdown 対応