activity-report-composer

アクティビティレポート作成

バージョン： 1.1.0 更新日： 2026-09-13 カテゴリ： reporting ステータス： stable 必要条件： ツールの使用には Respira for WordPress plugin 9.0+、respira_invoke_ability + MCP server 経由の場合は 7.1+

---

説明

WordPress サイトで行った作業の監査ログを、洗練されたレポートにまとめます。このスキルは respira_generate_activity_report（プラグイン 9.0 以降ではツールとして表示されます。それ以前のプラグインでは、ability: "respira/generate-activity-report" と同じ引数を args の下に指定して respira_invoke_ability を呼び出します）をラップします。このツールは、構造化データ（合計、使用頻度の高いツール、削減した時間、代理店の料金に基づく削減コスト、主な実績）を返します。その後、このスキルは、6 種類の形式のいずれかでそのデータを文章にまとめるようエージェントをガイドします。

6 種類の形式：

1. 代理店のクライアント向けレポート — クライアント宛ての、正式で成果を重視したレポート
2. 事例紹介 — マーケティング向けの三人称の説明。匿名化の切り替えが可能
3. 社内向け要約 — チームのスタンドアップ向け。簡潔に、完了したことと次の予定を記載
4. 推薦コメントの下書き — 顧客の引用コメントとして使いやすい、一人称の文章
5. ビルド・イン・パブリック — 公開向けのソーシャルメディア形式で、今週行ったことをまとめる
6. 個人向けの振り返り — 運用担当者自身の記録用。マーケティング調の装飾はなし

---

使用するタイミング

• 月末 — 請求用のクライアントレポートを作成する
• 四半期レビュー — ソーシャルメディア向けのビルド・イン・パブリック形式の要約を作成する
• 見込み客に事例紹介を提案する
• 作業内容を覚えているうちに、推薦コメントに使える表現を記録する
• 代理店チームの週次社内レビュー

---

トリガーフレーズ

• "generate a client report"
• "make a monthly report"
• "activity report"
• "compose an activity report"
• "build an agency client report"
• "draft a case study from this site"
• "build-in-public summary"
• "internal recap"
• "what did i ship this month"
• "client billing report"

---

実行ワークフロー

ステップ 1 — サイトと期間を確認する

respira_get_active_site を呼び出します。どの期間を要約するかユーザーに尋ねます。デフォルトは直近 30 日間です。よく使われる期間は、7 日間（週次）、30 日間（月次）、90 日間（四半期）です。

ステップ 2 — 形式を確認する

6 種類の形式のうち、どれを使うかユーザーに尋ねます。指定がない場合は、トリガーフレーズに基づいて提案します（「client report」→ 代理店のクライアント向けレポート、「build in public」→ ビルド・イン・パブリック形式）。指定がない場合のデフォルトは、代理店のクライアント向けレポートです。

ステップ 3 — 構造化データを取得する

window_days（または start_date と end_date）および framing（agency_client_report、agency_case_study、personal_recap、team_report、testimonial_draft または build_in_public）を指定して respira_generate_activity_report を呼び出します。クライアント向けレポートには client_name を、公開するレポートには anonymize: true を追加します。ツールが一覧にない場合、プラグインは 9.0 より前のバージョンです。ability: "respira/generate-activity-report" と同じ引数を args の下に指定して respira_invoke_ability を呼び出します。ツールは次の情報を返します：

{
  "client": "string",
  "window": "30 days",
  "framing": "agency_client_report",
  "hoursSaved": "5.1",
  "costSaved": {"amount": "408", "currency": "EUR"},
  "totals": {"edits": 42, "pages": 14, "snapshots": 27, "rollbacks": 2},
  "topTools": [
    {"name": "respira_update_module", "scope": "write", "n": 14},
    {"name": "respira_extract_builder_content", "scope": "read", "n": 23}
  ],
  "notes": ["Migrated 14 blog posts to /journal/...", "..."]
}

ステップ 4 — 選択した形式でレポートを作成する

選択した形式の語り口でレポートを作成します。

代理店クライアント向けレポート — クライアント名を宛名にし、最初に主要な数値（削減した時間、削減したコスト）を示し、次に作業の概要、最後に次のステップを記載します。プロフェッショナルな文体で、くだけた表現は使いません。

