activity-report-composer

活动报告撰写器

版本： 1.1.0 更新日期： 2026-09-13 类别： reporting 状态： 稳定 要求： 使用此工具需要 Respira for WordPress plugin 9.0+；通过 respira_invoke_ability + MCP 服务则需要 7.1+

---

描述

将 WordPress 网站上的工作审计日志整理成一份精心撰写的报告。此技能封装了 respira_generate_activity_report（插件 9.0 及更高版本会将其列为工具；在较旧的插件上，调用 respira_invoke_ability，并在 args 下传入 ability: "respira/generate-activity-report" 和相同的参数），该工具会返回结构化数据（总计、使用次数最多的工具、节省的时间、按代理机构费率计算的节省成本、亮点）。随后，此技能将引导 Agent 使用以下六种表达形式之一撰写这些数据。

六种表达形式：

1. 代理机构客户报告 — 正式、注重成果，面向客户
2. 案例研究 — 用于营销的第三人称叙述，可选择匿名
3. 内部回顾 — 用于团队站会，简明扼要，说明已交付内容和后续计划
4. 客户证言草稿 — 第一人称，优化为客户引言
5. 公开分享进展 — 面向公众、适合社交媒体，说明本周完成的工作
6. 个人回顾 — 供操作者自行留档，不加营销修饰

---

使用场景

• 月末 — 生成客户报告以便结算
• 季度回顾 — 编写公开分享进展摘要，发布到社交媒体
• 向潜在客户推介案例研究
• 趁工作内容还记忆犹新时，记录客户证言措辞
• 代理机构团队内部周回顾

---

触发短语

• “生成一份客户报告”
• “制作月度报告”
• “活动报告”
• “撰写活动报告”
• “制作代理机构客户报告”
• “根据这个网站起草案例研究”
• “公开分享进展摘要”
• “内部回顾”
• “我这个月交付了什么”
• “客户结算报告”

---

执行工作流

步骤 1 — 确认网站和时间范围

调用 respira_get_active_site。询问用户要总结哪个时间范围：默认是最近 30 天。常见时间范围：7 天（每周）、30 天（每月）、90 天（每季度）。

步骤 2 — 确认表达形式

询问用户要采用六种表达形式中的哪一种。如果用户没有说明，请根据触发短语推荐（“客户报告” → 代理机构客户报告；“公开分享进展” → 公开分享进展形式）。如果未指定，默认使用代理机构客户报告。

步骤 3 — 获取结构化数据

调用 respira_generate_activity_report，并传入 window_days（或 start_date 和 end_date）以及 framing（agency_client_report、agency_case_study、personal_recap、team_report、testimonial_draft 或 build_in_public）。客户报告需添加 client_name；任何将要发布的内容都应添加 anonymize: true。如果列表中没有此工具，说明插件版本低于 9.0：调用 respira_invoke_ability，并在 args 下传入 ability: "respira/generate-activity-report" 和相同的参数。该工具会返回：

{
  "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. 在 30 天内通过 Respira 增强型 AI 工作流，将内容制作时间缩短了 40%。”匿名化开关：如果启用，将客户名称替换为“一家 B2B SaaS 公司”或类似描述。在亮点中匿名化所有可识别信息。

内部回顾 — 使用要点，不写叙述。“42 次编辑，涉及 14 个页面，0 次回滚。最省时的工作：批量更新 Divi 模块。下一步：发布定价页面改版。”

推荐语草稿 — 以操作者的口吻，用第一人称写成引言。“过去 30 天里，我通过 Respira 的快照优先编辑，为 [client] 节省了 5 小时的代理机构工作时间。我们发布了 14 个页面，0 次回滚。”

公开分享进展 — 风格简洁有力、适合社交媒体。“本周的 Respira 进展：编辑了 14 个客户页面，共 42 次，节省 5 小时，0 次回滚。Agent 每次修改前都会先创建快照，之后我一次都没需要撤销。来看看上线了什么 →”

个人回顾 — 为操作者自己的记录撰写简短日志。写明日期、总计、完成事项、遇到的困难和下一步。不使用营销口吻。

第 5 步 — 提供三种输出格式

报告撰写完成后，询问用户想要哪种输出格式：

• Markdown — 方便粘贴到文档、Notion、Linear 或电子邮件中
• 适合电子邮件的 HTML — 方便通过代理机构的邮件客户端直接发送
• 社交媒体风格 — 适合发布到 LinkedIn 或 X 的简短版本（仅适用于“公开分享进展”和“推荐语”表达方式）

第 6 步 — 保存（可选）

提供将报告保存为网站上的自定义文章类型条目的选项（这样报告就会显示在 Activity 报告归档中）。如果该 CPT 存在，请使用 respira_create_custom_post，并设置 post_type=respira_activity_report。

---

输出模板 — 代理机构客户报告（示例）

# 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 的响应，或来自审计日志中统计的总数。如果数据为空，请如实说明——不要凑数。
• 除非用户针对这份特定报告明确同意，否则绝不在公开分享进展或社交媒体输出中透露客户名称。默认使用“一个客户”或“我合作的一家代理机构”。
• 结构化数据中的节省时间和节省成本数字已根据操作者注明的费率计算。不要再次相乘或换算。
• 报告是输出内容，而非记录。报告保存在用户的 Markdown、电子邮件或仪表板中，不会存入审计日志本身。

---

遥测

记录：网站 URL 哈希、选定的表达方式、时间范围、响应中的总数、选定的输出格式、成功/失败状态。不发送报告正文、客户名称或备注。

端点：POST https://www.respira.press/api/skills/track-usage