Shift Planner

Shift Planner に関する日本語ガイドです。skills/shift-planner/SKILL.md をもとに、利用開始手順、参照ファイル、補助スクリプトへの入口を日本語で整理しています。

API不要

スキルパッケージをダウンロード (.skill) GitHubでソースを見る

目次

1. 概要

このページは Shift Planner スキルの日本語サマリーです。

  • スキル本体: skills/shift-planner/SKILL.md
  • 参照ガイド: 2 件
  • 補助スクリプト: 1 件
  • 詳細な背景説明や判断基準は英語版ガイドを参照してください。

2. 前提条件

  • APIキーは不要です
  • Python 3.9 以上を推奨します
  • 詳細な実行条件は英語版ガイドまたは SKILL.md を参照してください。

3. クイックスタート 

score = -(remaining_hours * 10)     # 契約残余多い=優先
           + (weekend_shifts * 20)      # 週末バランス
           + (avoid_penalty * 50)       # 回避曜日ペナルティ
           - (supervisor_bonus * 100)   # 監督者ボーナス
           - (speciality * 5)           # 資格専門度
           + (preference_miss * 30)     # 希望パターン不一致

4. 進め方

  1. skills/shift-planner/SKILL.md を開き、対象タスクと期待する成果物を確認します。
  2. クイックスタートのコマンドや最小サンプルで、手順が通ることを先に確認します。
  3. 必要な観点に応じて references/ 配下のガイドを確認し、判断基準を揃えます。
  4. 補助スクリプトがある場合は小さな入力で実行し、出力形式を確認してから本番データへ広げます。
  5. 仕上げ時に、出力内容と前提条件が依頼内容に合っているか見直します。

5. 使用例

  • Shift Planner に沿って作業の進め方を整理したいとき
  • まず最小の入力やサンプルデータで手順を確認したいとき
  • 補助スクリプトを使って定型処理や検証を実行したいとき
  • 参照ガイドを見ながら出力の粒度や観点を揃えたいとき
  • 詳細な実装判断や例外ケースは英語版ガイドも併用したいとき

6. 出力の読み方

  • スキルの手順に沿った構造化された回答、分析結果、または文書ドラフト
  • 参照ガイド 2 件を根拠にした判断材料
  • 補助スクリプト 1 件による補助出力や検証結果
  • 後続レビューや別スキル連携に回せる中間成果物

7. ベストプラクティス

  • まずは小さな入力で試し、期待する出力形式になっていることを確認してから対象範囲を広げてください。
  • 詳細な手順や判断基準は skills/shift-planner/SKILL.md を基準にしてください。
  • 参照ガイドは必要なものから順に読むと、過剰に読み散らかさずに進められます。
  • 補助スクリプトは本番データの前にサンプル入力で実行し、引数と出力先を確認してください。
  • 出力前に、前提条件・入力範囲・未確定事項を明示すると後戻りが減ります。

8. 他スキルとの連携

  • 同じカテゴリのスキルと組み合わせると、計画・実装・レビューまでの流れをつなぎやすくなります。
  • 日本語のカテゴリ一覧: カテゴリページ
  • 詳細な関連ワークフローを探す場合は英語版カテゴリ一覧も参照してください: English category

9. トラブルシューティング

  • まず前提条件を確認し、必要なランタイムやパッケージが揃っているかを見直してください。
  • 補助スクリプトを使う場合は、最小入力で一度実行してから本番データへ広げてください。
  • 期待する出力にならない場合は、参照ガイドにある入力形式や観点の前提を確認してください。
  • Python のバージョン差分が原因になることがあるため、推奨バージョンを確認してください。
  • 引数や出力先の指定漏れが多いため、コマンド例をそのまま起点に調整すると安全です。

10. リファレンス

参照ガイド:

  • skills/shift-planner/references/labor_constraints_guide.md
  • skills/shift-planner/references/shift_planning_methodology.md

補助スクリプト:

  • skills/shift-planner/scripts/generate_shifts.py

English Version

  • 詳細な解説、背景説明、個別の運用判断は English version を参照してください。