review-learning-content について
コース、埋め込み問題、Judge 問題、コンテストを対象とする Exercode 学習コンテンツのレビュー用スキルです。解答の独立検証、内容の正確さ、学習者への適合性、コードの実行可能性を重視します。
主な機能
- 01Exercode 学習コンテンツのレビュー
- 02埋め込み問題の独立した解答
- 03明瞭さと事実の正確性の確認
- 04Judge 問題とテストの検証
- 05依存関係の再現性確認
- 06適用可能なバリデーターの実行
活用シーン
- 01公開前のコースレビュー
- 02問題の想定解答の確認
- 03Judge 問題文とテストの監査
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ willbooster/ exercode-problem-utils --skill review-learning-contentインストール後、Claude Code で/review-learning-contentを入力して読み込まれたか確認します。
詳細
Exercode の学習コンテンツをレビューする
-
レビュー前に、該当する執筆スキルとリンク先の参考資料を読んでください。
- コース、講義資料、埋め込み問題については、generate-course-materials を参照してください。
- Judge v2 の問題については、generate-judge-problems を参照してください。
- コンテストとその問題セットについては、generate-judge-contest を参照してください。
-
学習コンテンツについて、次の点を確認してください。
- 重要または不確かな内容に関する主張について、信頼できる一次情報源を用いて事実の正確性を確認すること。
- 依頼内容、周辺の教材、明示された前提知識、対象とする難易度との整合性。
- 明確で曖昧さのない日本語、正確な用語、スペル、Markdown、例、期待される結果。
- 問題に意図された答えが一つだけあり、記載された問題文から回答できること。
- コード例が完全で実行可能であり、説明と矛盾しないこと。
- 学習目標にコードの作成、変更、実行が含まれるコースでは、埋め込み問題や完成済みの例だけに頼らず、適切な学習の節目にコース専用の Judge 問題が用意されていること。
- Judge 問題のファイルが必要とするすべてのランタイムとサードパーティ依存関係が、リポジトリ内で再現可能な形で宣言されていること。
-
埋め込み問題ごとに、
answerIndex、answerIndices、answerPattern、modelAnswer、hint、explanationを読む前に、問題文と選択肢から独立して問題に答えてください。その後、自分の答えをこれらのフィールドと照らし合わせ、意図された答えが一意かつ正しく、問題文の記述に裏付けられていることを確認してください。 -
Judge 問題ごとに、まず問題文と前提教材だけを読んでください。模範解答や期待出力を読む前に、解答、例の期待出力、重要な境界ケースを独立して導き出してください。その後、模範解答、テストケース、テンプレート、ジャッジの実装を調べ、次の点を確認してください。
- 問題文に、一意に解くために必要な情報が十分に記載されていること。
- 制約、例、模範解答、期待出力、ジャッジの動作が一致していること。
- 想定される解法が学習者の学習済み概念だけを使用していること。
- テストケースが重要な境界条件を網羅しており、すべての模範解答がジャッジで受け入れられること。問題ディレクトリから
bunx exercode-problem judge model_answers/<languageId>を実行してください(このコマンドは、問題に独自のjudge.tsがある場合はそれを適用し、ない場合は標準の stdio ジャッジを使用します。詳しくは generate-judge-problems/references/problem-format.md を参照してください)。コマンドが終了コード 0 で終了し、少なくとも 1 行のTEST_CASE_RESULTを出力し、出力されたすべての行に受理を示す判定コード2000が含まれていることを確認してください。 - スターターテンプレートがすべてのテストケースに合格してしまわないこと。
エージェントチャレンジ(
problem.md内のagentChallenge)にはテストケースもハーネスもありません。そのため、上記のハーネスとテストケースの確認の代わりに(問題文の完全性と学習済み概念に関する確認は引き続き行い)、問題文に練習する手法と使用するプレイグラウンド API が明記されていること、expectedRequestが想定解答から送信されるリクエストだけに一致し、プレイグラウンド UI から手動で送信するリクエストや汎用的なフレーズには一致しないこと、model_answers/explanation/内の解説が問題を解いていることを確認してください。 -
該当するコース、問題、コンテストのバリデーターを、補助的な根拠として実行してください。模範解答、テンプレート、ジャッジは、リポジトリで宣言されたランタイムと依存関係を通じて実行してください。グローバルインストール、場当たり的なダウンロード、一時的な依存環境でしか成功しない Judge 問題は懸念事項として扱ってください。バリデーターの成功を、事実、教育、文章の品質の証明とみなさないでください。
-
懸念事項として報告する前に、疑わしい点をすべて検証してください。具体的な正確性または学習品質への影響がある懸念事項だけを報告し、好みの問題は報告しないでください。