SuperAPI AI 工具集

architect

办公与效率

查看项目

更新于 10-16 06:21

技能介绍

用途:从逆向工程文档(RE docs)与用户约束出发,生成架构文档 architecture.md。前提是已完成 Gear 2(Reverse Engineer)且 docs/reverse-engineering/ 中存在 RE 文档,预计耗时 10-20 分钟,假定单会话执行,中断需从第 1 步重来。

主要能力:加载 9 份 RE 文档并分类缺失情况;就技术栈、部署目标、规模预期、硬约束、架构风格提问 3-5 个问题;基于当前架构生成目标架构,为重大决策生成 3-10 条 ADR,绘制 Mermaid 图(含 C4 系统上下文图),在棕地场景下依据 technical-debt-analysis.md 生成迁移路径章节,并做成本估算与技术栈理由说明。

使用方式:第 1 步并行读取 docs/reverse-engineering/ 下的文档,主架构来源 5 份(data-architecture.md、integration-points.md、operations-guide.md、decision-rationale.md、configuration-reference.md),支撑上下文 4 份。缺失主来源时须报告并询问是否以部分上下文继续;目录不存在或为空则停止并提示先运行 Gear 2。第 2 步以对话方式提问,能唯一确定时可跳过并请用户确认;用户给出矛盾约束时须指出冲突并请其解决。第 3 步按 operations/architecture-template.md 模板生成,逐节播报进度。第 4 步检测模式:项目根存在 _bmad-output/ 则为 BMAD 模式,写入 _bmad-output/planning-artifacts/architecture.md;否则为独立模式,写入 docs/architecture.md(不存在则创建 docs/)。写失败重试一次,仍失败则报告完整路径。

适用场景:为已有系统做架构逆向后的架构设计、现代化迁移规划,以及作为 BMAD Synthesize、Reimagine、Spec Kit 工作流的一部分。

限制与缺失:官方未提供价格、平台支持范围等事实;技能本身不包含安装命令与代码示例;棕地才含第 10 章迁移路径,绿地则省略。