Architect 是一个在实现之前先做设计的技能。它的核心主张是:先勾勒类型、函数签名、类形状和模块边界,函数体用未实现占位或伪代码代替;综合多个模型视角形成设计方案,再对照选定的草图填充代码;如果实现证明草图是错的,就丢弃它并重新设计。
【用途】 用于需要先明确结构再写代码的任务,例如显式调用 /architect、用户说 “architect this”,或提出“设计……”的请求。它产出的不是成品代码,而是一份可作为契约的设计草图,以及配套的设计理由说明。
【主要能力与阶段】 技能开始前建议先建立一个以阶段为条目的待办清单。流程分为五个阶段:
阶段 A:打底(Ground)。为新代码将要触及的每一个系统建立真实的心智模型,对相关子系统运行 how 技能。仅仅说出文件名不算打底,需要产出 how 所要求的追踪模型。如果设计重新定义了归属或分层,还要对现有形态运行 why 技能,让背后的理由成为约束而不是猜测。只有真正全新的、没有周边系统需要集成的绿地工作时,才可跳过此阶段。
阶段 B:草图(Sketch)。用 design-sketch 任务和阶段 A 的打底产物运行 arena 技能,每个候选用一个运行器提示词,产出的设计包按照 rationale 模板成型。运行器取自当前 harness 的 pstack 模型表中 architect runners 一行,而非 arena runners 一行;若该表或该行缺失,使用默认条目。技能强调“设计两次”:在综合之前至少要得到两个结构上截然不同的候选,即便第一个看起来已经够用,这是穷尽设计空间原则的具体落地——要的是整体形状的替代方案,而不是同一形状内的局部修补。每个候选在综合前都要对照设计红旗清单筛查。比较时以接口深度为准,优先选择把更多复杂度藏在更小、更简单的公开表面之后的设计。arena 最终返回一份综合设计包,综合决策写入理由说明的相应章节。
阶段 C:确认(Agree,可选)。默认直接带着综合后的设计进入实现,没有人工检查点。只有当调用方明确要求时才设检查点,例如 “/architect with checkpoint”“实现前停下来给我看” 之类。此时展示综合设计并暂停等待签字确认。无论是否设检查点,综合结果都可以作为独立提交先行落地(“先搭脚手架”模式)。实现过程中有计划、有范围的破坏是可以接受的。如果要在实现前对设计施加对抗性压力,可对综合草图运行 interrogate 技能。如果人类对形状提出反对意见(检查点中或事后),应视为阶段 A 的证据,重新打底并重跑阶段 B 之后再写更多代码。
阶段 D:按草图实现(Implement)。把未实现占位替换成代码,把伪代码替换成逻辑,综合草图就是契约。偏离草图是有价值、值得暴露的信号,而不是该默默吸收的摩擦:如果某个函数需要草图没有预料到的参数,就要追问是草图错了、需求漏了,还是实现越界了。
阶段 E:架构错误时废弃(Scrap)。如果实现持续产生草图无法吸收的摩擦,就丢弃草图,不要往错误设计上钉补丁。信号是模式而非单例,技能给出的征兆包括:同一形状的变通在互不相关的代码中反复出现;多个互不相关的边界情况都需要专门分支;类型需要逃生舱(any、强制转换、实际总是被赋值的可选字段)才能编译;“草图说状态是共享的”之外突然出现“我们需要一把锁”的反射;调用方必须了解抽象的内部规则才能使用它;同一形状的独立阶段 D 偏差出现两次或以上。判断需要权衡:少量边界情况不足以否定一个架构,有些问题本身就是复杂的,数据上的复杂度不等于设计上的复杂度。废弃时应重新用 how 技能审视已构建内容,把新约束当作第一天的假设重新设计,先做减法再做加法(新草图在增长之前应比旧草图更小),然后回到阶段 B 重跑 arena。
【输出】 先写调用方的用法,再由用法推导出类型草图。小改动产出一个包含新类型与签名的文件;较大工作产出模块图加类型定义。设计理由说明与草图一并交付,按 rationale 模板成型,其中包含用法草图与综合决策。
【依赖与限制】 arena 使用 provider-dispatch.md 中的集中式提供方路由,配置项是描述符而非原生模型 slug;在 Codex 上,剩余的 Claude 工具名需通过 codex-tools.md 解析。技能引用 references/runner-prompt.md、references/rationale-template.md、references/design-red-flags.md 等参考文件,以及缺省运行器列表(资料中给出为 codex:gpt-5.6-sol@max、grok:grok-4.7@xhigh、claude:opus@max)。关于具体收费、价格、支持平台与效果的更多信息,资料暂未提供。