社区机器人月报最难写的部分，往往不是排版，而是承认哪些结果没有记录。没有完整日志，就无法可靠回答处理了多少问题、节省了多少小时。仍然可以交付一份有价值的月报：写清已知、未知，以及下一步怎样补上证据。

本月推出的观测导出能力，让工具作者有更多记录执行过程的选择。不过遥测中的一次调用，不等于社区里一个问题被解决。月报应从业务问题出发，再决定需要哪些字段。

先确定窗口与对象

窗口可以采用明确时区的半开区间[start,end)，避免相邻月份重复统计边界事件。对象是唯一Issue、会话、投递还是工具调用，要在表头说明。

统计窗口结束前，可以先准备月报格式和统计脚本；完整月度结果需等窗口结束后，根据真实记录生成。

未知值不要写成零

没有采集不等于没有发生。比如解决状态缺失，应该显示unknown；只有确认窗口内没有匹配记录，才写观察到的零。样本缺失与观测零的含义不同。

图中的UNKNOWN是空模板占位；右侧展示证据支持、不确定和证据否定时的处置条件，不表示未知数据可以直接通过。EVIDENCE用于定位原始记录或人工核验说明。内容敏感时可以保存受控引用，而不是把全部提问复制进公开报告。

用边界夹具验证窗口选择

代码只统计明确窗口内的教学事件，并把未知结果单独保留。日期用于测试边界，不代表已经发生的社区活动。

import assert from 'node:assert/strict';
function report(events,start,end) {
 const a=Date.parse(start),b=Date.parse(end);if(!(a<b))throw Error('invalid_window');
 const selected=events.filter(e=>{const t=Date.parse(e.at);return t>=a&&t<b;});
 return {observed:selected.length,confirmed:selected.filter(e=>e.solved===true).length,
 unknown:selected.filter(e=>e.solved==null).length};
}
const fixture=[{at:'2026-10-01T00:00:00Z',solved:true},
 {at:'2026-10-23T00:00:00Z',solved:null},{at:'2026-11-01T00:00:00Z',solved:true}];
assert.deepEqual(report(fixture,'2026-10-01T00:00:00Z','2026-11-01T00:00:00Z'),
 {observed:2,confirmed:1,unknown:1});
assert.throws(()=>report([], '2026-11-01','2026-10-01'),/invalid_window/);
console.log('monthly window and unknowns: ok');

本地运行输出：

monthly window and unknowns: ok

把数字连接到维护动作

除了计数，还可以列出三类典型失败：错误文档版本、缺复现材料、外部动作结果未知。每类给一个改进动作与负责入口，避免月报只剩漂亮的饼图。

如果这次没有足够数据，就从下一轮开始记录最小字段。公开说明统计缺口，比猜一个看起来合理的处理量更能建立信任。

适用范围与未测部分

只有教学事件的窗口统计，没有真实月度运营数据，也未进行工时节省测量；未来窗口的结果不能提前得出。

参考资料

• OpenTelemetry tracing for the Claude API
• GitHub Webhook best practices