Skip to content

Latest commit

 

History

History
88 lines (60 loc) · 2 KB

File metadata and controls

88 lines (60 loc) · 2 KB

30 Delivery Workflow

1. 开发流程

每次开发默认遵循以下顺序:

  1. 先确认需求落在哪个边界上下文。
  2. 先看现有模型和端口能否复用。
  3. 先做最小闭环。
  4. 再补充验证。
  5. 最后更新 README 或规则文档。

2. Vibecoding 提交原则

每次改动必须满足

  • 改动范围明确
  • 命名可读
  • 目录正确
  • 没有重复实现
  • 至少有一种验证方式

每次改动后必须自检

  • 这次有没有把业务逻辑写错层
  • 这次有没有新建多余抽象
  • 这次有没有引入重复类型
  • 这次有没有留下无用代码
  • 这次有没有破坏 README 与实际结构一致性

3. 验证要求

默认至少执行下面之一:

  • bun test
  • bunx tsc --noEmit
  • bun run build

如果改动影响范围较大,应至少执行两项。

4. 文档更新规则

出现以下情况时,必须更新文档:

  • 新增目录层级
  • 新增边界上下文
  • 新增核心用例
  • 新增工具协议
  • 新增重要开发约束

文档不同步视为未完成。

5. 变更粒度规则

  • 一次提交优先只解决一个主题
  • 不把“重构 + 新功能 + 样式调整 + 杂项修复”混成一个改动
  • 大改动要先搭骨架,再补实现,再补验证

6. AI 协作规则

AI 参与开发时,必须遵守:

  • 先读现有结构,再下手改
  • 优先复用已有文件和模型
  • 不擅自重命名大范围目录
  • 不批量制造样板代码
  • 不把“推测的未来需求”一次性全部实现

7. 什么叫完成

一个任务只有同时满足以下条件才算完成:

  1. 代码已经落地,不是只写方案。
  2. 结构符合规则。
  3. 至少有基础验证。
  4. 必要文档已更新。
  5. 没有留下明显重复和脏代码。

8. 红线清单

以下行为在本项目中视为违规:

  • 跳过验证直接宣称完成
  • UI 和领域逻辑混写
  • 用临时脚本替代正式架构长期存在
  • 为了省事复制已有实现再改一点点
  • 明知不符合规则还继续叠加复杂度