Reporting 是一个标准化的报告生成工具，专为周期性报告、系统审计、收入追踪和进度记录而设计。它通过预定义的模板体系，帮助团队以一致的结构化格式输出关键业务信息，确保数据的可追溯性和可读性。所有生成的报告均自动保存至 workspace/artifacts/ 目录，并遵循统一的命名规范，便于归档与检索。该工具适用于需要定期汇报进展或进行系统性评估的场景，如周报回顾、月度审计或项目里程碑总结。
Reporting 的核心优势在于其模板驱动的工作流。用户无需从零开始编写报告内容，而是根据具体需求选择对应的模板——包括周回顾、全系统审计、每日日志和收入快照等类型。每个模板都定义了清晰的字段结构，涵盖收入分析、任务完成情况、服务稳定性、资源利用率等多个维度。同时，模板支持变量替换语法（{{PLACEHOLDER}}），可根据实际上下文动态填充内容，提升报告的准确性与相关性。
此外，Reporting 强调输出的规范性与可追溯性。所有报告文件均以 ISO 日期格式命名（如 weekly-retro-2024-06-09.md），并在文末标注生成时间和作者信息，确保责任归属明确。对于篇幅较长的报告（超过一页），还会自动生成“执行摘要”部分，方便高层快速把握重点。整体设计兼顾自动化与灵活性，既减少重复劳动，又保留必要的定制化空间。
核心功能特点
- 提供标准化报告模板，涵盖周回顾、全系统审计、每日日志和收入快照四种核心类型
- 所有报告自动保存至 workspace/artifacts/ 目录，采用 {type}-{YYYY-MM-DD}.md 的统一命名规范
- 支持变量替换语法 {{PLACEHOLDER}}，实现动态内容填充与个性化定制
- 包含生成时间戳和作者信息，确保报告来源可追踪、责任清晰
- 长报告自动生成执行摘要，提升阅读效率与决策支持能力
适用场景
Reporting 工具最适合那些需要系统化、周期性输出结构化信息的场景。例如，在每周日傍晚进行团队复盘时，可以使用 Weekly Retrospective 模板汇总当周的收入表现、代理经济状况、已完成功能、受阻问题以及下周优先级，形成一份完整的工作回顾文档。同样，每月或项目关键节点触发时，可通过 Full System Audit 模板对整体系统进行深度审查，包括收入管道、流程瓶颈、人员利用率及基础设施效率等，为战略调整提供依据。
在日常运营中，每日结束时使用 Daily Progress Log 记录当天完成的任务、重要决策、遇到的障碍以及次日计划，有助于保持工作节奏的连贯性和透明度。而当涉及财务监控时，Revenue Snapshot 模板则能按周或按需生成收入明细、支出统计、净损益及目标达成进度，辅助管理层掌握经营健康状况。这些场景的共同特点是：信息具有长期价值、需跨周期对比、且要求形式统一以便后续分析。
需要注意的是，Reporting 并不适用于即时沟通或非正式更新。例如，在聊天中询问‘今天做了什么？’应直接在对话中回答；临时查询天气或发送 Discord 状态消息也不属于此工具的适用范围。对于边缘情况，如请求周中报告，可使用周报模板但注明数据不完整；若仅审计某个子系统，则可在完整审计模板中将无关部分标记为 N/A。即便如此，零收入或阶段性停滞也应如实记录，因为零本身就是有价值的数据点。