用途
该技能用于通过对话式发现流程,为非功能性需求(Non-Functional Requirements,NFR)创建架构决策记录(Architectural Decision Records,ADR)。它基于 ISO/IEC 25010:2023 质量模型,引导利益相关者围绕质量属性展开结构化讨论,并将讨论结果整理为 ADR 文档。ADR 记录的是对话的成果,而非对话本身。
主要能力
- 挑战优先开场:以 ISO/IEC 25010:2023 质量特性作为切入点,包括功能适合性、性能效率、兼容性、可靠性、安全性、可维护性、灵活性、安全性。
- 理解挑战:挖掘驱动因素、约束条件与系统上下文。
- 质量专项深入:根据主要 NFR 类别进行定制化的深入探讨。
- 方案探索与权衡偏好:探索可选方案并记录权衡偏好。
- 决策综合与验证:在创建 ADR 前对决策进行综合与验证。
- ADR 文档生成:生成包含质量指标与成功标准的 ADR 文档。
使用方式
该技能为交互式 SKILL,扮演架构顾问角色,风格为挑战优先、咨询式、自适应。工作流程如下:
- 获取当前日期:在发现流程开始前运行 date,用于 ADR 时间戳。
- 读取参考并开场:读取 references/032-architecture-adr-non-functional-requirements.md,并以挑战优先的 ISO 25010:2023 质量特性框架开场。
- 执行咨询式 NFR 发现:一次询问一两个问题,围绕主要 NFR 类别捕获驱动因素、约束、质量优先级、选项与权衡偏好。
- 生成 ADR:仅在用户明确确认继续后,创建包含可度量质量指标与成功标准的 ADR。
约束条件
- 使用挑战优先、咨询式的发现方式:一次询问一两个问题,基于回答逐步深入,并根据 NFR 类别进行定制。
- 仅在充分对话并获得用户确认后才创建 ADR。
- 必须:在开始前运行 date 以获取 ADR 的准确时间戳。
- 必须:重新读取参考模板,不要使用缓存的问题。
- 必须:以挑战优先开场(ISO 25010:2023 质量特性)。
- 必须:一次询问一两个问题,绝不一次性全部提出。
- 必须:在提议创建 ADR 前,与用户验证总结(“这是否准确反映了您的质量需求?”)。
- 必须:等待用户确认继续后再生成 ADR。
- 步骤约束:绝不一次性提出所有发现性问题;在提议生成 ADR 前与用户验证总结;仅在明确确认后生成 ADR。
适用场景
- 为非功能性需求创建 ADR
- 记录非功能性需求
- 捕获非功能性需求
- 在 ADR 中生成非功能性需求
限制
关于详细指导、示例与约束,请参阅 references/032-architecture-adr-non-functional-requirements.md。该技能的具体实现细节、支持的平台、收费情况、价格等信息暂未提供。