ケーススタディ — 三人称の語り口です。「Acme Inc. は、Respira を活用した AI ワークフローにより、30 日間でコンテンツ制作時間を 40% 削減しました。」匿名化トグルが有効な場合は、クライアント名を「ある B2B SaaS 企業」などに置き換えます。ハイライト内の個人や組織を特定できる情報はすべて匿名化します。

社内向けまとめ — 箇条書きのみで、説明文は含めません。「42 件の編集、14 ページに対応、ロールバックは 0 件。最も時間を節約できた作業：Divi モジュールの一括更新。次の予定：料金ページをリニューアルして公開。」

お客様の声の草案 — 担当者の声で、一人称の引用としてまとめます。「この 30 日間で、Respira のスナップショット優先の編集のおかげで、代理店の作業時間を 5 時間節約できました。[client] の 14 ページを、ロールバックなしで公開できました。」

ビルド・イン・パブリック — 短く、SNS 向けの形式です。「今週の Respira：クライアントの 14 ページで 42 件の編集、5 時間を節約、ロールバックは 0 件。エージェントが変更を試みるたびに事前にスナップショットを作成したので、元に戻す必要は一度もありませんでした。公開した内容はこちら →」

個人向けまとめ — 担当者自身のメモ用の簡潔なログです。日付、合計、完了した作業、難しかった点、次に行うことを記載します。マーケティング調の表現は使いません。

ステップ 5 — 3 種類の出力形式を提示する

レポートの作成後、希望する出力形式をユーザーに尋ねます。

• Markdown — ドキュメント、Notion、Linear、メールへの貼り付け用
• メール用 HTML — 代理店のメールクライアントから直接送信するための形式
• SNS 向け — LinkedIn または X 用の短縮版（ビルド・イン・パブリック形式とお客様の声形式のみ）

ステップ 6 — 保存する（任意）

レポートをサイト上のカスタム投稿タイプのエントリーとして保存するかどうかを提案します（アクティビティレポートのアーカイブに表示されます）。CPT が存在する場合は、post_type=respira_activity_report を指定して respira_create_custom_post を使用します。

---

出力テンプレート — 代理店クライアント向けレポート（例）

# Activity Report: {client_name} — {window}

**{hoursSaved}h of work saved · €{costSaved} at our standard rate**

## Summary

In the last {window}, {totals.edits} edits landed across {totals.pages} pages on {client_name}'s site. {totals.snapshots} snapshots were captured before any change, and {totals.rollbacks} were rolled back during review.

## What we did

{notes formatted as bullet list}

## Top operations

{topTools formatted as a small table — name, read/write, count}

## Next steps

{agent fills in — could be empty if no obvious next steps, or could reference open work}

---

Prepared by Respira for {client_name} · {date}

---

匿名化ルール（ケーススタディ形式のみ）

ユーザーがケーススタディ形式を選択し、匿名化をオンにした場合：

• クライアント名はすべて、業種を示す表現に置き換えます（「ある B2B SaaS 企業」「リスボンを拠点とするデザイン代理店」「複数の拠点を持つレストラングループ」）
• 具体的な URL は [client website] に置き換えます
• ページ名は一般的な説明に置き換えます（「料金ページ」「採用情報セクション」「長文のセールスランディングページ」）
• チームメンバーの名前は役職を示す表現に置き換えます（「先方のマーケティング責任者」「創業者」）
• すべての数値は正確なままにします。数値が成果の証拠です
• 最後に「お客様のご要望により、顧客データを匿名化しています」と記載します

---

厳守事項

• 数値を捏造しないでください。レポート内のすべての数値は、respira_generate_activity_report の応答、または監査ログで集計した合計値から取得します。データが空の場合は、その旨を記載し、数値を補わないでください。
• ユーザーがこの特定のレポートで明示的に許可しない限り、ビルド・イン・パブリック形式や SNS 向けの出力で顧客名を出さないでください。デフォルトでは「あるクライアント」または「私が仕事をしている代理店」とします。
• 構造化データ内の削減時間と削減コストの数値には、担当者が申告したレートがすでに反映されています。掛け算や換算をしないでください。
• レポートは出力であり、記録ではありません。監査ログ自体ではなく、ユーザーの Markdown、メール、ダッシュボードに保存されます。

---

テレメトリー

記録する内容：サイト URL のハッシュ、選択した形式、期間、応答から取得した合計値、選択した出力形式、成功または失敗。レポート本文、クライアント名、メモは送信されません。

エンドポイント：POST https://www.respira.press/api/skills/track-usage