mcpField
K
k2f-worksheet

k2f-worksheet

github.com/suzhengドキュメント33.1k 回インストール2 週間前に更新
リポジトリ

k2f-worksheet について

レイアウト前に、学習者向けワークシートの明確な説明、回答可能な設問、適切な解答スペースを計画するエージェント向けスキルです。K2F で検証・出力可能なワークシートを作成します。

主な機能

  1. 01学習フレームと達成基準の設定
  2. 02範囲を絞った設問の分類
  3. 03設問ごとの回答形式とスペース
  4. 04共通情報の登録と安定した設問 ID
  5. 05解答概要の分離

活用シーン

  1. 01授業や基準に沿った練習問題の作成
  2. 02整理シートや短答式ワークシートの作成
  3. 03雑多な入力から分類別のギャップ質問を作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/suzheng/k2f --skill k2f-worksheet

インストール後、Claude Code で/k2f-worksheetを入力して読み込まれたか確認します。

詳細

K2F ワークシート — AI ネイティブな美的デザイン

目的

レイアウトに取りかかる前に、エージェントがワークシートの設計図を作成できるようにします。つまり、ひと目でわかる説明、範囲が適切に定められた設問、意図的に確保された回答スペースを備えた、学習者向けの単一の課題用紙を作成します。長文の回答を大量に求めたり、同じプロンプトを重複させたり、用紙に記載された情報だけでは答えられない設問を設けたりしないようにします。

K2F を基盤にする

このスキルは、ワークシートを .K2F パッケージとして作成します。オーサリングには k2f スキルを使用してください。ワークスペースを展開または初期化し、セマンティックツリーを編集して、パック/検証を実行してからエクスポートします。K2F により、エージェントはピクセル座標ではなく、意味(セクション、設問、回答形式)に集中できます。レイアウト、タイポグラフィ、テーマはエンジンがコンパイルします。

作成を始める前に、コアスキルをインストールしてください:npx skills add suzheng/k2f --skill k2f。

使用する場面

  • 教育者が、授業、単元、または学習基準に沿った練習、反復学習、応用課題を必要としている場合。
  • ユーザーが、構造化された空欄、オーガナイザー、短い記述式回答、またはチェックリストを求めている場合。完全な授業案(k2f-lesson-plan)やコース概要(k2f-syllabus)を求めている場合ではありません。
  • アナリスト形式のギャップ分析ワークシート:雑多な入力を分類し、回答可能な設問ブロックに整理します(ギャップ分析のパターンに着想を得ています)。紙面上で学習者またはファシリテーターが記入できる形式にします。

ワークフロー

ステップ 1. content_and_design.md を生成する

用紙に何を載せるか、印刷したときにどのように見渡せるようにするかをまとめた設計図を 1 つ作成します。共通の事実は一度だけ登録し、すべての設問から参照できるようにして、k2f スキルがセクションを対応付ける際に意図せず内容がずれないようにします。

