mcpField
R
report-render

report-render

github.com/aymericderboisドキュメント40 回インストール
リポジトリ

report-render について

会話にすでに含まれる内容を、書き換えたり情報を補ったりせず、単体の HTML レポートに整形するスキルです。共通テンプレートにテキスト注釈機能を備え、計画、変更説明、分析、監査の整理に使えます。

主な機能

  1. 01会話内容を単一の HTML ファイルに整形
  2. 02元の見出し、順序、表現を維持
  3. 03題材に基づく短い slug のファイル名
  4. 04コンテンツブロックにアンカーを追加
  5. 05テキスト選択と注釈機能を搭載
  6. 06フィードバックを Markdown でコピー

活用シーン

  1. 01planify の計画をレポート化
  2. 02ファイルごとの変更説明を提示
  3. 03分析や監査の内容を整理
  4. 04レポート注釈を集めて planify に反映

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aymericderbois/skills --skill report-render

インストール後、Claude Code で/report-renderを入力して読み込まれたか確認します。

同梱ファイルreferences/html-report.md

詳細

HTMLレポートのレンダリング

書式を整えるだけで、判断はしません。すでに会話内にある内容を受け取り、自立したHTMLレポートにまとめます。質問をしたり、判断したり、渡された内容にない情報を作り出したりすることはありません。planify-write-plan と同じ考え方ですが、出力はHTMLです。

入力

レンダリングする内容は会話から取得します。典型的なケースは3つありますが、すべて同じテンプレートで処理します。

  • planify が作成した計画(タスク、受け入れ条件)。
  • explain-your-changes が作成した変更の説明(差分+ファイルごとの説明)。
  • ユーザーが直接提供した任意の内容(分析、監査、メモなど)。

書式を整える内容が曖昧な場合は、会話内で最も新しい関連内容を使用します。

出力

単一のファイル:.reports/<slug>.report.html。

  1. <slug> は、題材から作成した短いケバブケースのスラッグ(意味のある語を2〜5個)です。planify の計画をレンダリングする場合は、計画の <prefix> を再利用します(例:report-render → .reports/report-render.report.html)。
  2. .reports/ フォルダーが存在しない場合は作成します。
  3. references/html-report.md に従ってHTMLを記述します。コピーするスキャフォールド、デザインシステム(配色、タイポグラフィ、レイアウト、ライト/ダークテーマ)、再利用可能なブロックのカタログが含まれています。
  4. 各 <section> には data-annote アンカーを付けます(計画の場合はタスクID T3、それ以外の場合はタイトルのスラッグ)。そして、注釈レイヤーを </body> の前に貼り付けます。これはすべてのレポートに含めます。

ルール

  • 実際の内容のみ:プレースホルダーテキスト(「lorem」など)は使わず、空のセクションを作り出さないでください。
  • 元の内容の見出し、順序、表現をそのまま使用します。書式を整えるだけで、内容を書き換えてはいけません。
  • レポートは自立型です。追加のローカルリソースを必要としない単一の .html ファイルにします。

フィードバック

レポートには注釈レイヤーを組み込みます。読み手は文章を選択してコメントを付け、「フィードバックをコピー」をクリックすると、Markdownブロックを取得できます。このブロックを planify に貼り付けると、引用された箇所が特定され、フィードバックが適用されます。形式とコンポーネントの詳細は references/html-report.md を参照してください。

完了時

書き込んだパス(クリック可能な形式:.reports/<slug>.report.html)を示し、ブラウザーで開くようユーザーに案内します。レポートに注釈を付け(テキストを選択)、フィードバックを planify に貼り付けられることも伝えます。

コメント