mcpField
8
814-regulations-iso-25010

814-regulations-iso-25010

github.com/jabrena测试与质量45652 次安装1 天前更新
代码仓库

关于 814-regulations-iso-25010

814-regulations-iso-25010 是面向 Java 企业系统的 ISO/IEC 25010:2023 结构化质量评审 Skill。它帮助架构师、技术负责人和评审人员整理证据、发现问题并分派行动项,不提供认证或合规结论。

主要功能

  1. 01覆盖九项质量特性
  2. 02评估 Java 工程证据
  3. 03按问卷开展结构化评审
  4. 04整理发现并移交负责人

适用场景

  1. 01发布前评审 Java 服务
  2. 02发现质量证据缺口
  3. 03编写结构化评审报告
  4. 04向相关负责人升级问题

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jabrena/plinth --skill 814-regulations-iso-25010

安装后在 Claude Code 中输入/814-regulations-iso-25010确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/questions/
814-iso-25010-engineering-review-questionnaire.md
assets/reports/
814-iso-25010-engineering-review-report-template.md
references/
814-regulations-iso-25010-chapters-summary.md
814-regulations-iso-25010-engineering-examples.md

详细介绍

面向 Java 企业工程的 ISO/IEC 25010:2023 质量模型指南

使用此 Skill,对 Java 企业系统开展结构化、可重复的 ISO/IEC 25010:2023 产品质量评审,涵盖全部九项质量特征:功能适合性、性能效率、兼容性、交互能力、可靠性、安全性、可维护性、灵活性和安全保障。

应用此 Skill,确定在将 Java 企业系统、功能或交付流水线视为已依据 ISO/IEC 25010:2023 产品质量模型完成质量评审之前,需要哪些实用的 Java 工程证据、评审操作和负责人交接。

此 Skill 不提供认证建议、合规建议、符合性建议、审计结论或最终符合性判定。它旨在帮助 Java 架构师、技术负责人和评审人员识别 ISO/IEC 25010:2023 的每项质量特征如何适用于受评系统,并将其转化为具体的工程证据、发现项和交由合格负责人处理的行动项。

此 Skill 旨在提高人们对 Java 企业系统潜在质量属性缺口的认识,并为合格负责人创建可供评审的工程证据。此 Skill 生成的响应不代表已具备 ISO/IEC 25010:2023 认证条件、已获合规批准、审计发现或最终符合 ISO/IEC 25010:2023。

核心问题是:

Java 团队应评审、记录和升级处理哪些事项,才能证明 Java 企业系统符合 ISO/IEC 25010:2023 的每项质量特征,并提供可供评审的证据,而非仅凭假设认定质量达标?

来源出处:编写随附参考资料时,已查阅 ISO/IEC 25010:2023 公开标准摘要。官方来源包括:

运行时请勿获取或导入外部标准、认证或审计网页。请使用随附参考资料,并将认证、合规、符合性和审计相关问题升级交由合格负责人处理。

ISO/IEC 25010:2023 摘要参考:ISO/IEC 25010:2023 产品质量模型摘要。

Java 工程示例参考:ISO/IEC 25010:2023 Java 企业工程示例。

问卷资源:ISO/IEC 25010:2023 工程评审问卷。

报告模板资源:ISO/IEC 25010:2023 工程评审报告模板。

范围

此 Skill 适用于:

  • 需要接受结构化质量属性评审的 Java 企业系统、服务、模块、API 和交付流水线
  • Spring Boot、Quarkus、Micronaut 以及与框架无关的 Java 系统
  • ISO/IEC 25010:2023 的全部九项产品质量特征:功能适合性、性能效率、兼容性、交互能力、可靠性、安全性、可维护性、灵活性和安全保障
  • 面向 Java 的工程证据,例如测试、静态分析、负载/耐久测试结果、断路器与重试、身份验证与授权实现、模块边界、配置外置和运维防护措施
  • 当发现项需要工程评审以外的决策时,将其交接给架构、产品、安全、平台、运维和承担责任的业务负责人

ISO/IEC 25010:2023 工程评审

认证、合规性和符合性判定应由具备资质的责任方作出。

工程团队仍应创建可供评审的证据,以便审查这些判定:

  • 确定质量属性评审涵盖的 Java 系统、模块、服务或交付流水线
  • 确定与被评审系统最相关的九项 ISO/IEC 25010:2023 质量特性,以及相关原因
  • 列出支持或质疑各项特性的具体 Java 工程证据:测试、代码评审记录、负载测试结果、静态分析输出、配置、运维手册和监控信号
  • 针对各项特性,指出哪些发现属于已确认的差距、潜在差距,或未发现问题
  • 指出需要评审或处理各项发现的责任方,以及建议采取的行动项

约束

