activity-report-composer

这段内容是审核时保存的快照。外部来源才是完整且最新的版本。

---
name: activity-report-composer
description: "Use when the user asks for a client report, a monthly or activity report, a case study draft, or says 'what did i ship this month'. Turns the site audit log into a written report in one of six framings: agency client report, case study, internal recap, testimonial draft, build-in-public, personal recap."
license: MIT
metadata:
  author: Respira for WordPress
  author_url: https://respira.press
  version: 1.0.0
  mcp-server: respira-wordpress
  category: reporting
---

# Activity Report Composer

**Version:** 1.0.0
**Updated:** 2026-05-24
**Category:** reporting
**Status:** stable
**Requires:** Respira for WordPress plugin 7.1+ + MCP server

---

## Description

Turn the audit log of work done on a WordPress site into a polished, written report. This skill wraps the new v7.1 `respira_generate_activity_report` MCP tool, which returns structured data (totals, top tools used, hours saved, cost saved at agency rate, highlights). The skill then walks the agent through writing that data into one of six framings.

The six framings:

1. **Agency client report** — formal, results-focused, addressed to the client
2. **Case study** — third-person narrative for marketing, anonymize-toggle available
3. **Internal recap** — for team standups, terse, what shipped + what's next
4. **Testimonial draft** — first-person, optimized as a customer quote
5. **Build in public** — public-facing, social-media-shaped, what got done this week
6. **Personal recap** — for the operator's own records, no marketing varnish

---

## When to Use

- End of month — generate a client report for billing
- Quarterly review — build-in-public summary for socials
- Pitching a case study to a prospect
- Capturing testimonial language while the work is fresh
- Internal weekly review for an agency team

---

## Trigger Phrases

- "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"

---

## Execution Workflow

### Step 1 — Confirm site + window

Call `respira_get_active_site`. Ask the user which window to summarize: default is the last 30 days. Common windows: 7 days (weekly), 30 days (monthly), 90 days (quarterly).

### Step 2 — Confirm framing

Ask the user which of the six framings to use. If they don't say, recommend based on the trigger phrase ("client report" → agency client report; "build in public" → build in public framing). Default if unspecified: agency client report.

### Step 3 — Pull the structured data

Call `respira_generate_activity_report` with the window and framing. The tool returns:

```json
{
  "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/...", "..."]
}
```

### Step 4 — Compose the report in the chosen framing

Write the report using the framing's voice:

**Agency client report** — addressed to the client by name, leads with the headline number (hours saved, cost saved), then the work summary, then next steps. Professional, no informalities.

**Case study** — third-person narrative. "Acme Inc. reduced their content production time by 40% in 30 days using Respira-augmented AI workflows." Anonymize toggle: if enabled, replace the client name with "a B2B SaaS company" or similar. Anonymize all identifying details in the highlights.

**Internal recap** — bullets, no narrative. "42 edits, 14 pages touched, 0 rollbacks. Top time-saver: bulk Divi module updates. Next: ship the pricing page redesign."