exercise-builder について
exercise-builderは、既存のモジュール計画に検証可能な演習を追加するチュートリアル執筆スキルです。課題、期待される出力、確認手順を補います。
主な機能
- 01計画済みモジュールへの演習追加
- 02期待される出力の設定
- 03確認手順の定義
- 04モジュール計画の直接更新
活用シーン
- 01チュートリアルの各モジュールに実践課題を追加
- 02演習結果を客観的に確認可能にする
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/exercise-builderを入力して読み込まれたか確認します。
同梱ファイルscripts/run.py
詳細
演習ビルダー
トリガーとルーティング
- トリガー：演習、練習、検証チェックリスト、教程练习、可验证作业。
- 使用する場合：チュートリアルの C2 で、
outline/module_plan.ymlがすでにあり、各モジュールに演習／期待される出力／検証手順を補う必要がある場合。 - スキップする場合：まだモジュールプランがない場合。
- ネットワーク：なし。
- ガードレール：演習は検証可能でなければならず、自由形式の思考問題だけを提示してはいけません。
チュートリアルの各モジュールに、最小限の決定論的な演習仕様を追加します。
入力
outline/module_plan.yml
出力
- 更新済みの
outline/module_plan.yml
仕様
各モジュールには、次の項目を含む exercise が少なくとも1つ必要です。
promptexpected_outputverification_steps
スクリプトの範囲
scripts/run.py は次の処理を行う必要があります。
- 現在のモジュールプランを読み込む
- 不足している演習を決定論的に補う
- プランを同じ場所に書き戻す
演習の文言を決めるロジックは、スキルのスクリプトに繰り返しハードコードするのではなく、共有のチュートリアルツールに含めてください。
受け入れ条件
- すべてのモジュールに
exercisesがある - すべての演習に
expected_outputが含まれている - すべての演習に
verification_stepsが含まれている
対象外
- ソースの網羅性監査
- チュートリアルの文章作成
コメント
Markdown 対応