Files
mini-openclaw/docs/v2/09-decisions.md
2026-09-29 12:09:18 +08:00

7.0 KiB
Raw Permalink Blame History

决策、未决项与学习记录

日期:2026-09-29(0.2增量,原记录保留)。状态区分“用户已明确的方向”和“工程候选待评审”。

1. ADR

ID 决策 / 状态 被否方案 / 理由 影响
ADR-01 复用 Next.js+FastAPI 与现有组件,工程候选 全面换框架;无法复用已验证链路 先迁移可运行基座,再逐步拆模块
ADR-02 主审综合意见、专项模型局部判断(Jev或本地),用户已明确 Jev单题直接决定通过;缺乏整体研判 证据与硬规则约束最终有效输出
ADR-03 历史评审过程是核心资产,用户已明确 只存通过/不通过标签;丢失核查和判断变化 优先收集问询、补件、修改和批复条件
ADR-04 经验经审核、有适用范围,用户确认方向,工程细节待审阅 自动把任意反馈变成规则;会固化错误 复用现有经验治理,建立历史过程关联
ADR-05 无真实校准前不宣称审批概率,已讨论方向 分数/Noul直接转通过率;没有业务验证 P0概率字段为空;先做可追溯预审和试点
ADR-06 独立v2代码目录待迁移,当前先备份与文档,用户最新顺序 直接覆盖现有部署;难回退 旧版Gitea恢复点先核验;v2目录尚未建立
ADR-07 按用户最新要求直接适配流程正文,原文保留在Gitea恢复点 照搬Electron路径/发布命令;无法执行 AGENTS统一入口,正文按兴邦事实执行
ADR-08 专项判断支持 Jev 官方服务、本地开源模型和关闭;可切换方向用户已明确,契约细节为工程候选 把 Jev Key 作为产品依赖或用通用模型自评分伪装等效概率;供应依赖和指标口径不可控 统一业务题库/接口,独立适配/验收;本地路径先交付,Jev 接入不阻塞
ADR-09 公司评审会通过、初始材料介入、P0纯模拟,用户已确认 用违约率代替会议通过、只生成通过案例;偏离目标且没有反例 标签映射单列;未送审不当否决
ADR-10 三模块闭环与人工Skills/Rules入口,用户已确认 自动把反馈写入正式规则;不可控且丢失来源 来源/数据域/状态分离,统一审核和版本
ADR-11 数据/Skills/Rules装配方案,Tools受后台治理,用户确认方向 增加业务Tools卡、六维硬编码;权限负担且无法适配方案 维度随方案生成,工具只读追溯
ADR-12 按任务可替换专项服务,本地Laya为待测候选,用户接受建议 绑定Jev Key或称本地接口兼容即效果等价 独立环境、固定权重、各任务准入;缺Key不阻塞
ADR-13 轨迹+真实会议结果→改进候选→对照/审核→发布,用户确认方向 模型自评分自动训练/上线;循环强化错误 专家参考独立,划分先于经验提炼
ADR-14 编码模型与产品主审/专项模型独立;小任务交接,用户要求 一次让低成本模型重写全系统、双份开发规则 CLAUDE导入AGENTS,T00–T13逐批验收;本机连接未配置

2. Open Questions

needed-by 是明确阶段门,不虚构双方尚未约定的日历时间。

ID 待定内容 当前处理 owner needed-by
OQ-01 首批业务类型、关键核查项、正式硬规则 只使用标注演示规则;不宣称兴邦制度 项目负责人+兴邦评审专家 M2真实经验建模前
OQ-02 经验发布资格、独立复核、真实身份体系 演示角色明确标示;生产数据入口不开启 兴邦业务负责人+系统管理员 M2生产权限实现前
OQ-03 专项/主审模型端点、本地模型与硬件、客户数据出口、保留策略 mock/合成样本;先验证本地路径,缺 Jev Key 不阻塞;不发送真实材料 兴邦数据负责人+技术负责人 任何真实材料模型调用前
OQ-04 验收阈值、时延预算、资源/费用上限 文档工程限制仅提案,报告耗时不承诺效果 产品+测试+实施负责人 M3配置定案及M5盲测前
OQ-05 已确认“公司评审会通过”和初期材料预审;尚需会议代码、附条件结果、观察窗口、样本量及选择偏差映射 方向已关闭;真实标签映射仍open,probability=null 兴邦审批负责人+建模负责人 M6概率需求进入架构前
OQ-06 v2新仓库、云端目录、端口、容器/卷 暂用当前独立文档分支;不复用旧生产资源 项目负责人+运维 M1迁移及任何v2部署前

以上待定不阻止当前文档交付;阻止相应业务实现/真实数据阶段越过门禁。用户新指令可直接关闭或调整范围,不重复请求已授权事项。

3. 当前阶段门检查

门 状态 / 证据缺口
Term 0.2已列闭环术语,用户确认产品方向,客户口径待审阅
Contract 已有候选字段/状态/错误;新增读接口完整清单、DDL、类型生成未定案,见03第9节
Rule BR-01–44已拆分并标职责,待评审
Exception E-01–26有错误和文案,契约校验仍待实现
Coverage 文档AC覆盖机械检查本轮执行;新功能行为测试未实现
Decision OQ项按里程碑阻断,未宣告需求阶段全过

4. 学习与持久缺口

  • 流程适配:来源文档含项目特例,最小owner是 XINGBANG-ADAPTATION.md 和根AGENTS入口;以后每次新增规范检查失效路径。当前完成文件与链接核验,不等同长期遵守效果。
  • 经验数据:默认团队模式和简化案例检索容易被误认为真实学习;owner为架构/产品说明,后续演示必须标来源。
  • Gitea CI:仅有GitHub YAML,runner与门禁未核验;owner运维,在首次v2合并前确认。
  • 历史文档密钥:旧DELIVERY.md有遗留凭据,当前恢复快照不改历史;新仓库迁移禁止携带;凭据有效性与轮换由凭据owner另行处理,本轮未访问验证。
  • 本地工具:沙箱进程初始化失败,已通过受审的升权命令完成工作;不将该环境问题误判为代码故障。

5. 0.2已确认与仍待定案

用户已明确业务目标,无须再次确认“三模块是否正确”“是否可以不用Jev”。本轮文档交付走纯文档路径;工程门禁不因为用户认可方向自动通过。

T00需收口:独立代码路径和资源、首个切片字段/全部读写接口/DDL/状态/测试,实际评审记录;T08需验证:本地硬件、checkpoint、中文任务阈值;T09需定案:路由/token/文案文件与可访问性。真实身份/制度/会议标签/出口由兴邦在P1前确认。未决项不阻塞写文档或模拟数据设计,但阻塞对应实现/真实用途。

学习缺口:跨编码代理容易失去上下文,最小owner是15-development-handoff及根CLAUDE导入入口;本次只验证文档结构,尚无Claude/DeepSeek实际接手效果,不能声称已节省成本。后续按任务耗时/返工/费用和验收记录评估。