render-workspace-html について
render-workspace-htmlはpaper-workspaceからオフラインのHTMLダッシュボードを作成し、論文ワークフローを追跡する著者を支援します。成果物を段階別に整理し、元ファイルを変更せずに最近の活動を表示します。
主な機能
- 01段階別の進捗表示
- 02リンク付き成果物カード
- 03最近の活動タイムライン
- 04単一ファイルのオフライン画面
- 05ワークスペースから更新
活用シーン
- 01複数の作業後に進捗を確認
- 02段階別に生成物を閲覧
- 03ローカルの状況ページを更新
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ shaishavmaisuria/ research-paper-lifecycle-skills --skill render-workspace-htmlインストール後、Claude Code で/render-workspace-htmlを入力して読み込まれたか確認します。
同梱ファイルscripts/build_dashboard.py
詳細
ワークスペースを HTML で表示
paper-workspace/ ディレクトリを、著者がブラウザーで開けるダッシュボードに変換します。ライフサイクルの進捗、ステージごとにグループ化された生成済み成果物とクリック可能なリンク、最近のアクティビティのタイムラインを表示します。他のスキルが生成するファイルをもとに、「今どこにいるか/何が完了したか」を視覚的に確認できます。
これはオプトインです。視覚的な概要が本当に役立つ場合(作業をまとめて行った後や、著者から依頼された場合)に提案し、毎回生成することは避けてください。著者が常に最新の状態に保つことを希望した場合は、重要な変更のたびに更新し、古くならないようにしてください。
使用するタイミング
- 著者から HTML ビュー、ダッシュボード、またはブラウザーで読める進捗の概要を求められた場合。
- 複数のスキルを実行し、ワークスペースに一目見る価値があるだけの内容が揃った後。
- 著者が「HTML を最新の状態に保って」と言った場合は、その後、ワークスペースを変更したリクエストの最後に毎回再生成します。
プロセス
- 押し付けずに提案します。 著者から依頼されていない場合は、「進捗を HTML ダッシュボードにまとめますか?変更のたびに更新できます。」と一度だけ尋ねます。はいと答えた場合にのみ生成します。
- 生成します(決定的):
python3 scripts/build_dashboard.py --workspace paper-workspacepaper-workspace/INDEX.mdと各ステージのフォルダー(タイトルや会場が記載されていれば.paper-memory/profile.ymlも)を読み込み、paper-workspace/dashboard.htmlに書き出します。CSS をインラインに含む、ネットワーク接続や外部アセットが不要な、ライト/ダーク表示に対応した単一の自己完結型ファイルです。ワークスペースがまだ存在しない場合にのみ、終了コード 1 を返します。 - 著者に保存先を案内します(
open paper-workspace/dashboard.html)。表示内容を要約します。 - 依頼に応じて更新します。 常に最新の状態に保つよう著者から依頼された場合は、新しい成果物を書き出したリクエストの最後にステップ 2 を再実行し、更新したことを伝えます。それ以外の場合は、再度依頼されたときにのみ再生成します。
出力
paper-workspace/dashboard.html — ステージごとの進捗バー、各出力へのリンク付き成果物カード、INDEX.md に基づく最近のアクティビティのタイムラインです。オフラインでも、どのブラウザーでも開けます。
より高度なレポート
このスキルは高速で、依存関係なしに使えるように設計されています。オフラインで動作し、繰り返し更新できる、単一の自己完結型ファイル dashboard.html を生成します。著者からデザイン性やインタラクティブ性の高いレポートを求められ、現在のエージェント実行環境に別のウェブアーティファクト、フロントエンド、またはレポート作成スキルがインストールされている場合は、そのツールにワークスペースの概要を引き継ぐことを提案してください。このダッシュボードを既定のステータス表示として維持し、より高度な作成ツールは著者がプレゼンテーション品質の HTML を求めた場合にのみ使用します。
ガードレール
- ローカルのみ。 ダッシュボードはローカルの成果物から作成するローカルファイルです。アップロード、ホスティング、またはこのスキルのリポジトリへのコピーは行わないでください。第三者の論文コンテンツは表示しません(著者自身の出力のみを表示します)。
- 自己完結型で、トラッキングなし。 インライン CSS のみを使用します。外部スクリプト、フォント、画像、分析ツールは使用しません。
- オプトイン。 毎回、求められていないのにダッシュボードを生成しないでください。先に提案し、その後は著者の希望に応じて更新します。
- 他のスキルが生成した内容を表示するだけであり、成果物の編集、採点、論文の編集は行いません。
メモリー
共有 .paper-memory/ 規約(paper-memory-convention.md)を使用します。
- 開始時:
profile.ymlを読み、ダッシュボードに表示する論文のタイトルや会場を確認します。また、著者が自動更新を希望しているか確認します。 - 終了時: 自動更新の設定(
date · render-workspace-html · auto-refresh on/off)を記録し、後続の実行で再度尋ねずに設定を反映できるようにします。 - 必要に応じて
.paper-memory/を作成します。ローカルのみで使用し、アップロードはしません。