/dr-design 命令 — 在写代码之前决定架构
/dr-design 如何为每个设计组件探索三个或更多选项、评估权衡、做出决定并记录理由——所有这些都在实现开始之前完成。
有些实现任务足够直接,仅凭一份计划就足以作为指导。另一些则涉及一些决策,其后果会波及多个文件、系统或未来的变更。对于后者,未经深思熟虑的探索就贸然选定一种方案,是架构债务最常见的来源。/dr-design 命令为这种探索创建了一个结构化的空间。
该命令适用于 Level 3 和 4 的任务——这些任务的复杂度需要的不只是一份计划,但设计阶段又与需求阶段相互独立。它在 /dr-plan 之后、/dr-do 之前运行,其输出是一份或多份创意文档,存储在 datarim/creative/ 中。
它做什么
第一步是将每个需要设计决策的组件归类为四种类型之一:UI/UX 设计、架构设计、数据模型设计或算法设计。类型决定了适用哪些活动——数据模型设计侧重于实体关系和查询优化,而架构设计则侧重于组件结构和系统集成。
对于每个组件,该命令执行一个创意阶段:精确定义问题、探索至少三个不同的选项、分析每个选项的权衡、做出决定并记录理由,然后为所选选项编写实现计划。在结构受益于可视化时,会包含使用 Mermaid 记法的图表。
对于 Level 3 和 4 的任务,在完成各个组件的分析之后会运行一次 consilium 环节。这会汇集一组相关的智能体视角——安全性、性能、可测试性、可维护性——并让它们进行结构化辩论。专家组会就一项建议达成一致,任何冲突都通过明确的优先级阶梯来解决。输出中包含一张失败模式表:如果所选方案失败会发生什么,以及该失败如何显现。
一个具体示例
一个为多租户计费系统设计数据模型的任务,会产出一份包含三种 schema 选项的创意文档:带租户列的共享表、每个租户单独的表,以及一种混合方案——共享查找表加上租户专属的交易表。权衡分析显示,混合方案在预期租户数量下表现最佳,但引入了迁移复杂性。conseil 专家组提出了一个安全方面的担忧:共享查找表中存在跨租户查询泄漏的风险。最终决定选择混合方案,并在共享表上明确设置行级安全策略,实现计划中包含迁移脚本,以及一项验证零跨租户数据泄漏的 V-AC(验证验收标准)。
它在流水线中的位置
此处创建的设计文档会在实现之后由 /dr-qa 第 2 层(设计一致性)读取。该层会检查此处记录的架构决策是否在代码中得到了实际遵循,并标记任何偏差以供评估。偏差并不自动意味着失败——有时实现会揭示一条更好的路径——但必须记录下来,以便该选择可被审计。
在进入 /dr-do 之前的过渡检查点要求:每个组件都有明确定义的问题、至少分析了三个选项、做出了明确的决定,并有一份实现计划。在复杂任务中跳过其中任何一项,正是那种会在六个月后表现为难以解释的 bug 的捷径。
在什么是 Datarim 中了解设计如何融入完整工作流,或继续阅读/dr-do 命令,它负责实现设计所决定的内容。