# Vibe Coding Harness 设计规格 版本0.8原始规则基线,2026-10-23。本轮用户已授权 Agent/LLM/Harness/执行沙箱开发与单测;规则对应实现、拒绝条件及证据见 [runtime-design.md](docs/runtime-design.md)。本规格仍含尚未实现的企业能力,不能整体当作已验收证明。部署仍未开放。 ## 职责与权威来源 M07 Harness 接收 M05 Agent编排器的动作提案,在执行前核验平台策略、固定 Skill 版本、项目权限和预算,授权后经 M09 Tool网关与工具适配调用 M08 Runner。Runner 返回原始执行证据,Harness 负责判断阶段准出。M05 推进状态,不能绕过 Harness;模型不自行判定验收通过。 Skill 可以收窄批准的框架和动作范围,不能扩大服务端权限。Knowledge 中的规范、示例与业务材料保留来源,不能直接变成执行策略。需求与 Skill 不一致时进入需求/Skill 变更流程,不让模型悄悄改规则。 未选择Skill时走普通对话,不强制框架/工作流,但仍受身份、资料ACL、用量和审计规则约束;普通对话不获得工具执行、代码写入或沙箱权限。三个演示Skill共用本规格,领域差异在Skill包及保护用例中声明。 ## 规则清单 | 规则 | 责任模块 | 未来拒绝条件 | 证据与处置 | |---|---|---|---| | H00 阶段授权 | 项目治理与M07 | 当前阶段不是获准的实现/验证/部署阶段 | 阶段版本、确认记录;停止动作 | | H01 身份与项目范围 | M01、M07 | 用户无项目/配置项/目标基线权限 | 主体、项目、资产与决策ID;不泄露越权资源 | | H02 固定Skill契约 | M02、M07 | 无正式发布或本轮受限本地验证快照、版本/哈希不符、框架未批准 | Skill版本、模板/BOM摘要、契约检查结果;本地验证版本仅原用户和项目可用,不进入正式发布列表 | | H03 资料权限与来源 | M03、M04 | 检索越权、来源版本缺失、资料要求越权工具 | 检索ACL、引用定位、上下文快照;隔离不可信指令 | | H04 代码与依赖范围 | M07、M09 | 路径逃逸、改平台/保护用例/密钥文件、引入未批准依赖 | Patch清单、允许路径、依赖差异;拒绝写入 | | H05 工具与参数 | M07、M09 | 任意Shell、动态安装、模型自选工具二进制/网络目标 | tool_id、固定参数schema、幂等键、回执 | | H06 Token与动作预算 | M06、M07 | 预留失败、全局任务预算或调用次数不足 | 预留/结算账本、模型尝试和实际usage;保存成果停止 | | H07 隔离执行 | M08、M09 | 无批准镜像、隔离不可用、资源限制缺失 | 镜像digest、环境/命令、超时与资源回执;不回退宿主执行 | | H08 验收独立性 | M07、M08 | 只有模型自述、只编译未运行、用例由模型删改、关键用例失败 | 独立用例版本、退出码、报告与源码摘要;不得标成功 | | H09 有界修复 | M05、M07 | 修复超限、无新证据、试图改保护测试 | 每轮差异/失败证据;停止并转人工 | | H10 未知调用与取消 | M05、M06、M08 | 超时/重启后结果不明、取消后仍拟续跑或重放 | unknown/cancelled状态、预留保留、对账记录;不自动重复计费 | | H11 人工发布门禁 | M01、M07、M09 | 无人工批准、制品摘要不符、空间/回滚未就绪 | 审批对象、版本、制品digest、目标环境;部署保持锁定 | | H12 审计与保密 | M01、M06、M09 | 请求写入明文密钥、审计含敏感全文、跨项目污染 | 脱敏日志、关联ID、按项目访问控制与保留策略 | | H13 制品与供应链 | M07、M10 | 制品无摘要/出处、镜像未批准、依赖源或许可/漏洞门禁不满足 | 源码基线/Skill/BOM/镜像/模型/报告摘要链;拒绝交付 | | H14 配置与发布连接 | M07、M09、M11 | 连接未启用、资产/基线越权、伪造回调、未批准更新发布基线 | 配置库/制品/容器权限、签名回执、幂等键与版本;停止动作 | | H15 上下文与沙箱隔离 | M04、M08、M09、M11 | 跨项目输入污染、身份/卷/数据越界、资源/网络限制缺失、预览越期 | 项目/任务/版本/环境ID、沙箱策略与租约、拒绝和回收记录;不回退宿主 | | H16 可运行成果验收 | M07、M08、M10 | 无网站/API/健康证据、镜像或配置版本不符、运行环境未验收 | 镜像digest、配置/环境引用、页面/API/健康报告与人工确认;保持待验收 | v0.8补充:API入口先验身份,Agent的模型与工具动作均需Harness授权;Tool/LLM网关再次核对授权引用与目标范围。外网验证profile不能关闭隔离、预算、审计或门禁。平台DB操作由领域Repository与数据库适配执行,默认不向模型提供任意SQL工具。统一制品库按镜像/包/证据分区授权,生成代码不持有推送或发布凭据。 CR-04 本地画像:H00/H02 由 `stage_local_validation`、项目 ACL 与委托范围检查执行;H07/H15 允许显式批准的无网络、无宿主挂载 QEMU 软件 VM,运行前复验镜像及控制器摘要;H08/H16 以真实 Java HTTP 独立测试及健康预览归档技术证据。最终人工 acceptance 与部署门禁保持独立。实现、拒绝条件及验证入口见 [关键模块设计](docs/key-modules-live-validation.md)。 ## 第一轮 Java Skill 的候选工程画像 v0.8补充交付形态:最小HTML/JS网站与Java HTTP服务、固定镜像、部署清单及独立测试/预览运行证据。Web框架、企业BOM和数据库画像随Skill评审冻结,不把早期仅标准库的编译试验当作可运行Web成果。 候选为 `java-erp-v1`:以采购订单金额、审批与部门访问为验收切片,产出一个小型 Java 工程、设计说明与测试证据。建议使用 Java17、批准的 Maven 工具链、固定企业框架与 BOM;具体版本和依赖在总体/模块设计阶段冻结。本期不将过去的“仅标准库、单类、三个方法”试验直接认定为最终工程规范。 Skill 包拟包含 `manifest`、编程规范、工程模板、允许依赖引用、接口契约与候选用例生成要求。独立保护用例与执行策略由平台维护,不归模型可修改目录。首轮不开放ABAP生成、SAP生产系统写入、自由插件安装、自由工作流画布或多Agent并发写仓库。 后续允许写入的候选路径为项目 `src/main`、`src/test` 及批准的文档目录。构建描述仅允许受控依赖变更,平台策略、工具脚本、凭据、保护用例和部署目录默认不可写。最终白名单随模板评审,不在本轮自动创建或迁移目录。 ## 预算与恢复设计 建议单任务预算60000 Token、最多3次实际模型尝试,成功、失败、备用切换和修复共用总次数,最多2轮修复,但受3次总调用上限更早限制;若设计和编码各用1次,通常只剩1次修复。Token限额不是算力保证,仍需独立的队列、并发、时间和内存上限。服务端在请求前按保守边界原子预留,返回后按usage结算;未知结果保留待结算项,不能视作零消耗。 仅明确额度不足、限流或对应冷却可按批准清单切换模型。超时、未知网络结果、鉴权失败、5xx不自动切换重放。取消应传播至模型等待和执行器,取消后不能继续写工程或进入部署;未能确认终止时显示待核对。 ## 未来的质量门禁 `需求确认 → 设计评审 → 代码与依赖检查 → 真实构建/独立测试 → 预览运行与人工评审 → 内网发布批准`。每一项绑定同一需求基线、提交/源码摘要、Skill版本、知识来源、上下文快照、模型调用、工具镜像和测试报告。代码/需求变化后,使受影响的既有结论失效。 构建和测试只能通过注册的固定工具契约执行;例如离线Maven验证由Runner的固定脚本负责,模型只提交动作类型和被批准的项目引用,不提交原始Shell。网络仅允许通过独立适配层访问批准的依赖库或SAP测试端点。 ## 最终内网发布的前置条件 预览实例按项目、任务、版本和环境分沙箱,具备租约、访问授权、取消和资源回收。预览与正式环境的身份、可写卷和业务数据分离;正式发布引用批准镜像digest和运行配置版本,并完成目标环境的启动、页面/API及回滚验收。 用户提供并指定内网目标环境,明确配置库、制品库、容器资源、操作系统/CPU架构、访问认证、运行配置、模型通路与责任边界;前序设计和验收完成;用户批准明确的制品、环境和回滚方案。当前均不触发采购、建资源或部署。