zlej123/stepkeeper

stepkeeper は何をしますか？

<Use_When>

• ユーザーがYouTubeのハウツーURLを共有し、クリーンでフォローしやすいテキスト/ビジュアルガイドを希望する場合。
• ユーザーがチュートリアルの口頭での説明があいまいだと不満を述べ、「実際に見せて」フレームを希望する場合。
• ユーザーがレシピや手順をメモアプリに保存したい場合。 </Use_When>

<Do_Not_Use_When>

• 動画が、視覚的に解決可能なアクションのない、トーキングヘッド形式の講義、vlog、レビュー、ポッドキャストである場合。
• コンテンツが安全に関わるもの（医療、主電源、ガス、重機）である場合 — 専門家によるレビュー済みプロファイルが必要です。 </Do_Not_Use_When>

<How_To_Run> 1つのコマンドで分析 → キャプチャ → 選択 → レンダリング → エクスポートを実行します。 --language はドキュメントの言語（BCP-47： en、ko、ja など）であり、動画の言語ではありません。英語のハウツー動画は en または ko の出力のどちらでも動作します。

1. 完全自動（ffmpeg不要、スクリーンショットの代わりにタイムスタンプリンク）：

   • 韓国語ドキュメント： stepkeeper <URL> --profile generic --language ko --links-only
   • 英語ドキュメント（英語話者向け）： stepkeeper <URL> --profile generic --language en --links-only

2. スクリーンショット付き完全自動（Geminiがガイドごとにフレームを選択）： stepkeeper <URL> --profile recipe --language en --auto-pick --export goodnotes 再生成された picker.html を確認します（AIが事前選択）；ユーザーが修正した場合は、 python -m stepkeeper.feedback add <semantic-evaluation.json> を実行してログに記録します。

3. 手動/エージェントによるフレーム選択：

   • stepkeeper <URL> --profile recipe --language en
   • エージェントパス：work/frames/… 以下の3つの候補フレームを直接読み込み、 picks.json を自分で書き（意味的判断）、その後、 --picks <picks.json> --export goodnotes（または obsidian/bundle/notion）で再実行します。

Notionエクスポートには NOTION_TOKEN と --parent <page-id> が必要です。 アーティファクトはカレントディレクトリ（STEPKEEPER_DATA で上書き可能）に配置されます。 </How_To_Run>