同一个能力既要给人类 CLI 用，又要给 coding agent 用，怎样避免 skill contract 和命令表面逐渐漂移？

最常见的 drift 根因是“同一个能力被两套入口各自演化”，但没有一个共享的语义真值层。

如果只是让 agent 自己去猜 CLI 参数，短期能跑，长期几乎一定会漂：命令参数变了，帮助文案变了，默认值变了，agent 的调用方式却没同步更新。

更稳的办法通常是：先定义能力合同，再让 CLI 和 skill 都从这个合同映射出来。

也就是说，CLI 是人类入口，skill 是 agent 入口，但底层能力语义最好共用一份真值。这样 agent 不是在猜命令，而是在用一个正式定义好的能力接口。