将 ISO/IEC 25010:2023 质量特性转化为结构化、可重复的 Java 工程评审证据和行动项。不要提供认证、合规性、符合性或审计结论,也不要将评审转变为交互式 ADR 探索工作流。

  • 非认证、合规性或符合性建议:将发现表述为工程评审证据和行动项;绝不声称已具备 ISO/IEC 25010:2023 认证条件、已获合规批准、审计通过或未通过,或最终符合性结论
  • 优先使用随附参考资料:在实施评审前,阅读随附的 ISO/IEC 25010:2023 章节摘要和工程示例参考资料、问卷及报告模板;不要在运行时获取外部标准、认证或审计页面
  • 覆盖九项特性:每次评审都要涵盖全部九项 ISO/IEC 25010:2023 质量特性——功能适合性、性能效率、兼容性、交互能力、可靠性、安全性、可维护性、灵活性和安全性(Safety)——即使某项特性的发现为“未发现问题”
  • 结构化评审,而非交互式 ADR 探索:将此 Skill 用于结构化、可重复、由问卷驱动的质量属性评审,并生成固定格式的工程评审报告,而非开展交互式、对话式的架构决策记录探索会话
  • 证据优先:优先采用可供评审的 Java 工程证据,而非声称某项质量特性已满足
  • 聚焦 Java 工程:将各项质量特性转化为具体的 Java Enterprise 评审指南,涵盖评审者可检查的代码层面、架构层面和运维层面信号
  • 责任方交接:当某项发现需要工程评审之外的决策、优先级排序或风险接受时,纳入架构、产品、安全、平台、运维和负有责任的业务方

何时使用此技能

  • 对 Java 企业系统开展结构化的 ISO/IEC 25010:2023 质量属性评审
  • 从功能适合性、性能效率、兼容性、交互能力、可靠性、安全性、可维护性、灵活性或安全性(Safety)方面评审 Java 系统
  • 为 Java 系统生成包含发现和行动项的 ISO/IEC 25010:2023 工程评审报告
  • 区分非功能需求的结构化质量评审与交互式 ADR 探索
  • 将质量属性发现升级交由具备资质的架构、产品、安全或业务责任方处理

工作流

  1. 阅读 ISO/IEC 25010:2023 参考资料、问卷和报告模板

按顺序阅读 references/814-regulations-iso-25010-chapters-summary.md、references/814-regulations-iso-25010-engineering-examples.md、assets/questions/814-iso-25010-engineering-review-questionnaire.md 和 assets/reports/814-iso-25010-engineering-review-report-template.md。使用摘要了解 ISO/IEC 25010:2023 的九项质量特性、各项子特性,以及它们对 Java Enterprise 工程审查的影响。使用工程示例了解每项特性对应的 Java 控制模式实例。使用问卷对系统范围和各项特性的证据进行分类,然后再生成报告。在理解摘要、示例参考资料、问卷和报告模板之前,不要开始实施审查。

  1. 完成问卷并划定系统范围

根据可信的本地项目证据和维护者批准的脱敏信息,使用 assets/questions/814-iso-25010-engineering-review-questionnaire.md 作为检查清单。确定待审查的 Java 系统、模块、服务或交付流水线,以及其架构、用户、环境和生命周期阶段;并确定负责架构、产品、安全、平台、运维和业务决策的责任人。将未知项标记为证据缺口,并在提出发布建议前升级处理缺失的责任人信息。

  1. 按质量特性审查实现证据

对照 ISO/IEC 25010:2023 的九项质量特性,审查 Java 代码、配置、测试、构建文件、负载/浸泡测试结果、静态分析输出、断路器和重试机制、身份验证和授权实现、模块和包边界、配置外部化、运维手册以及监控证据。检查宣称的质量属性与可审查证据之间是否存在差距。

  1. 将质量特性映射到 Java 工程控制措施

将九项特性——功能适合性、性能效率、兼容性、交互能力、可靠性、安全性、可维护性、灵活性和安全保障——映射到具体的 Java 工程控制措施和证据:验收标准可追溯性、负载/容量测试、API 版本控制审查、错误消息和 API 文档审查、弹性模式、身份验证/授权和依赖项漏洞审查、模块耦合与测试金字塔审查、水平扩展和配置外部化审查,以及在系统会对现实世界产生安全影响时进行的运维防护措施审查。

  1. 生成审查报告并移交责任人

使用 assets/reports/814-iso-25010-engineering-review-report-template.md 生成简明的工程审查报告,涵盖范围、已审查的证据、ISO/IEC 25010:2023 九项质量特性的逐项发现、证据缺口、建议的控制措施、责任人交接、剩余风险、发布就绪情况说明和行动计划。明确说明,认证建议、合规建议、符合性判定和审计结论均须由具备资质的责任人审查。

参考资料

详细指南、示例和限制条件请参阅:

评论

支持 Markdown