面向 OpenAI Codex 的本地工程工作流,把风险、根因、变更范围与实际验证组织成可检查的工程过程。
介绍
Rootloom 是一个面向 OpenAI Codex 的本地插件。它不替代编辑器、测试、持续集成或人工判断,而是让编码智能体先读取仓库事实与项目规则,判断风险和范围,在行为所有者边界处理问题,再以实际运行的检查和最终仓库状态支撑完成声明。4.1.0 将日常入口收束为 Change、Review、Project Guidance 与 Setup;更严格的 Governed、Evidence 与 External Action 由 Change 按风险显式加载。
技术栈
产品定位
编码智能体可以快速产生看似合理的补丁,但合理不等于正确、可审查或完整。Rootloom 关注执行与审查边界:为什么在这里改、范围是否一致、验证是否真的运行,以及完成后还有什么不确定。
四个公开工作流
Change 负责实现、修复、迁移和证据模式;Review 负责只读审查;Project Guidance 管理持久化仓库规则;Setup 管理可选全局配置。普通任务只加载必要路径,严格合同只在风险和任务要求发生变化时进入。
根因与范围
对于缺陷,工作流先建立“现象 → 触发状态 → 所有权边界 → 被破坏不变量 → 根因”的链路,再在真正拥有行为的位置做最小一致修改;对功能,则明确目标、责任边界和可验证行为。
证据诚实的验证
验证从主路径、所有权不变量和一个相邻路径派生。命令通过后仍复查最终 diff、工作区与最强反例;可选 Evidence 记录机器观察与人工语义判断的边界。
明确边界
Rootloom 不是编码智能体、规格框架、测试运行器、Lint、安全扫描器或 CI,也不让模型变得不会出错。它让工程过程更容易检查,并把剩余风险留在完成报告中。
要点
- 4.1.0 提供 Change、Review、Project Guidance 与 Setup 四个公开入口,日常变更保持轻量。
- Change 在 Direct、Scoped、Governed、Evidence 与 External Action 之间按风险路由,不要求用户理解内部流程。
- 缺陷处理先追踪现象、触发状态、所有权边界、被破坏不变量与根因,避免在下游掩盖问题。
- 验证区分建议命令、实际执行结果、最终仓库状态与语义判断;退出码为零不自动等同于完成。
- 可选 Evidence 会绑定变更前后状态、范围与测试日志,但明确不把证据包描述成正确性或安全性证明。
- 运行时保持本地和可检查,公开中英文文档、契约验证、发布记录与 CI 结果。
截图