opencli-adapter-author

你是要给一个站点写 adapter 的 agent。这份 skill 目标： 从零到通过 opencli browser verify 的 30 分钟内闭环 。 全程用现有工具： opencli browser * / opencli doctor / opencli browser init / opencli browser verify 。没有新命令。 调试浏览器型 adapter 时，优先直接带上 --live --focus 。这样命令跑完后 automation lease 还在，而且容器在前台，方便你核对最终页面状态，而不是猜是抓数错了还是页面走偏了。 先拿 coverage-matrix.md 快速自测。三个问题： 三个都 yes 继续。 不要猜。猜错了 verify 能通过但数据是错的，用户看到乱码才发现。 - 数据在浏览器里看得到吗？（否 → 先解决鉴权） - 数据是 HTTP/JSON/HTML 吗？（否 → 不在 skill 范围） - 需要实时推送吗？（是 → 找同数据 HTTP 接口；没有就放弃） - adapter 只引 @jackwener/opencli/registry + @jackwener/opencli/errors ，不用第三方 - columns 数组和 func 返回对象 keys 完全对齐（含顺序） - 已知失败抛 CliError('CODE', 'msg') 或 AuthRequiredError(domain) ，不要 silent return [] - 写私人 adapter 用 ~/.opencli/clis/ / .js （免 build）；要提 PR 才 copy 到 clis/ / .js - 站点记忆每轮回写：没记忆 → 用 skill → 产生记忆 → 下次变 5 分钟 - 调试过程中的原始 dump / 抓包 / HTML 样本只能落在 ~/.opencli/sites/ /fixtures/ 或 /tmp/ 。严禁在 repo 根目录、 clis/ / 或当前工作目录留 .dbg-*.html / raw-*.json / sample.* 这类临时文件 （PR diff 会带上去，别人 review 时很烦）。 - 诊断类： opencli doctor → 看 notes.md → 搜 autofix skill - 字段解码类： field-decode-playbook.md 全三节走完 → 先输出 raw 迭代 - endpoint 找不到：api-discovery §5 intercept 兜底