用途：为 API 实现结构化请求日志，覆盖关联 ID、性能计时、安全审计轨迹与 PII 脱敏，便于调试、性能分析与合规审计。
主要能力：请求日志中间件记录时间戳（ISO 8601）、关联 ID、HTTP 方法、URL 路径（去除查询串中的 PII）、状态码、响应时间（毫秒）、请求/响应大小与客户端 IP；为每个请求生成并传播 X-Request-ID；按字段路径规则脱敏密码、令牌、SSN、邮箱等敏感字段；按上下文分级（成功 info、4xx warn、5xx error 含堆栈、请求/响应体 debug 仅开发）；仅对 4xx/5xx 记录响应体；对认证尝试、权限变更、数据导出、管理操作等敏感操作打 audit: true 标签；配置日志轮转与保留（应用日志 30 天、审计日志 90 天，超过 7 天自动压缩）。
使用方式：先检查现有日志配置，再实现中间件与工具模块，输出包括 request-logger.js、correlation-id.js、pii-redactor.js、audit-logger.js、logging.js 及测试目录；完整实现指南见 ${CLAUDE_SKILL_DIR}/references/implementation.md，错误模式见 errors.md，示例见 examples.md。
适用场景：分布式服务的请求追踪、性能分析、SOC 2 等合规审计证据收集。
限制与前置条件：需结构化日志库（Pino/Winston、structlog、Logback JSON）、日志聚合系统（ELK、Loki 或 CloudWatch Logs）、关联 ID 传播机制、PII 分类与保留策略。注意日志量、PII 泄漏、关联 ID 缺失、JSON 解析失败与审计日志丢失等风险，建议对可记录字段采用允许列表并同步写审计事件。