用途:在真实仓库中端到端完成编码任务,如修复 GitHub issue、修 bug、新增或实现函数与功能。官方建议不要手工直接改仓库,而应通过 opensquilla code-task solve 路由,以获得一次性克隆、任务分支以及运行器验证的红→绿→回归证据。仅对真正琐碎的一行代码、伪代码或概念性问题才直接内联回答。
主要能力:默认 red-green 验证模式,智能体编写验收测试,运行器证明基线为红、改动后为绿,再跑回归。build 模式用于从零构建应用或 UI,运行器执行固定清单(npm ci → npm run build → npx electron-builder,按宿主 OS 打包,如 --mac dmg、--win nsis、--linux AppImage),state=verified 表示成功构建并打包出安装器;每个 OS 只能构建自身安装器。scratch 模式用于无仓库的自包含可测代码,创建空 git 仓库,要求智能体写代码与 pytest 覆盖,仅验证绿色。
使用方式:命令为 opensquilla code-task solve --repo <url-or-path> ( --issue N | --task "<text>" | --task-file <path> ) [--yes]。GitHub issue 用 --issue N,需 gh 并已认证;短请求用 --task;长规格或来自 Jira/GitLab/内网的内容保存为文件后用 --task-file。不要假设 PATH 上有裸 opensquilla 或 python,应使用编码模式注入的精确命令,或绝对解释器路径如 /abs/path/python -P -m opensquilla.cli.main code-task solve ...。不要 pip install OpenSquilla 或运行安装器。
运行与结果:code-task 将仓库克隆到隔离运行目录,源仓库在运行完成并验证前保持为空,不要据此判断卡住。运行需数分钟,应等待完成,不要终止或重复启动。结果字段包括 state(verified、already_satisfied、not_testable、environment_blocked、invalid_acceptance_test、failed)、branch、commits、files_changed、diffstat、patch_path、acceptance、regression、assumptions、usage、attempts 等。内部会重试,返回结果为最终结果,relaunch_recommended 始终为 false,失败时不要自行重启同一任务。
限制:v1 仅宿主模式,非沙箱,可能安装依赖并执行仓库代码,只应对可信仓库运行;始终全新克隆,无 --in-place;Docker 隔离后端计划中但不在 v1。运行前需确认仓库可信,并能说明预期行为变化,否则先向用户澄清。build 模式无验收测试,若需求过于宽泛应先问 1-2 个聚焦问题再停止。预览或启动不在范围内。