mcpField
K
k2f-business-report

k2f-business-report

github.com/suzhengドキュメント32.5k 回インストール2 週間前に更新
リポジトリ

k2f-business-report について

k2f-business-reportは、エージェントがレポートの構成、分析、デザインを事前設計し、k2fでK2Fファイルを生成・出力するためのスキルです。業績レビューや経営層向け報告を対象に、事実・解釈・提案を分け、データの不足を明示します。

主な機能

  1. 01対象者・期間・報告の問いを定義
  2. 02要約・指標・推移・施策を構成
  3. 03事実・解釈・提案を区別
  4. 04データ不足を示し数値の捏造を回避
  5. 05k2fによるレポートの生成と出力

活用シーン

  1. 01表計算やCRMデータから定期業績報告を作成
  2. 02提供データに基づく診断レポートを作成
  3. 03取締役会や経営層向けの判断要約を準備

インストール

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

$npx skills add https://github.com/suzheng/k2f --skill k2f-business-report

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

詳細

K2F Business Report — AI-Native Aesthetic Design

目的

レイアウトに取りかかる前に、エージェントがビジネスレポートの設計図を作成できるようにします。根拠からアクションへつなぐ、意思決定を重視したストーリーを組み立て、データの不足を正直に明示し、経営層が数分で業績を把握できる階層構造を設計します。解釈のない一般論や、チャートを並べるだけのレポートは作成しません。

K2F を基盤として構築

このスキルでは、ビジネスレポートを .K2F パッケージとして作成します。作成時はk2fスキルに従ってください。ワークスペースを展開するか初期化し、セマンティックツリーを編集して、パックと検証を実行してからエクスポートします。K2F により、エージェントはピクセル座標ではなく、意味(セクションの役割、指標、推奨事項)に集中できます。エンジンがレイアウト、タイポグラフィ、テーマをコンパイルするため、PDF、DOCX、PPTX などの各形式で一貫した出力が得られます。

作成を始める前に、コアスキルをインストールしてください:npx skills add suzheng/k2f --skill k2f。

使用する場面

  • スプレッドシート、CRM エクスポート、または貼り付けられた指標をもとにした、週次、月次、四半期の業績レビュー。
  • ユーザー提供データから、弱点、深刻度、改善策を示す診断レポート。
  • トレンド、リスク、次のステップを一貫したストーリーにまとめる、取締役会や経営陣向けのサマリー。

ワークフロー

ステップ 1. content_and_design.md を生成する

セマンティックな内容とデザインの意図をまとめた、単一の設計図です。k2fスキルが後からセクションやビジュアルに対応付けられるよう、ラベル付きブロックを使用します。

