SuperAPI AI 工具集

architect

编程与开发

查看项目

更新于 10-28 16:17

技能介绍

用途:architect 用于处理 Pstack 风格的接口或模块设计、调用方优先的草图,以及按照选定的形态推进实现。它先出设计再写代码,适合需要在动工前明确类型、函数签名、类形态和模块边界的场景。

主要能力:该技能通过 /domain-modeling 解析并读取调用项目已配置的工件。只读的调查与评审只报告文档漂移,不做修改;创建或实现则通过该所有者来协调已接受的模型变更。设计过程中会产出带 not implemented 主体与伪代码的类型、签名、类形态和模块边界草图,跨多个模型视角综合后再据此编写代码。它还要求至少两个结构上不同的候选方案,再对照设计红旗检查每一项候选。

使用方式:开始时先建一个待办清单,每个阶段一条。阶段 A(Ground)针对新代码涉及的每个系统建立真实心智模型,对相关子系统运行 /how,产出其规定的架构解释;若设计重新定义了归属或分层,还对现有形态运行 /why。阶段 B(Sketch)以 design-sketch 任务和阶段 A 的产物运行 /arena,把 references/runner-prompt.md 作为各 runner 的提示词,运行者经由 /swarm 的会话模型与对应方面板选定;对照 references/design-red-flags.md 筛查候选,并按 /codebase-design 的词汇比较接口深度,优先选择用更小更简单的公共接口隐藏更多复杂度的设计。阶段 C(Agree)默认直接进入实现,只有调用方明确要求检查点时才暂停等待签字。阶段 D(Implement)用代码替换 not implemented 主体、用逻辑替换伪代码,以综合草图为契约,偏差必须显式提出;有可行测试路径时用 /tdd 在公共接缝处写行为测试。阶段 E(Scrap)在实现持续出现草图无法吸收的摩擦时废弃草图,回到阶段 B 重跑 /arena。

适用场景:适合已有周边系统需要集成的新代码设计、需要先定接口再实现的模块工作、以及希望用多方案对比来穷举设计空间的团队。真正全新且无周边系统的绿地工作可跳过阶段 A。

限制:资料中未提供该技能的安装方式、运行环境要求、支持平台或收费信息,暂未提供。它依赖 /domain-modeling、/how、/why、/arena、/swarm、/tdd、/interrogate 等配套技能与 references 目录下的模板和清单文件,这些内容的具体细节资料中未给出。