RunLogosRunLogos

Phase 09 · 变更提案

项目上线后,每次功能变更或 Bug 修复都应从 Delta 提案开始。提案说明变更原因、影响范围和需要同步更新的规格产物。

为什么不能直接改代码

直接改代码会让规格漂移。过一段时间后,API 文档、测试用例和真实实现可能互相矛盾,规格链也就失去可追溯性。

变更提案强制执行:先规格,后代码。

创建提案

cd my-project && openlogos change <slug>

例如:

openlogos change add-oauth-login

该命令会创建 logos/changes/add-oauth-login/,并写入提案模板。

目标文档缺失时

delta 并不要求目标文档已经存在。openlogos merge 执行时按磁盘上的实际情况判定:目标文档存在就**修改(MODIFY)被触及的章节,不存在就新建(CREATE)**一份完整文档。

这意味着存量项目不需要先补齐全部规格:本次改动触达的场景、API、数据库或测试文档如果还没有,Agent 写 delta 时会读取现有代码逆向生成完整文档,随提案一起合并。详见 按需补齐缺失文档。

合并提案

当 delta 文件完成并经过确认后,运行:

openlogos merge <slug>

合并后,再按更新后的规格实现代码、运行测试,并在验收通过后归档。

回到概览

→ 规格链概览