用途
Design Code Architecture 用于为一个新应用设计架构。它的核心原则是:架构就是那些难以逆转的决策集合——只对这些决策慎重处理,其余便宜、易改的部分尽量延后。该技能把架构设计组织成八个阶段,按从最难逆转(边界、领域)到可调(数据、弹性)再到横切纪律(复杂度、可逆性、范围)的顺序推进,并把每个决定记录到项目 docs/ 目录。
主要能力
这套流程提供交互式、可恢复的架构设计旅程:代理会在每个决策前提问,并将结果写入项目文档。它包含八阶段旅程地图:
- clean-architecture:回答源码依赖是否向内——核心是否能在无数据库、Web 或框架的情况下测试。产出 docs/ARCHITECTURE.md。
- domain-driven-design:回答业务实际在哪里拆分、每个术语含义是什么。扩展 docs/ARCHITECTURE.md。
- system-design:回答真实负载实际需要多小的系统。扩展 docs/ARCHITECTURE.md。
- ddia-systems:回答每个工作负载需要哪种数据模型、存储引擎和一致性。扩展 docs/ARCHITECTURE.md。
- software-design-philosophy:回答复杂度是否隐藏在深模块之后,还是出现 classitis。扩展 docs/TECH-DEBT.md。
- release-it:回答当依赖变慢或宕机时能否优雅降级。创建 docs/RELIABILITY.md。
- pragmatic-programmer:回答哪种薄切片能证明边界、哪些习惯保持可逆。扩展 docs/TESTING.md 与 docs/TECH-DEBT.md。
- 37signals-way:回答 v1 什么是必要的、要砍掉哪些投机性抽象。扩展 docs/ARCHITECTURE.md 与 docs/TECH-DEBT.md。
使用方式
运行规则如下:
- 恢复优先:先读取 docs/DESIGN-CODE-ARCHITECTURE-PLAN.md 及旅程地图中的每个产出物。如果存在跟踪文件,用 3-5 行总结旅程状态,并询问进入哪个阶段。有跟踪文件的旅程是恢复,而不是重新开始。
- 仅首次运行做信息收集:没有跟踪文件时,先运行 Intake,然后创建 docs/DESIGN-CODE-ARCHITECTURE-PLAN.md,为每个阶段标记状态。
- 阶段进入:说明该阶段做什么、强制做出什么决定、产出什么文件、大致工作量。提供继续 / 跳过 / 延后。标记为 GATE 的阶段可以延后,但绝不能跳过。
- 技能调用与回退:加载该阶段的技能并使用。每个阶段的 Invoke 行按 slug 命名技能。如果技能不可用,可提示安装:npx skills add wondelai/skills/<slug> --global。如果用户拒绝,则按该阶段的 Brief 运行最小可行方法,并说明当前模式。
- 阶段内决策:对“Decide with the user”下的每个问题提问,给出具体选项和建议。将选择记录到跟踪器的 Key Decisions。静默做出的决定视为缺陷。
- 阶段退出:在写入前先呈现产出草稿供确认。批准后写入或扩展 docs/ 文件,更新跟踪器。
- 产出物纪律:先读后写;文件缺失才创建,否则扩展——添加或更新自己的章节,保留他人的内容。docs/ 中的文件名为大写。每条建议都落为复选框或带负责人和优先级的表格行。
- 每个难以逆转的决策在代码采用之前都要有一行 Decision Log(决策、原因、被否决的替代方案)。默认采用模块化单体:只有经过验证的限界上下文才拆分为服务。
适用场景
适合从零开始设计应用架构,尤其是希望在少量难以逆转的决策上做对、其余部分保持简单的团队。周末项目可以轻量使用其中三个阶段;面向发布、有资金支持的团队可以用完整八阶段。若项目尚未验证用户需求,应先走 create-business / create-app,而不是为未验证的想法做架构。
限制
资料未提供关于具体收费、价格、平台支持范围、实际效果或完整使用步骤的进一步信息。该技能依赖配套的 constituent skills 作为方法承载;若这些技能不可用,只能按各阶段 Brief 运行最小可行方法。阶段跳过启发式提到:当年负载远低于任何阈值时跳过第 3 阶段的扩展机制和第 4 阶段的大部分复制;单团队应用可跳过 team-topologies 可选阶段;第 1 和第 2 阶段绝不能跳过;一旦有真实用户和外部调用,第 6 阶段弹性不可选。