discipline/07-iteration.md
07 · 迭代协议(学科构建的操作手册)
1. 轮次定义
一轮 = 一个主题(取自 05-agenda.md)+ 四项交付:
- 文献增量:更新
literature/,规范引用并标注证据等级。 - 框架变更:新定义/新方法/新决策,修改对应文档并 bump 版本。
- 实践产物:实验 / 案例 / 工具 / 基准,可复现。
- 轮次记录:
rounds/round-NN-*.md。
2. 轮次模板
模板独立存放:protocols/iteration-template.md (拆出原因:模板与协议本体变更频率不同,解耦后 07 保持稳定)。
3. 质量门(每轮完成标准)
- [ ] 选题来自 backlog,或显式新增并登记
- [ ] 引用进入
literature/index.md且标注证据等级 - [ ] 术语表随新增概念更新
- [ ] 文档版本号 bump,README 文档地图同步
- [ ] 轮次记录写完,未决问题明确
- [ ] 若含实验:可复现、评估协议合规(06-evidence.md)
- [ ] 运行 HTML 构建脚本(
scripts/build_discipline_docs.py),/discipline可访问
4. 可持续机制
- 版本号:vX.Y;每轮 bump 一位;changelog 记在
rounds/README.md。 - Backlog 维护:RQ 状态只在轮次记录里更新,不静默修改 05-agenda.md 的旧条目。
- 文献去重:新增文献先查
literature/index.md,避免重复条目;引用格式统一。 - 评审与可逆性:重大决策(新公理、新支柱、删除术语)在轮次记录写明理由, 允许下一轮推翻(decisions are reversible)。
- 定期回顾:每 4 轮做一次「学科回顾」轮,检查公理是否需要修订、方法地图是否偏科。
5. 节奏建议
- 每轮聚焦一个主题,宁浅勿散;单轮文档增量控制在可一次读完的范围。
- 理论轮与实践轮交替;理论变更需伴随至少一个实践锚点(案例/实验/数据)。
- 一轮未达标就停在当前轮继续打磨,不强行推进(与 AppTrends 迭代纪律一致)。
- HTML 化是可持续的一部分:Web 端
/discipline在源文档更新后自动重建; 构建脚本也可手动运行或--watch监听。 - 知识架构与模块化规则见 _architecture.md(新增内容去处、 上下文预算、拆分开机判据)。
6. 与 AppTrends 项目的关系
- AppTrends 的迭代(Iteration 0-5+)是 DSF 的应用层实例;DSF 框架改动若影响 ADDO,
需同步更新
docs/与knowledge/。 - 反向:ADDO 的经验(截断观测、专家打分偏差、约束一致率指标)是 DSF 的案例证据。