Agent Skill 核验档案

Opencode Qa

opencode-qa 是一个用于对 opencode 编码代理本身进行质量保证测试的 Skill，覆盖 CLI 命令验证、HTTP 服务器端点检查、插件钩子/动作/事件的 SSE 流验证、tmux 下的 TUI 冒烟测试，以及通过 id、标题/名称或消息文本在 SQLite 数据库中调查会话记录。该 Skill 为每个 QA 需求映射了经测试的辅助脚本（均自带 --self-test 回归断言）和分领域的深度参考文档。

适用任务

在隔离沙盒中运行 tui-smoke.sh 冒烟测试，验证 TUI 能在 tmux 下正常渲染并接受按键
使用 sse-hook-probe.sh 附加到真实服务器，在触发动作时监听并证明特定的插件钩子/事件已触发
通过 db-session-by-text.sh 配合 --session 或 --recent 参数限定范围，在多 GB 的 part 表中安全搜索消息文本
运行 opencode run 以非交互方式执行命令并输出 JSON 格式事件流以供断言
执行 export-roundtrip.sh 将完整的指定会话导出为干净的 JSON 文件

输入

opencode run 发出的 JSON 格式事件流
会话 id（如 ses_3a4ee6335ffedFB8f76BPU1Eb3）
会话的标题/名称文本
限制范围的搜索参数（如 --session、--recent N、--since <window>）
要监听的特定事件类型（如 message.part.updated）

输出

完整的会话导出 JSON 文件
包含真实色彩的 TUI 渲染截图（terminal.png）及终端文本文件
断言成功或失败的结果反馈
包含清理收据的 metadata.json 文件

限制与检查

对多 GB 的 part 表进行全局文本搜索非常耗时，脚本设计上刻意拒绝无范围的扫描
tmux 适合用于检查是否启动、渲染和按键等冒烟测试，但不适合用于断言对话输出
仅当设置了 OPENCODE_SERVER_PASSWORD 时，服务器才会强制身份验证，否则将处于无安全保护状态运行
仅当设置了 OPENCODE_SERVER_PASSWORD 时，服务器才会强制身份验证，否则将处于无安全保护状态运行
运行 bash scripts/lib/common.sh --self-check 验证依赖项是否存在、DB 路径能否解析以及沙盒能否自动移除
在 QA 前后比较 sqlite3 "$(opencode db path)" "SELECT count(*) FROM session"，确保真实数据库的会话数量未受污染
对每个脚本执行 --self-test（如 bash scripts/tui-smoke.sh --self-test）以验证其针对活动机器的场景断言
使用 opencode <cmd> --help 核对已安装版本的具体命令参数是否稳定

Opencode Qa

适用任务

输入

输出

限制与检查

AI 搜索

项目详情