调试与追踪配置

要解决什么问题

多服务、多环境系统里，问题往往跨进程与跨节点：本地能复现的 bug 在生产消失，或反过来只有线上才出现。若缺少统一的 correlation ID、追踪边界和日志字段约定，排查会变成「各服务各打各的日志」，难以还原一次请求的完整路径。本技能面向需要把 调试工作流、分布式追踪 和诊断习惯落到配置与实践上的团队，而不是只做单进程断点调试。

技能如何工作

技能把角色设定为调试专家，围绕 $ARGUMENTS 中的具体需求展开，典型路径包括：

• 识别边界：厘清服务划分、追踪边界与关键 span，避免追踪网过粗或过细。
• 分层配置：区分本地调试与生产可用的追踪策略（采样、级别、开销）。
• 标准化字段：统一日志/追踪字段与关联 ID，便于在日志与 trace 之间跳转。
• 校验覆盖：检查端到端追踪是否覆盖关键路径，采样是否合理。

需要工具选型与配置模式时，可参照 resources/implementation-playbook.md 中的详细工作流。

适用边界与注意点

单进程、简单断点即可的场景不必上全套追踪；若无法改动日志、追踪或运行时配置，技能能给出的多为方案与设计，难以落地。生产环境启用高粒度追踪前必须有采样与性能保障；日志与 trace 中须对密钥与 PII 做脱敏，避免「为了排障把敏感数据写进可观测性后端」。