OpenSpec 工作流

涉及新能力、破坏性变更、架构调整、安全或性能行为变化时，应先使用 OpenSpec 创建变更提案。

什么时候需要提案

• 新增功能。
• 修改 CRD/API 契约。
• 改变状态机或执行顺序。
• 引入架构级依赖。
• 改变安全、权限或认证行为。

基本流程

1. 查看现有变更和规范。
2. 创建唯一 change-id。
3. 编写 proposal.md、tasks.md，必要时编写 design.md。
4. 编写 delta spec。
5. 执行严格校验。
6. 获得批准后再实施。
7. 完成后归档变更。

文档同步

如果变更影响用户行为，应同步更新：

• CRD 字段说明。
• Server OpenAPI。
• 本文档站中的概念、教程、API 或参考文档。