サブステップ

  1. レポートの基本方針 — 対象読者(経営層、運用担当者、取締役会)、対象期間、主要な問い(「計画どおりに進んでいるか?」「どこで損失が出ているか?」)、報告頻度(週次の概況か、四半期ごとの詳細分析か)を定めます。ユーザーが実際に提供したデータソースを列挙し、数値を創作せず、不足データを明示します。

  2. 範囲を明確にする(入力が少ない場合) — 重要な指標、比較基準(前期、目標、予算)、読者が詳細な情報を必要とするか、要点のみでよいかを確認します。基本方針で定めた範囲を超えて広げないでください。

  3. 情報設計 — 標準的な構成(週次の概況では調整または短縮してください):

    • 表紙/タイトルブロック:レポート名、対象期間、提出先、日付。
    • エグゼクティブサマリー:結論を示す見出し、要点を3~5項目、最も重要なリスクと機会を記載します。数値はユーザーデータで裏付けられるものに限ります。
    • 主要指標:主要 KPI を絞り込み、現在値、前期比、目標比を示します。それぞれに解釈を一文添えます。
    • 業績トレンド:時系列またはセグメントごとのストーリーを示します。増加、減少、変動などの傾向が重要な場合は、長い段落よりも、役割に合ったチャートを優先します。
    • 調査結果/弱点:深刻度の高い順に並べます。各項目では、観察事項、ビジネスへの影響、妥当な要因(データにない場合は推論と明記)を示します。
    • 推奨事項:調査結果に結び付いた施策を3~6件挙げます。各施策には、目的、優先順位を付けたアクション3~5件、期待される効果(高/中/低)、期間、成功指標を記載します。
    • 付録の方針(任意):表、定義、方法論を記載します。読者に監査証跡が必要な場合に限ります。
  4. 分析の規律 — 事実(提供データに基づく内容)、解釈(データの読み取り)、推奨事項(提案するアクション)を区別します。異常値やデータ品質の問題を明示します。深刻度を割り当てる場合は、その基準(例:マイナス成長、目標未達、セグメントが下位四分位)を記載します。ベンチマークや統計を捏造しないでください。

  5. 推奨事項の構成 — 各戦略では明確なプログラムを示し、特定の弱点に結び付け、測定可能な成功基準で締めくくります。「マーケティングを改善する」のような一般論は避けてください。ユーザーがチームを挙げている場合は、担当者の種類を示すなど、具体的なアクションに書き換えます。

  6. デザインの意図 — エンジンのトーン、階層、情報密度、配色を文書化します。

    • トーン:自信に満ちた、中立的かつ分析的なトーン。会議中に流し読みしやすい内容にします。誇張や、謝罪を長々と述べる文章は避けます。
    • 階層:エグゼクティブサマリーとKPI一覧は最も高いコントラストにします。調査結果は重大度を視覚的な順位として示し、重大なものから軽微なものへ並べます。推奨事項は、ざっと目を通しやすいカードまたは番号付きブロックにします。
    • 情報密度:箇条書きと短い段落を使い、1つのブロックにつき1つのアイデアを扱います。指標の一覧には表を使い、説明の深さはサマリーと各調査結果の「それが意味すること」に充てます。
    • 配色:プロフェッショナルな企業向けの配色にします(深みのあるニュートラルなテキストと、変化量および重大度を示す1色のアクセント)。WCAG AAに準拠し、グラフは一貫した種類(トレンドライン、順位付き棒グラフ、構成比)に限定します。装飾的なダッシュボード要素は避けます。

ルールと制約

  • 意思決定の軸:すべてのセクションで「リーダーシップ層は何を変えるべきか?」に答えます。興味深くても行動につながらない分析は削除します。
  • 件数より重大度:順位付けされた少数の問題を、長くて優先順位のないリストより重視します。
  • グラフか文章か:インサイトが形や比較に関するものならグラフを使い、因果関係やニュアンスの説明が必要なら文章を使います。
  • 誠実さの原則:データが欠けている場合は NEEDS USER INPUT とします。もっともらしい数値で補完してはいけません。
  • 対象読者への適合:週次レポートでは変化量とアクションを強調し、四半期レポートではトレンドの背景情報と施策ポートフォリオを加えます。

よくある失敗

  • 結論のないデータの羅列 → 明確な見出しと順位付きの要点を含むエグゼクティブサマリーを追加します。
  • 推奨事項が調査結果と結び付いていない → 各施策を調査結果のIDに対応付けます。
  • 曖昧な弱点(「売上はもっと伸ばせる」など) → 指標、期間、しきい値を明記します。
  • すべてのKPIを同じ重みで扱う → 主要指標を4~7個指定し、残りは付録に移します。
  • 折れ線グラフで説明できるトレンドを文章で長々と説明する → ブロックをグラフの役割と解釈を示す1文に切り替えます。
  • 成長率やベンチマークを捏造する → 削除するか、ユーザーの確認待ちの仮定として明記します。
  • 汎用的な戦略の定型文 → 具体的なアクションと指標を含む、名称付きのプログラムとして書き直します。

品質チェックリスト

  • 憲章に対象読者、期間、主な問いが記載されています。
  • エグゼクティブサマリーだけで内容を把握でき、要点が本文の調査結果と一致しています。
  • 各KPIに値、比較、1行の「それが意味すること」があります。
  • 調査結果が重大度順に並び、それぞれに影響が記載されています。
  • すべての推奨事項が調査結果に結び付き、成功指標を含んでいます。
  • 事実をユーザー入力までたどることができ、不足情報が明示されています。
  • デザインの意図で、サマリー、KPI、調査結果、推奨事項の階層が指定されています。
Step 2. content_and_design.md と k2f スキルを使って K2F ファイルを生成し、適切なファイル形式にエクスポートします。

k2f スキルに従って、ブループリントからセクションとグラフの役割を作成し、デザインの意図を適用して検証したうえで、エグゼクティブ向けの成果物をエクスポートします。

コメント