Show HN: SlideOps、リポジトリからコードの差異を検出するスライド生成ツール

数分でコードからデッキを生成します。 コードと乖離した場合はミリ秒単位で検出します。 その後、乖離したスライドのみを再構築します。 インストール · 使用法 · 特長 · ドキュメント · デモデッキ · なぜ？ デモデッキはSlideOpsについて17枚のスライドで構成されており、SlideOps自身によって作成されています。HTMLまたはPDFで開いてください。 ドキュメント作成はもはやボトルネックではありません。それを真実に保つことがボトルネックです。 データベースマイグレーションを2回実行すると言っていたデッキは、10回実行し始めてから1年経った今でも2回と表示されています😅。 SlideOpsは、Claude Codeおよび互換性のあるコーディングエージェント向けのAgent Skillsのペアです。 これは、生成されたドキュメントを、生成されたコードを扱うのと同じように扱います。つまり、ソースから構築され、どのソースから来たかを記録します。 その背後にある考え方は、Your documentation is a build artifact. Start treating it like one. に書かれています。 任意のデッキでEscキーを押すと、概要グリッドが表示されます。 Claude Codeをインストールします。 このリポジトリはそれ自体がマーケットプレイスなので、セットアップは2行で完了し、自己更新される唯一のインストールです。 /plugin marketplace add glukicov/slideops /plugin install slideops@slideops Codex、Copilot CLI、OpenCode、またはプレーンなチェックアウト: git clone https://github.com/glukicov/slideops && cd slideops ./install.sh 4つのエージェントすべてがSKILL.mdを読み込み、それらの間でポートする必要はありません。 シンボリックリンクとスナップショットのインストール、エージェントごとのテーブル、およびアップデートがどのように配信されるかについては、docs/install.mdを参照してください。 注: サードパーティのマーケットプレイスでは、デフォルトで自動更新が無効になっています。 /plugin → Marketplaces で一度有効にするか、/plugin marketplace update slideops を手動で実行したときにのみ新しいバージョンが届きます。 使用法 リポジトリを開いて、次のように入力します。 Tip 💬 make slides about this repo SlideOpsはまずリポジトリをスキャンし、次にコンパクトな質問セットを提示します。どのトピックか（見つかった具体的な候補をそれぞれ「なぜ今か」と共に提案します）、対象者、長さ、テーマ、追加要素です。 HTMLを書き始める前に、アウトラインを承認します。 すでに何が欲しいか分かっている場合は、インテークをスキップします。 Note 💬 deep dive on the auth subsystem, Ledger Dark theme, 15 slides, with a PDF 数ヶ月後、同じリポジトリで: Important 💬 is the architecture deck still accurate? エージェントはデッキフォルダをスキャンし、ステータスでトリアージします。 移動しただけのものを再引用し、主張がもはや有効でない可能性のあるスライドをフラグ付けします。 デッキ全体を再生成するのではなく、ドリフトしたものを修復するため、最初に承認したペースとナラティブが維持されます。 特長 鮮度チェック。 scripts/check.py は docs/slides/ フォルダ全体をスキャンし、デッキ構築以降に変更、移動、または削除されたコードを引用しているスライドを報告し、修正を提案するか、JSONの修理指示をエージェントに渡します。 モデル、ネットワーク、トークンなし: 標準ライブラリPythonで、ミリ秒単位で実行されます。 デッキごとに1つの自己完結型ファイル。 ビルドステップなし、CDNなし、オフラインで動作、メールに添付可能。 ナビゲーション: 矢印キー、クリックで進む、URLハッシュのディープリンク、Escで切り替え可能な概要グリッド、スピーカーノート（Nキー）（スクリーンショットやエクスポートでは表示されません）。 13のスライドパターン: タイトル、アジェンダ、セクション区切り、プロセ + カード、参照テーブル、コードの前後比較、注釈付きスニペット（半幅および全幅）、フロー図、レーン比較、画像 + キャプション、チャットバブル、クロージング。 4つのテーマ、それぞれ1つのブロック。 すべての色は単一の :root トークンブロックから color-mix() を介して派生するため、テーマの切り替えは1回の置換で済みます: Ledger Light (デフォルト)、Ledger Dark、Midnight、Graphite。 または、ブランドの実際のCSS値を示して、それらをトークンロールにマッピングします。 Ledger Light (デフォルト) Ledger Dark 同じデッキ、同じマークアップ、同じコンテンツ。 :root ブロックが1つ違うだけです。 Mermaid図はビルド時にインラインSVGにプリレンダリングされ、デッキ自身のトークンからテーマ設定されるため、デッキは依存関係フリーのままです。 検証済みのPDFエクスポート。 コンパニオン スキルは完成したPDFを画像にレンダリングし、ページをチェックします。なぜなら、PDFは正しいページ数であっても、空の画像しか渡さないことがあるからです。 ドキュメントページ 内容物 📦 インストール すべてのインストールパス、4つのエージェント、アップデート、要件、インストールされるもの 鮮度 🔎 引用、ステータス テーブル、コスト モデル、自動化の場所、精度契約、スライドに到達しないもの 開発 🛠️ このリポジトリでの作業: ゲート、CIガード、生成された成果物、リリース 変更履歴 📋 各リリースで変更されたこと スキル内部では、skills/slideops/references/ にエージェントが読み取る仕様が含まれています: 鮮度、自動化、スタイル、テーマ、図、検証。 クレジット 知っておくべき先行事例: frontend-slides (ビジュアルファーストのテーマ選択)、presentation-skills (SlideOpsも依存するレンダリング後確認のビジュアルQAループを開拓)。 SlideOpsが追加するのはOpsの部分です: リポジトリに根ざしたコンテンツと、それがまだ有効かどうかを後で尋ねるための安価な方法。 ライセンス MIT。 LICENSEを参照してください。 商用で利用、フォーク、出荷できます。帰属表示が唯一の条件です。 生成されたデッキは、どちらにしてもあなた自身のコンテンツです。 インストール · ドキュメント · 変更履歴 · リリース SlideOpsで構築され、SlideOpsについて。 このリポジトリのスライドがコードと一致しなくなった場合は、check.py が通知します。