业务调整(需求 / 行为变更)
归属:
docs/guides/sops/触发:既有已交付功能的行为、字段、交互、规则调整 关联概念:Flow Record、Planning Baseline、flow-requirements、flow-review
场景定义
对已存在(可能已发布)功能的增量调整:改字段、改交互、改业务规则、改默认值等。它既不是全新功能(需新 Flow),也可能不是缺陷(不是 01-bug-fix),而是对既有行为的有意变更。
目标与不做什么
- 目标:清晰界定变更边界、评估影响、保证向后兼容(或显式迁移),并更新验收标准。
- 不做:把「调整」塞进已完成的 Flow 里静默改验收;不评估影响就动手。
标准方法论(行业通行)
借鉴变更管理(Change Management)与敏捷范围管理的通行做法:
- 变更请求:把调整书面化为一条变更请求,明确「改什么、为什么改、期望结果」。
- 影响分析:列出受影响模块、调用方、数据结构、文档、测试与潜在破坏点。
- 评审与批准:按影响范围决定是否需评审/批准(高风险:兼容性破坏、公共接口变更)。
- 兼容与迁移:区分「新增能力(向后兼容)」与「破坏性变更(需迁移/版本化)」;对破坏性变更给出迁移路径。
- 需求可追溯:变更后的验收标准清晰可核验,并关联到对应 Flow Record / Task Record。
本项目落地流程
- 分诊变更类型:
- 新增能力 / 独立扩展 → 开新 Flow(走主流程)。
- 既有功能微调 / 原意澄清 → 复用或重开原 Flow Record,更新验收标准。
- 对已发布版本的破坏性变更 → 显式评估迁移,必要时补 ADR。
- 影响分析:列出受影响模块、调用方、接口、文档、测试;评估是否破坏向后兼容。
- 澄清变更(复用
flow-requirements的渐进式澄清):一次确认一个关键决策(改什么、谁判断做对了、是否破坏兼容)。 - 更新验收标准:在 Flow Record / Task Record 中更新
Acceptance Criteria,作为后续 review 的规格轴依据。 - 设计/实现:若涉及技术方案变化,按
flow-design产出设计基线并合入;否则直接按flow-code实现。 - 审查与合并:复用
flow-review双轴审查——规格轴对照更新后的验收标准,确认变更忠实实现。 - 文档同步:涉及 guides/api/db 变更随 PR 更新;新领域术语写回
CONTEXT.md。
验证与门禁
- [ ] 变更边界与期望结果书面明确
- [ ] 影响分析完成(模块、调用方、兼容性)
- [ ] 验收标准已更新且可核验
- [ ] 向后兼容性或迁移方案已验证
- [ ] 全量回归通过 + CI 绿 + 双轴审查通过
产出物
- 变更请求 / 影响分析(可并入 Flow Record body)
- 更新后的验收标准
- 合并的变更 PR(含必要的 docs 同步)
复用与新增资产
- 复用:
flow-requirements(澄清)、flow-design(如需设计基线)、flow-code、flow-review、goal 工具。 - 新增(缺口):变更分诊与影响分析的轻量入口;「复用 vs 新建 Flow」的决策规则。
反模式 / 注意事项
- 静默修改已合并功能的验收而不留痕。
- 破坏性变更不做迁移与兼容评估。
- 不区分「新增能力」与「既有调整」,一律开新 Flow 或一律复用。
- 变更后不更新文档与验收标准,导致 review 无规格可依。