SuperAPI AI 工具集

architect

编程与开发

查看项目

更新于 11-19 04:05

技能介绍

Architect 的核心主张是“先设计再实现”。它不直接写业务代码,而是先产出可讨论的结构草图:类型、函数签名、类的形状与模块边界,函数体留空并用伪代码示意,等草图定稿后再填充实现。整个过程被划分为五个阶段,并建议在开始前先建立一个待办清单,每个阶段对应一条。

【Phase A:Ground,建立真实模型】要求真正理解新代码所触及的每一个系统,对相关子系统运行 how 技能,产出被追踪过的模型,而不是仅仅点出文件名。如果设计会重新定义所有权或分层,还要对现有结构运行 why 技能,把既有理由变成约束而不是猜测。只有当工作确实是没有任何周边系统需要集成的全新绿地项目时,才可以跳过这一阶段。

【Phase B:Sketch,画草图】用 arena 技能执行 design-sketch 任务,并把 Phase A 的产出作为输入,references/runner-prompt.md 作为每个 runner 的提示词。每个候选方案产出一份设计包,结构遵循 references/rationale-template.md。runner 来自 pstack-models.mdc 规则中的 architect runners 行;若规则或该行缺失,回退到资料给出的默认模型列表。这里有一条强制原则:至少要有两个结构上不同的候选方案才能进入综合,即便第一个看起来已经够用,也要把设计空间穷尽,而且是整形状的替代,不是在同一个形状里做点状修补。每个候选方案在综合前都要对照 references/design-red-flags.md 筛查,并假设下一位贡献者是只看得到自己打开文件的智能体、会照抄最近的示例、走能编译的最短路径,因此优先选择“从单个文件看正确、对整个仓库也正确”的设计。可行候选之间按接口深度比较:更倾向把复杂性藏在更小更简单的公开表面之后的设计;丰富的接口可以通过集中能力而非把能力分散到各层来保持调用链简短。arena 最终返回一份综合后的设计包,综合决策写入 rationale 的对应小节。

【Phase C:Agree,可选确认】默认直接带着综合设计进入实现,不设人工检查点。只有当调用方明确要求时才暂停并展示设计等待签核,例如在调用时说明需要检查点或先展示再实现。无论是否设检查点,综合设计都可以作为独立提交先行落地,即“先搭脚手架”模式;在填充过程中出现计划内的、范围明确的破坏是可以接受的。若想在实现前对设计施加对抗性压力,可对综合草图运行 interrogate 技能。如果人对形状提出反对,无论发生在检查点还是事后,都应视为 Phase A 的证据,重新 grounding 并重跑 Phase B,然后再写更多代码。

【Phase D:Implement,按草图实现】把 not implemented 的函数体替换为代码,把伪代码替换为逻辑,综合草图的契约地位不可动摇。偏离草图是值得暴露的信号,而不是要默默吸收的摩擦:如果一个函数需要草图没有预见的参数,就要追问是草图错了、需求漏了,还是实现越界了。

【Phase E:Scrap,架构错了就丢掉】如果实现持续产生草图无法吸收的摩擦,就丢弃草图,不要往错误设计上焊补丁。判断信号是模式而非单例,资料列出的迹象包括:同一形状的绕行反复出现在不相关代码中;多个不相关边缘情况都需要专门分支;类型需要 any、强制转换、实际总被赋值的可选字段等逃生口才能编译;草图说状态不共享却出现“我们需要一把锁”的条件反射;调用方必须了解抽象的内部规则才能使用;实现中出现两个及以上同形状的独立偏离。判断要留有余地,少量边缘情况不足以否定架构,数据的复杂性不等于设计的复杂性。丢弃时先对已构建内容重跑 how,按新约束如同第一天假设那样重新设计,遵循先减后加原则让新草图比旧草图更小再生长,然后回到 Phase B 重跑 arena。

【输出】先写调用方的用法,再从用法推导类型草图。小改动产出一个含新类型与签名的文件;较大的工作产出模块地图加类型定义。rationale 随设计一起交付,包含用法草图与综合决策。资料未提供安装命令、支持的运行环境与平台、收费方式以及可量化的效果说明。