SuperAPI AI 工具集

architect

设计与创作

查看项目

更新于 10-15 19:56

技能介绍

用途:作为 SpecWeave 工作流中的系统架构师技能,负责技术设计(HOW),与负责产品需求(WHAT)的 PM 技能并行协作,产出架构决策记录(ADR)、系统设计文档、图表与 API 契约,并生成增量计划 plan.md。

主要能力:创建 ADR(文件名形如 XXXX-decision-title.md,四位数字、无 adr- 前缀,含 Context、Decision、Alternatives Considered、Consequences);输出到 .specweave/docs/internal/architecture/ 下的 system-design.md、adr/、diagrams/、api-contracts/;用 Mermaid C4 绘制图表;生成引用架构文档的 plan.md。

使用方式:开始前检查深度访谈模式是否开启:jq -r '.planning.deepInterview.enabled // false' .specweave/config.json,若为 true 则先就设计模式与权衡、集成点与外部依赖、可扩展性与性能、安全架构、技术选型理由提问。工作流为分析需求、列出所需 ADR、询问先做哪个,然后每次只写一个 ADR 并询问是否继续,再画图、生成 plan.md。完成后须按技术栈显式调用领域技能,如 Skill({ skill: "sw-frontend:frontend-architect", args: "Implement UI for increment XXXX" })、sw-backend:dotnet-backend、sw-backend:nodejs-backend、sw-payments:stripe-integration、sw-k8s:kubernetes-architect 等。可先查看项目记忆:cat .specweave/skill-memories/architect.md 2>/dev/null || echo "No project learnings yet"。

限制:每次响应只输出一个 ADR,且不超过 2000 token;分析、单个 ADR、图表、plan.md 各有 token 预算。无服务器、合规、安全、前端、后端、基础设施等细分设计需委派给对应技能或代理。资料未提供具体收费、平台与效果信息。