Re-estimate Learning Time

既存資料のREADME.mdを読み込み、推奨所要時間を再見積もりして更新するスキル。

使用方法

code

/re-estimate-learning-time [ディレクトリパス]

例:

•/re-estimate-learning-time docs/guide/programming-languages/java-ecosystem/jdbc
•/re-estimate-learning-time docs/tutorial/web-technologies/nextjs-fastapi/todo-app
•/re-estimate-learning-time docs/practice/programming-languages/python-ecosystem/python-basics

実行手順

Step 1: README.md分析

•指定パスのREADME.mdを読み込む
•
パスから資料タイプを判定:
- •docs/guide/ → 学習ガイド（章単位）
- •docs/tutorial/ → チュートリアル（ステップ単位）
- •docs/practice/ → 練習問題（回単位）
- •docs/assignment/ → 実践課題（ステップ単位）
•「学習コンテンツ」セクションから各項目（タイトル、説明文、難易度）を抽出

Step 2: 所要時間見積もり

見積もり基準（後述）に基づいて各項目の時間を算出し、テーブルを生成

Step 3: README.md更新

既存の「推奨学習期間」または「推奨所要時間」セクションを新しいテーブルで置換

Step 4: HTMLファイル更新（スクリプト必須）

⚠️ 重要: HTMLファイルの更新には必ずscripts/update_html_time.pyを使用すること。手動でのEdit更新は禁止（非効率・一貫性欠如のため）

bash

# スキルディレクトリからの相対パス
python .claude/skills/re-estimate-learning-time/scripts/update_html_time.py --json '{
    "dir": "[HTMLディレクトリパス]",
    "total": "約X時間",
    "times": {
        "01": "30分",
        "02": "45分",
        ...
    }
}'

注意: totalパラメータは必須。ヘッダーの所要時間には合計時間を表示する。

Step 5: 結果報告

更新内容をユーザーに報告

スクリプト詳細

パラメータ

パラメータ	説明
`--dir`	HTMLファイルのディレクトリパス
`--times`	個別時間のJSON（キー: ファイル番号2桁、値: 時間）
`--json`	全パラメータをJSON形式で指定（推奨）
`--dry-run`	実際には更新せず、対象ファイルを表示

ファイル番号の対応

ファイル名の末尾の番号（2桁）をキーとして使用:

•jdbc-learning-material-01.html → "01"
•jdbc-learning-material-02.html → "02"

実行例

bash

python .claude/skills/re-estimate-learning-time/scripts/update_html_time.py --json '{
    "dir": "docs/guide/programming-languages/java-ecosystem/jdbc",
    "total": "約7.5時間",
    "times": {
        "01": "30分",
        "02": "45分",
        "03": "45分",
        "04": "60分",
        "05": "45分",
        "06": "60分",
        "07": "60分",
        "08": "60分"
    }
}'

見積もり基準

学習ガイド（章単位）

章の内容	目安時間
概要・入門（概念説明中心）	45分
基礎（基本構文・操作）	1時間
中級（実装・応用）	1.5時間
上級（高度な概念・最適化）	2時間
実践プロジェクト	8時間

複雑度による調整:

•コード例が多い → +15〜30分
•複数の概念を同時に扱う → +15〜30分
•設定ファイルやXML/YAMLの解説が多い → +15分
•セキュリティ・認証など専門的な内容 → +30分

チュートリアル（ステップ単位）

ステップの内容	目安時間
環境構築・セットアップ	1.5時間
基本実装（CRUD等）	1.5時間
機能追加・拡張	1時間
UI/デザイン	1時間
テスト・デプロイ	1.5時間

複雑度による調整:

•外部サービス連携（API、DB等）が含まれる → +30分
•複数ファイルの同時編集が必要 → +15分
•トラブルシューティング手順が多い → +15分

練習問題（回単位）

難易度	目安時間
★☆☆☆☆（入門）	15分
★★☆☆☆（基礎）	20分
★★★☆☆（中級）	25分
★★★★☆（上級）	30分
★★★★★（実践）	45分

複雑度による調整:

•問題数が10問以上 → +5〜10分
•記述式・コード記述問題が多い → +5〜10分

実践課題（ステップ単位）

ステップの内容	目安時間
環境構築・設計理解	2-3時間
データベース実装	3-4時間
API実装	3-4時間
フロントエンド実装	4-6時間
機能拡張	2-3時間
テスト・最終調整	2-3時間

複雑度による調整:

•テーブル数が5つ以上 → +1時間
•複雑なリレーション（多対多等） → +30分〜1時間
•認証・認可機能の実装 → +1時間

出力形式（README.md用テーブル）

markdown

## 推奨所要時間

| 章 | 内容 | 目安時間 |
|----------|------|----------|
| 第1章 | タイトル | 30分 |
| 第2章 | タイトル | 45分 |
| ... | ... | ... |
| **合計** | | **約X時間** |

※ 資料タイプにより「章」→「ステップ」「回」に変更

注意事項

•見積もりは目安（学習者のスキルレベルにより変動）
•合計時間は30分単位で丸める（例: 6時間45分 → 約7時間）
•練習問題の合計が60分未満の場合は「約XX分」、60分以上は「約X時間」と表記