SuperAPI AI 工具集

architect

编程与开发

查看项目

更新于 11-01 16:53

技能介绍

用途

architect 是一个在编码之前先做结构设计的技能:先勾画出类型、函数签名、类形态和模块边界(函数体写“not implemented”,逻辑用伪代码),再在实现阶段逐步填入真实代码。适用于用户输入 /architect、"architect this"、"design…" 等触发语时。

主要能力与工作流程

技能开始时会先建立任务列表,每个阶段一条记录(使用运行环境的 task 工具;没有时写到 ~/.local/state/pstack/checklists/<repo>-<branch>.md)。随后按五个阶段推进:

  1. Phase A:Ground(理解问题)——为所有新代码触及的系统建立真实心智模型,对相关子系统运行 how 技能;仅命名文件不算接地。若设计改变所有权或分层,还要对现有结构运行 why 技能,把理由变成约束。只有在完全全新、没有周边系统的场景才跳过此阶段。

  2. Phase B:Sketch(勾画)——用 design-sketch 任务和 Phase A 产物运行 arena 技能,把 references/runner-prompt.md 粘贴到各 runner 的任务说明中。runner 取自 ~/.config/pstack/pstack-models.md 中的 architect runners 行;缺失时使用 arena 技能 Phase A 的默认席位。要求“设计两次”:在合成前至少产出两个结构不同的候选方案,属于整体形态的替代,而非同一形态内的局部修补。每个候选先用 references/design-red-flags.md 筛查,优先选择能以更小更简单的公开接口隐藏更多复杂度的设计。arena 返回一个合成设计包,其决策填入理由文档的“Synthesis decision”部分。

  3. Phase C:Agree(可选)——默认直接进入实现,不设人工检查点;仅当调用方明确要求(如“/architect with checkpoint”“stop and show me before implementing”)时才展示合成设计并暂停等待确认。该阶段可在实现前运行 interrogate 技能对草图施加对抗性压力。

  4. Phase D:Implement(按草图实现)——用真实代码替换 not implemented 函数体、用逻辑替换伪代码。合成草图即契约,偏离之处应作为信号上报而非默默吸收;若实现需要草图未预料的参数,需判断是草图错了、需求遗漏还是实现越界。

  5. Phase E:Scrap(架构有误时丢弃)——若实现持续产生草图无法吸收的摩擦,就丢弃草图重新设计,不给错误设计打补丁。信号需成模式而非单例:同类 workaround 在不相关代码中反复出现、多个需特殊分支的边界情况、需要逃生舱(any、强制转换、实际总是设置的可选字段)才能编译、调用方需了解抽象内部规则才能使用等。丢弃后重跑 how 技能、按新约束重新设计、先做减法再回到 Phase B 重跑 arena。

使用方式与输出

通过技能触发语调用;技能文件体系假定用户手动读取对应 SKILL.md 并遵循。输出先写调用方的用法草图,再从中派生类型草图;小改动输出一个含新类型与签名的文件,较大工作输出模块映射加类型定义。设计理由文档按 references/rationale-template.md 的格式随附,包含用法草图与合成决策。

适用场景与限制

适合在实现前需要明确类型、接口和模块边界的开发任务,尤其是希望从多个模型视角比较候选设计、并让后续实现有明确契约约束的情况。限制与前提:多数 pstack 技能仅用户可加载,技能工具无法加载,需直接读取文件;依赖 arena、how、why 等配套技能以及 pstack 模型配置文件;schema、具体收费与平台支持等信息暂未提供。