SuperAPI AI 工具集

032-architecture-adr-non-functional-requirements

编程与开发

查看项目

更新于 10-16 06:55

技能介绍

用途

该技能用于通过对话式发现流程,为非功能性需求(Non-Functional Requirements,NFR)创建架构决策记录(Architectural Decision Records,ADR)。它基于 ISO/IEC 25010:2023 质量模型,引导利益相关者围绕质量属性展开结构化讨论,并将讨论结果整理为 ADR 文档。ADR 记录的是对话的成果,而非对话本身。

主要能力

  • 挑战优先开场:以 ISO/IEC 25010:2023 质量特性作为切入点,包括功能适合性、性能效率、兼容性、可靠性、安全性、可维护性、灵活性、安全性。
  • 理解挑战:挖掘驱动因素、约束条件与系统上下文。
  • 质量专项深入:根据主要 NFR 类别进行定制化的深入探讨。
  • 方案探索与权衡偏好:探索可选方案并记录权衡偏好。
  • 决策综合与验证:在创建 ADR 前对决策进行综合与验证。
  • ADR 文档生成:生成包含质量指标与成功标准的 ADR 文档。

使用方式

该技能为交互式 SKILL,扮演架构顾问角色,风格为挑战优先、咨询式、自适应。工作流程如下:

  1. 获取当前日期:在发现流程开始前运行 date,用于 ADR 时间戳。
  2. 读取参考并开场:读取 references/032-architecture-adr-non-functional-requirements.md,并以挑战优先的 ISO 25010:2023 质量特性框架开场。
  3. 执行咨询式 NFR 发现:一次询问一两个问题,围绕主要 NFR 类别捕获驱动因素、约束、质量优先级、选项与权衡偏好。
  4. 生成 ADR:仅在用户明确确认继续后,创建包含可度量质量指标与成功标准的 ADR。

约束条件

  • 使用挑战优先、咨询式的发现方式:一次询问一两个问题,基于回答逐步深入,并根据 NFR 类别进行定制。
  • 仅在充分对话并获得用户确认后才创建 ADR。
  • 必须:在开始前运行 date 以获取 ADR 的准确时间戳。
  • 必须:重新读取参考模板,不要使用缓存的问题。
  • 必须:以挑战优先开场(ISO 25010:2023 质量特性)。
  • 必须:一次询问一两个问题,绝不一次性全部提出。
  • 必须:在提议创建 ADR 前,与用户验证总结(“这是否准确反映了您的质量需求?”)。
  • 必须:等待用户确认继续后再生成 ADR。
  • 步骤约束:绝不一次性提出所有发现性问题;在提议生成 ADR 前与用户验证总结;仅在明确确认后生成 ADR。

适用场景

  • 为非功能性需求创建 ADR
  • 记录非功能性需求
  • 捕获非功能性需求
  • 在 ADR 中生成非功能性需求

限制

关于详细指导、示例与约束,请参阅 references/032-architecture-adr-non-functional-requirements.md。该技能的具体实现细节、支持的平台、收费情况、价格等信息暂未提供。