Communityライティング&編集github.com

steffen74/前提知識

コースの前提境界に関するルール — 学習者が各時点で知っている、持っている、できると想定できることを定義し、ギャップと適切な想定を区別する方法を示します。受講者向けの指示、タスク、セットアップ手順、クイズを作成・レビューするとき、または学習者が行き詰まったときに使用します。

前提知識 とは?

このスキルは、コース内で学習者に対して暗黙の前提を置くことなく、明確で段階的な指示を作成するためのフレームワークを提供します。前提境界(バウンダリ)とは、学習者がコースの各時点で知っている、持っている、実行できると想定されることの範囲を定義します。バウンダリを超えるステップは「ギャップ」となり、学習者は行き詰まったり、推測したり、質問したりすることになります。このスキルは、概念的な知識だけでなく、アカウント、インストール済みソフトウェア、管理者権限、リポジトリなどの所有物や、クローン、フォーク、`uv sync`などの事前に行った操作、コマンドプロンプトやノートブックの「実行」といった慣習もカバーします。Claude Code、Cursor、CodexなどのAIエージェント向けに設計されており、受講者向けの指示、タスク、セットアップ手順、クイズを作成・レビューするとき、または学習者が行き詰まった状況を分析するときに使用します。ルールでは、バウンダリはインストラクターが決定し、不明な場合は問い合わせるべきとし、オプションの教材はバウンダリを拡張しない、複数のペルソナが異なる場合は弱い方に従う、などを定めています。また、典型的なギャップ(作成ステップが欠落しているオブジェクトへの参照、異なるページでの矛盾したリポジトリ名、特定のフォルダからのみ動作するコマンドなど)と、クラスでのレッドフラグ(複数の学習者から同じ質問、インストラクターを待つ学習者、グループ全体の成果物未提出)を特定し、`course-checks`をロードしてチェックに変換することを推奨します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steffen74/agentic-course-creation/tree/HEAD/skills/assumed-knowledge

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

前提知識 は何をしますか?

バウンダリとは、学習者がコースの特定の時点で知っている、持っている、実行できると想定されることの範囲です。Canvasブロック6はコース開始時のバウンダリを保持し、各ユニットの教材がそれを拡張します。学習者に求められるすべてのステップは、その時点のバウンダリ内になければなりません。バウンダリ外のステップはギャップとなります。学習者は行き詰まり、推測するか、質問することになります。

バウンダリがカバーするもの

概念だけではありません。ギャップは少なくとも以下の原因から頻繁に発生します。

  • 持っているもの: アカウント、サブスクリプション、インストール済みソフトウェア、管理者権限、自分専用のラップトップ、自分専用のリポジトリ。
  • 行ったこと: クローン、フォーク、uv sync、チャットルームへの参加、招待の承諾。
  • 場所: どのリポジトリ、どのフォルダ、どのリンクか。「テンプレートリポジトリのあなたのクローン」は、それを作成したことを前提としています。
  • 慣習: コマンドプロンプトとは何か、ノートブックでの「実行」の意味、/commandはエージェントに入力されること。

ルール

  • バウンダリはインストラクターの判断です。何かを前提としてよいか不明な場合は、判断せずに問い合わせてください。
  • 何かが既知となるのは、教材が使用される前にそれを教えた場合、または学習者が従える指示とともに行うよう求めた場合のみです。同じユニットにリストされたビデオに含まれている場合も、そのビデオがタスクより前に来る場合に限りカウントされます。
  • ツールが学習者の代わりに実行する場合(エージェント、セットアップスクリプト)は、学習者がそのステップで、正確なプロンプトまたはコマンドとともにそれを使用するよう指示されている場合のみカウントされます。
  • ステップが依存するすべての成果物には、その作成元が必要です。それを生成したステップ、またはそれが存在する場所へのリンクです。
  • オプションの教材は決してバウンダリを拡張しません。
  • 2つのペルソナが異なる場合、ブロック6が明示的に除外しない限り、弱い方のペルソナに従います。

典型的なギャップ

  • 指示が、作成ステップが欠落しているか、暗黙的にしか示されていないオブジェクト(リポジトリ、ファイル、ルーム、アカウント)を参照している。
  • 同じステップに対して異なる2つのページが異なるリポジトリやフォルダを指定している。
  • コマンドが特定のフォルダからのみ動作するが、ページがどのフォルダかを示していない。
  • ステップが依存するツールが、あるプランでは無料で別のプランでは有料であり、ページが有料プランを前提としている。
  • タスクに後続のユニットで予定されている概念が必要である。

クラスでのレッドフラグ

複数の学習者から同じ質問がある、学習者がインストラクターを待っていて始められない、グループ全体で成果物が未提出である。それぞれを、反証がない限りバウンダリ違反として扱い、course-checksをロードしてチェックに変換してください。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル