report-render について
会話にすでに含まれる内容を、書き換えたり情報を補ったりせず、単体の HTML レポートに整形するスキルです。共通テンプレートにテキスト注釈機能を備え、計画、変更説明、分析、監査の整理に使えます。
主な機能
- 01会話内容を単一の HTML ファイルに整形
- 02元の見出し、順序、表現を維持
- 03題材に基づく短い slug のファイル名
- 04コンテンツブロックにアンカーを追加
- 05テキスト選択と注釈機能を搭載
- 06フィードバックを Markdown でコピー
活用シーン
- 01planify の計画をレポート化
- 02ファイルごとの変更説明を提示
- 03分析や監査の内容を整理
- 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。
<slug>は、題材から作成した短いケバブケースのスラッグ(意味のある語を2〜5個)です。planifyの計画をレンダリングする場合は、計画の<prefix>を再利用します(例:report-render→.reports/report-render.report.html)。.reports/フォルダーが存在しない場合は作成します。references/html-report.mdに従ってHTMLを記述します。コピーするスキャフォールド、デザインシステム(配色、タイポグラフィ、レイアウト、ライト/ダークテーマ)、再利用可能なブロックのカタログが含まれています。- 各
<section>にはdata-annoteアンカーを付けます(計画の場合はタスクIDT3、それ以外の場合はタイトルのスラッグ)。そして、注釈レイヤーを</body>の前に貼り付けます。これはすべてのレポートに含めます。
ルール
- 実際の内容のみ:プレースホルダーテキスト(「lorem」など)は使わず、空のセクションを作り出さないでください。
- 元の内容の見出し、順序、表現をそのまま使用します。書式を整えるだけで、内容を書き換えてはいけません。
- レポートは自立型です。追加のローカルリソースを必要としない単一の
.htmlファイルにします。
フィードバック
レポートには注釈レイヤーを組み込みます。読み手は文章を選択してコメントを付け、「フィードバックをコピー」をクリックすると、Markdownブロックを取得できます。このブロックを planify に貼り付けると、引用された箇所が特定され、フィードバックが適用されます。形式とコンポーネントの詳細は references/html-report.md を参照してください。
完了時
書き込んだパス(クリック可能な形式:.reports/<slug>.report.html)を示し、ブラウザーで開くようユーザーに案内します。レポートに注釈を付け(テキストを選択)、フィードバックを planify に貼り付けられることも伝えます。