サブステップ

  1. 対象の判断と確認 — 教科、学年層、所要時間、ワークシートの種類(ドリル、段階的な練習、実験/データ、振り返り、オーガナイザー、ギャップ解消)を推測します。特に重要度の高い質問は最大 2 つまで行います(例:対象の学習基準、解答付きかどうか)。設問数と難易度は、文脈をもとに設定します。

  2. 学習の枠組み — タイトル、必要に応じて学習基準またはスキルの要旨(10 語以内)、そして成功の基準を 1 文で示します。用紙が前提とする予備知識や教材(教科書のページ、前の授業、電卓など)を記載します。設問ごとに繰り返す必要はありません。

  3. 情報アーキテクチャ — 上から下へ、次の順に構成します。

    • 導入(簡潔に):用紙の目的と使い方を説明します。授業のような長い説明は避けます。
    • 任意の参照資料(最大 1 ブロック):設問が参照資料に依存する場合に限り、文章の抜粋、図の説明、データ表、シナリオなどを用意します。
    • セクション:サブスキルまたは認知的な手順ごとにグループ化します。ユーザーから別途指定がない限り、各セクションには短い見出しと 3~12 個の設問を設けます。
    • 回答形式:各設問について、回答形式(空欄、チェックボックス、表のセル、短い段落用の枠、図へのラベル記入)と、おおよそ必要なスペースを指定します。
    • 解答(要望があった場合):設問 ID に対応付けた別個の概要を用意します。解答を同じページの役割にある学習者向け設問の間に挟まないでください。
  4. 設問の設計 — 各設問には、測定可能なプロンプトを 1 つだけ設けます。複合的な質問は分割します。螺旋型の復習が必要な場合を除き、各セクション内では易しいものから難しいものへ並べます。ギャップ形式の用紙では、カテゴリーごとにまとめ、空のカテゴリーは省略します。ギャップ形式の各行には、短い出典の抜粋(または「記載なし」)、具体的な質問 1 つ、空欄の回答フィールドを用意します。あるとよい要素よりも、対象範囲、中核となるスキル、回答の妨げとなる曖昧さを優先します。

  5. 共通レジストリ — 数字、名前、語彙、データセットの値、シナリオの事実は、Shared content の下に一度だけ記載します。編集によって内容が分岐しないよう、設問から安定したキーを参照します。

  6. デザインの意図 — 座標ではなく、エンジンに対して次の意図を指定します。

    • トーン:落ち着きがあり、教室で信頼できる印象にします。低学年向けの場合も、クリップアートで雑然とさせず、親しみやすくします。
    • 階層:タイトルと学習の枠組みを最も目立たせます。セクション見出しはひと目で確認できるようにし、設問番号または記号の付け方は統一します。
    • 密度:説明は簡潔にします。手書きや描画が想定される箇所には十分な作業スペースを確保し、段落が延々と続く構成は避けます。
    • 一貫性:設問の表現を並行した形にし、セクションと回答形式のラベル体系を統一します。
    • 配色:白黒印刷に適した配色にします。セクション見出しまたは学習の枠組みのアクセントカラーは 1 色までにします。

ルールと制約

  • シートは単独で完結させます — すべての項目は、オリエンテーション、アンカー、共有レジストリを参照すれば回答できるようにします。書面で提示された成果物がないまま、「先生と相談する」といったプレースホルダーを入れてはいけません。
  • 一貫した流れを保ちます — 学習の枠組み → セクション → 項目 → 回答欄の順に構成し、明示したスキルの練習にならない項目は削除します。
  • プロンプトはオリジナルにします — 参照資料は範囲の設定に役立ててもかまいませんが、出版社の問題集や著作権で保護された素材をそのまま複製してはいけません。
  • 扱う範囲を適切にします — 時間やページ数に制約がある場合は、項目を減らすか、枠組みを絞ります。回答欄を読めないほど小さくしてはいけません。
  • 進行役と学習者を分けます — 教師向けメモや採点基準は、学生向けの項目文に混ぜず、別の成果物として設計図に含めます。

よくある失敗

  • 項目で、明示されていない背景知識を問う → アンカーブロックまたは共有レジストリの項目を追加します。
  • 1つの設問で複数のスキルを問う → 項目を分割し、順序を組み直します。
  • 学生向けシートに解答や長い指導説明が含まれる → 別のアウトラインの役割に移します。
  • すべてのセクションで同じ指示を繰り返す → 指示を一度だけオリエンテーションにまとめます。
  • 実際の空欄がないギャップ分類 → セクション自体を省略します。
  • 曖昧なプロンプト(「もっと説明してください」など) → 期待する根拠、長さ、形式を明記するよう書き直します。
  • 1つのセクション内で難易度が合っていない → バランスを取り直すか、グループを分けます。

品質チェックリスト

  • 学習の枠組みとすべての項目が一致していること。関連しない項目は削除します。
  • 空のセクションは省略し、解答キー用の項目 ID は変更しません。
  • 共有レジストリに、項目をまたいで参照する事実がすべてキー付きで記載されていること。
  • 各項目に回答形式が指定され、十分な回答スペースがあること。
  • 読解レベルが学年に合っており、刺激資料の長さに妥当性があること。
  • デザインの意図に、トーン、階層、密度、一貫性、配色が示されていること。
  • 第三者の問題集をそのまま複製していないこと。ギャップを問う質問が具体的で、回答可能であること。
ステップ 2. content_and_design.md と k2f スキルを使って K2F ファイルを生成し、適切なファイル形式でエクスポートします。

k2f スキルに従って、設計図からワークシートを作成し、デザインの意図に沿って役割を適用し、検証したうえで、印刷用 PDF またはその他の成果物としてエクスポートします。

コメント