用途：帮助仓库使用者安全使用已发布的 finalrun CLI，面向含 .finalrun/ 的应用仓库，而非 monorepo 贡献者流程。
安装与诊断：npm install -g @finalrun/finalrun-agent 后用 finalrun --help 确认可用；本地 Android 或 iOS 执行前先用 finalrun doctor 做主机就绪诊断。命令帮助以本地 finalrun --help、finalrun test --help、finalrun suite --help 为准，不要臆造 finalrun init 等命令。
工作区：需在含 .finalrun/ 的仓库运行，其中 tests/ 必填，suites/ 仅套件流程需要，env/、config.yaml 可选。先查看 .finalrun/config.yaml、env/、tests/、suites/ 再提建议。
流程：先 finalrun check 校验选择器、套件、配置、环境绑定与应用覆盖；test 和 suite 均以校验为前置。说明将要执行的具体命令及 --env、--platform、--model。校验失败即阻塞，用通俗语言解释 CLI 错误，不得声称已执行。执行后可用 finalrun runs 查看产物；finalrun start-server 会启动后台与浏览器行为，需先征得同意。
安全策略：finalrun check、doctor、runs 可直接运行；finalrun test、suite、start-server 需先询问。test 可能耗时并消耗提供商额度。套件优先用 finalrun suite <path>，finalrun test --suite <path> 仍受支持。
常见参数：--env、--platform（android|ios）、--app（.apk 指 Android，.app 指 iOS）、--model、--api-key、--debug、--max-iterations、--suite、--port、--dev；显式参数覆盖 config.yaml。提供商为 openai、google、anthropic，分别使用 OPENAI_API_KEY、GOOGLE_API_KEY、ANTHROPIC_API_KEY；未配置默认模型时建议在 .finalrun/config.yaml 写 model: google/gemini-3-flash-preview，并在 ~/.zshrc 加 export GOOGLE_API_KEY=<your-key>，source ~/.zshrc 后重跑；一次性运行可用 --api-key。
密钥与环境：占位符须为 ${ENV_VAR} 形式；缺失或格式错误的 env 文件、未声明绑定、未导出的 shell 变量需用户自行修复，不得猜测或写入密钥值。
限制：YAML 测试、套件清单、env 绑定及测试流程规划属 generate-finalrun-test 职责；本技能可解释选择器解析与文件位置，但不重复 YAML 编写。具体模型版本请以 finalrun test --help 为准。