用途：为任何 Odoo 改动（新增字段、重写方法、继承视图/xpath、OWL/JS 补丁、向导、cron、控制器、报表、安全、迁移、修 bug、重构）提供强制性的写码前门禁与完成定义。核心原则是“无引用，不写码”，先追踪符号再动手。
主要能力：内置只读辅助脚本 scripts/odoo_trace.py（Python 3.8+），可解析运行时与版本、定位 odoo_root/conf/addons 根；支持 model、field、method、depends、xmlid、unlisted 等追踪命令，输出绝对 file:line 与 VERDICT（退出码 0 找到、1 未找到、2 设置错误）。XML/JS/控制器/引用则用 grep 在相同根目录检索，资料给出视图、QWeb 模板、OWL 组件、路由、ACL、重命名影响等检索命令。
使用方式：先运行 odoo_trace env 确定运行时与版本，加载对应 odoo-<major> 参考包并阅读 api-highlights.md；随后按 Step 1 追踪调用链，Step 2 写 Context Brief（每行一个符号，来源须为 file:line、NOT FOUND、UNCERTAIN 或 AMBIGUOUS），Step 3 最小计划，Step 4 实现，Step 5 完成定义（用一次性数据库 scratch_<module> 跑测试，测试数须大于 0，无 ERROR/CRITICAL）。
适用场景：Odoo Python/XML/JS/数据改动；仅问符号定义时走 Brief 路径；仅改本模块标签、帮助文本、清单版本或测试时走快速路径；纯文档或 git 任务跳过。
限制：资料未提供完整安装命令与官方文档；辅助脚本需显式写出技能基目录，shell 变量不跨调用保留；grep 报错或退出 2 不算 NOT FOUND；深层或跨模块流程可交给 odoo-code-tracer 代理；schema 变更须配迁移脚本，sudo 须配安全行。