用途：awiki-debug 是 awiki-cli 的调试辅助技能，用于在常规排查手段不足时检查本地 SQLite 数据、原始 RPC、模式缓存与日志。使用前需先读 ../awiki-shared/SKILL.md。
使用时机：仅当 awiki-cli status、docs [topic]、schema [command]、doctor、config show 及对应领域技能均无法解决问题时才使用。
现有能力：awiki-cli debug db query "<SQL>" 用于本地数据库检查；awiki-cli debug db import-v1 [--path <legacy_dir>] 用于本地数据库变更与迁移导入，须先干跑并获用户明确确认。debug raw rpc、debug schema-cache、debug logs [--follow] 尚属计划中，未实现，不可假定存在。
安全决策：命令形状或参数问题用 schema；环境、配置或存储状态问题用 doctor；身份或运行模式问题用 config show；只有只读或范围极窄的检查才用 debug db query。
限制：禁止执行破坏性 SQL；在命令实现前不得假定 raw RPC 可用；不得泄露 JWT、私钥、安全会话材料或无关本地文件；不得用 debug 绕过领域级确认规则。回收路径是先用 debug db query 检查，把结论映射回运行时、身份或消息行为，再回到领域技能，尽量缩短停留在 debug 的时间。相关参考见 docs/architecture/awiki-skill-architecture.md 与 docs/plan/phase-0/implementation-constraints.md。