Code Debugger

Overview

在修改代码前先建立完整上下文关系网络，最小化变更并记录可追溯的调试文档，确保修复可验证、可回滚、可复盘。

开发环境与运行上下文（优先确认）

在执行验证、测试或 Checkfix 之前，务必确认项目的「部署-开发」架构，避免在错误环境中跑命令导致死循环或无法推进：

• 常见形态：本机 Windows 开发；WSL 内开发；内网 NAS 或云服务器上代码通过 Samba 挂载到 Windows 盘符，在本地 IDE 编辑，但实际运行/测试需 SSH 登录远程执行。
• 若无法从仓库或路径推断：主动问开发者一句，例如：「项目是否在 NAS/Samba+SSH 或远程服务器上开发？当前是怎么跑测试/构建的？」
• 若是远程/NAS-Samba+SSH 形态：
  • 询问是否已有现成的 SSH 登录方式（如 ssh nas、ssh dev 等别名或主机配置）。
  • 若无，则指导用户建立公钥-私钥登录（ssh-keygen + 将公钥写入远程 ~/.ssh/authorized_keys），并确认项目在远程机器上的实际路径（如 /mnt/dev/xxx、/home/user/proj）。
  • 后续验证与 Checkfix 的 shell 命令应在该上下文中执行（例如 ssh nas "cd /mnt/dev/xxx && cargo test"），而不是在本地 Samba 映射路径下直接执行，以保障调试流畅、节省成本并防止 AI 反复无效尝试。
• 首次与用户确认后，将上述判断结果写入当前模块的 .debug 文档，作为「运行上下文/测试规则」（运行环境类型、SSH 方式、远程项目路径、验证/Checkfix 执行方式等）。后续再调用本命令时，优先从 .debug 读取该规则，不再反复询问。

Workflow