debugging

bearcove 的头像作者 bearcove

pikru的调试约定。在添加调试跟踪或调查问题时使用。重要规则 - 保持调试跟踪不变。

📖 中文导读:pikru的调试约定。在添加调试跟踪或调查问题时使用。重要规则 - 保持调试跟踪不变。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: debugging description: Debugging conventions for pikru. Use when adding debug traces or investigating issues. Important rule - leave debug traces in place.

Debugging

When in doubt, add tracing:

  • C code: DBG() macro
  • Rust code: tracing::debug!() (not eprintln!)

IMPORTANT: Leave debug traces in place!

  • DO NOT remove DBG() calls from C code after debugging
  • DO NOT remove tracing::debug!() calls from Rust code after debugging
  • DO NOT run make clean in vendor/pikchr-c (it's disabled anyway)

Rationale

  • The C implementation is not used in production - debug traces are helpful for future investigations
  • Rust tracing can be turned on/off at compile time via RUST_LOG environment variable
  • Having traces in place makes future debugging much faster