用途 architect 用于在编写实际代码之前先做架构草图:类型、函数签名、类形态、模块边界,以及带有 not implemented 占位体和伪代码的骨架。它强调先在多个模型视角下形成候选设计,再从中综合出一个设计包,随后实现阶段按该草图填充代码。适合需要提前固定接口与分层、降低后续返工的场景。
主要能力
- 分阶段流程:开始前先建立待办清单,每个阶段一条。流程包括 Ground(理解问题)、Sketch(草图)、Agree(可选确认)、Implement(实现)、Scrap(推翻重来)。
- Ground 阶段:通过 how 技能对相关子系统建立真实心智模型,产出架构解释;若设计涉及所有权或分层变化,还会用 why 技能把现有结构的原因变成约束。仅当是完全绿地、没有周边系统可整合时才跳过。
- Sketch 阶段:用 arena 技能执行 design-sketch 任务,并传入 Ground 阶段产物;每个 runner 使用 references/runner-prompt.md 作为提示词。runner 取自 pstack 设置文件中的 architect runners 行(Cursor 为 ~/.cursor/rules/pstack-models.mdc,其他环境为 ~/.agents/pstack-models.md);若文件或该行缺失,使用 claude-opus-5-5-xhigh 与 grok-4.7-xhigh-fast。要求至少两个结构上不同的候选设计,按 references/design-red-flags.md 筛查,比较接口深度,偏好用更小更简单的公共表面隐藏更多复杂度的设计。arena 最终返回一个综合设计包。
- Agree 阶段(可选):默认直接进入实现,不设人工检查点;仅当调用者明确要求时才暂停展示综合设计并等待确认。
- Implement 阶段:以综合草图为契约,把占位体替换为代码、伪代码替换为逻辑;偏离草图时应显式提出,而非默默消化。
- Scrap 阶段:当实现持续产生草图无法吸收的摩擦时,丢弃草图,重新运行 how 技能、按第一性原理重设计、先减后加,再回到 Sketch 阶段重跑 arena。文中给出的信号包括:同类绕行反复出现、多个无关边界情况都需特判、类型需要 any/强转/总是被赋值的可选字段才能编译、草图说不共享状态却产生加锁反射、调用方必须了解抽象内部规则、以及同一形态的独立偏离出现两次以上。
使用方式 通过 /architect、"architect this"、"design…" 等触发;若要人工确认,可用 "/architect with checkpoint" 或 "stop and show me before implementing" 等显式表达。可在实现前用 interrogate 技能对综合草图做对抗性施压。综合结果可作为独立提交落地,对应 "scaffold first" 模式。
适用场景 适合在修改或新增代码前需要明确接口、模块边界与分层的中小型改动或较大工程;也适合在实现过程中发现架构不匹配时进行系统性重设计。
限制 资料未提供具体平台支持范围、性能数据、收费或价格信息;可用的模型与设置文件路径取决于运行环境,缺失时使用文档给出的默认模型。实际效果依赖所接入的 runner 与项目上下文。