SuperAPI AI 工具集

architect-implement

通用与其它

查看项目

更新于 10-15 23:57

技能介绍

用途:当已有被接受的 ADR(Architecture Decision Records)且需要产出或更新统一架构文档 AD.md 时使用。核心思路是:ADR 记录“为什么做决策”,架构描述记录“决策后系统长什么样”。

主要能力:通过计划、执行、汇总三个阶段的多智能体 DAG 编排生成完整 AD.md。计划智能体分析 ADR、识别子系统、生成定制化 DAG 并请求用户批准;执行智能体按 DAG 逐子系统生成各架构视图,并传递依赖上下文;汇总智能体聚合所有视图、解决跨子系统冲突,生成统一 AD.md。视图与视角模板遵循 Rozanski & Woods 的 Viewpoints and Perspectives 框架,功能视图被视为“基石”,默认在功能视图后进行用户检查点。

使用方式:命令接收用户输入,例如“关注部署和运维视图”“生成全部视图并强调安全视角”“用近期新 ADR 更新已有 AD.md”;空输入表示从全部 ADR 生成完整架构描述。支持参数:--views(core 默认含上下文、功能、信息、开发、部署 5 个核心视图;all 含并发与运维共 7 个;也可逗号分隔自定义)、--sequential(默认,按序执行、质量优先)、--parallel、--no-checkpoint、--force。

适用场景:在 /architect-specify 或 /architect-clarify 之后生成 AD;在 /architect-init 之后记录既有系统(brownfield)架构;新增决策后重新生成 AD.md;集中完成架构文档冲刺。

限制:没有 ADR 时不适用,应先运行 /architect-specify 或 /architect-init;功能级 AD 由功能的 plan 阶段生成,不由本技能负责;小改动建议直接编辑。执行前有强制预检:需 state.json 中 clarify_completed 为真,且存在至少一个状态为 Accepted 的 ADR,否则会中止(仅 --force 可绕过,且可能产生不一致架构)。产物必须逐视图写入磁盘 {REPO_ROOT}/docs/adlc/architect/views/{subsystem}/{view}.md,每写一个视图后立刻更新状态。具体安装命令与收费信息资料未提供。