SuperAPI AI 工具集

w-architecture

编程与开发

查看项目

更新于 10-15 15:38

技能介绍

用途

w-architecture 用于为用户的问题产出一份实现结构计划(implementation-structure plan)。它的定位是规划层面的辅助,而非替代架构决策记录。技能明确要求:持久的系统分解决策应归属于已有的 ADR 和架构 MDX 文档,不应另建第二套 ADR 树,也不应创建分支。

主要能力

  • 针对用户问题生成实现结构方案。
  • 读取匹配的架构 MDX 与 ADR,作为规划依据。
  • 判断变更是否属于持久边界:若是,则停止并记录到现有 ADR/文档体系。
  • 区分实现目标与锦上添花项(goals vs nice-to-haves)。
  • 列出影响本次变更的约束、权衡与替代方案。
  • 标记高风险项,交由人工处理。
  • 给出 3–5 条假设。
  • 仅在结构或流程不清晰时添加 Mermaid 图。

使用方式

若本轮对该领域尚无已协调的探索(reconciled exploration),需先执行 council 步骤 1–3,然后继续。技能会读取匹配的架构 MDX 和 ADR。若变更属于持久边界,则停止并记录到现有 ADR/文档系统。规划时保持在现有架构范围内,除非用户已授权做出持久架构决策。

输出保存规则:仅当用户提供了路径时才保存;否则在对话中返回。返回内容需包含 Assumptions(假设)与 References(纯路径)。命令与生成源的所有者(owners)来自已检查的文档。

适用场景

适用于需要规划实现结构、评估变更约束与权衡、识别高风险项,并希望将持久决策归入既有 ADR/架构文档体系的开发场景。

限制

  • 不创建分支。
  • 不另建第二套 ADR 树。
  • 持久系统分解必须写入现有 ADR 与架构 MDX。
  • 未提供路径时不保存,仅在对话中返回。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。