用途
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。
- 未提供路径时不保存,仅在对话中返回。
- 关于收费、价格、平台支持等具体信息,资料中暂未提供。