better-logging
Better Logging 是一个面向开发者的可观测性技能,目标是把 HTTP、IPC、tRPC、后台任务、启动流程与队列中的关键操作,转化为持久化、可查询的结构化结果事件,从而用一次查询回答“发生了什么”,而不是在多条日志中反复翻找。它强调以“运行时拥有的一个操作”为埋点单元,而不是在代码里散布零散日志语句。该技能提供审计脚本先扫描仓库中可能的操作边界、既有埋点、关联字段与持久结果信号,并给出事件 schema、Electron/tRPC/IPC 与 Node HTTP/队列/定时任务的运行时模式参考,以及上线与查询清单。使用方式为先运行 scripts/audit_queryable_outcomes.py,再按运行时读取对应参考文档,定义规范事件结构,然后在边界处添加统一 wrapper,从入口开始记录、运行中补充上下文、在 finally 中完成并持久化,确保成功与失败路径都会产生结果。适用场景包括 HTTP 处理、tRPC 过程、IPC 命令、队列消费者、后台作业、定时任务与启动流程等。限制与注意事项:应优先只对最关键的 3 个操作埋点;错误码需稳定可查询;必须记录耗时与重试次数并尽早加入关联字段;敏感信息需脱敏或哈希;不应默认输出巨型对象;操作真相与产品分析要分开,可镜像但不可替代;不应依赖临时控制台日志或内存缓冲;具体支持的框架生态、版本与完整安装步骤暂未提供。