Merged
feat(knowledge): 新增 MMAD 与矢量/掩码接口边界值输入验收 Runbook #181
feat(knowledge): 新增 MMAD 与矢量/掩码接口边界值输入验收 Runbook #181
Merged
bianqueAdd on 10 days ago
bianqueCollaborators
10 days ago

Pull Request 说明

变更说明

  • 关联 Issue:#70

  • 主要改动:

    • 新增 2 张 Runbook 卡(knowledge/ops/ascendc/runbooks/validations/):
      • mmad_boundary_value_input_acceptance.md:MMAD 与 MMAD_MX 的边界值输入验收。核心是两族在加法阶段规则相反(+inf+(−inf):Mmad→nan,MmadMx→−inf),期望值不能互套、也不能由 IEEE 754 反推;附用例构造与失败判定顺序。
      • vector_interface_boundary_value_acceptance.md:Memory/Reg 矢量 + 原子 + 掩码接口的边界口径与验收流程。含掩码三种模式的实际含义(连续 16/32/64 位 [0,128]/[0,64]/[0,32];逐比特 maskHigh/maskLow 范围;Counter 模式为元素个数)、尾块推荐使用 Counter 模式的适用条件(非所有接口的强制要求;手动管理须核对 isSetMask=false 并恢复 Normal 模式)、以及"已知值小数组 → 真实 shape"的验收顺序。
    • 同步各级 index.md(knowledge_ingest.py sync-indexes 生成)与当天 logs/2026-10-28.md 条目。
  • 未包含的范围:不修改 governance/、.agents/、evals/ 与镜像区 knowledge/ops/ascendc/{apis,guides}/;不改动既有卡片。

  • 补充说明:

    • 定位:镜像区已有上游"边界值汇总"数据表卡,但缺少"怎么构造边界用例、期望值怎么取、失败怎么判定"的流程卡;本 PR 的两张卡只写流程与判定,表格以相对链接指向镜像卡。
    • 内容边界(如实声明):6 份 appendix 来源中 subnormal/denormal 与"对齐"均无条款,因此两张卡不写这两类行为断言:前者的口径指向既有精度卡(runbooks/precision/reg_vector_hardware_vs_soft_simulation_precision),后者的地址对齐与 kDirectionAlign 取自接口卡 mmad.md / k_direction_alignment_constraint.md,并明确"本卡只判定边界值输入,不判定对齐违规"。
    • 平台范围取覆盖族的并集(950/a3/a2),正文用表格逐族限定;具体接口仅按对应族的来源声明验收,不将并集外推到每个接口。
    • 来源内部存在一处张力(MmadMx 表给 nan→nan,而同源说明要求避免 nan 输入),卡中已显式标注并取更严口径。

变更类型

验证

likedislike
Pull Request has been successfully merged by CANN-robot.
(Thank you for bianque's contribution.)
BbianqueCollaborators
10 days ago Created pull request, commit 556ebde2
BbianqueCollaborators
10 days ago Associated issue: [Knowledge-Request|知识需求]: Ascend C 指令理论性能折算与接口边界值验收(来源 asc-devkit appendix)
bianqueCollaborators
10 days ago Comments:

/compile

likedislike
BbianqueCollaborators
10 days ago Pre merge succeeded (commit_id: 5d53992ee0a9d82f17ae851a05d09b530ce0f865)
CANN-robotCANN-robotCollaborators
10 days ago Added label: cann-cla/yes
CANN-robot
CANN-robotCollaborators
10 days ago Comments:

Thanks for your pull-request.
The full list of commands accepted by me can be found at here.
You can get sig-info at here.
You can self-configure the PR merge rules for this repository. For more details, please refer to Here.
For more, you also can visit HICANN.


PR Approval Progress

✅ Congratulations! All modules have met the lgtm and approve requirements.

Module Approval Details

module lgtm status approve status
repo-cann/cannbot-knowledge ✅ wangsj0012, qq_41667743 (2/2) ✅ wangsj0012 (1/1)

💡 Tip:

  • Committer can comment /approve or /lgtm
  • Commenting /approve implies both code review (lgtm) and intent to merge (approve)

CLA Signature Pass

bianque, thanks for your pull request. All authors of the commits have signed the CLA. 👍

likedislike
CANN-robotCANN-robotCollaborators
10 days ago Set qq_41667743,wangsj0012,jon_jin,zhanghz1,fafahan,zhengshencn_hwca,linghuis,OpSphere,xfwang_ecnu as approver
CANN-robotCANN-robotCollaborators
10 days ago Set qq_41667743,wangsj0012,jon_jin,zhanghz1,fafahan,zhengshencn_hwca,linghuis,OpSphere,xfwang_ecnu as approver
CANN-robot
CANN-robotCollaborators
10 days ago Comments:
🚀 CI 流水线已启动
📋 执行详情: 点击查看流水线
likedislike
CANN-robotCANN-robotCollaborators
10 days ago Added label: ci-pipeline-running
6 event messages are collapsed here。 See more
CANN-robotCANN-robotCollaborators
9 days ago Removed label: ci-pipeline-passed
bianqueCollaborators
9 days ago Comments:

/compile

likedislike
BbianqueCollaborators
9 days ago Pre merge succeeded (commit_id: 7ea89374c4d8260ce40e5cc414064343579768e7)
CANN-robot
CANN-robotCollaborators
9 days ago Comments:

Notification

This pull request has been changed(code update) or closed, so removes the following label(s): ci-pipeline-passed.

likedislike
CANN-robotCANN-robotCollaborators
9 days ago Added label: cann-cla/yes
CANN-robot
CANN-robotCollaborators
9 days ago Comments:
🚀 CI 流水线已启动
📋 执行详情: 点击查看流水线
likedislike
CANN-robotCANN-robotCollaborators
9 days ago Added label: ci-pipeline-running
CANN-robotCANN-robotCollaborators
9 days ago Removed label: ci-pipeline-running
CANN-robotCANN-robotCollaborators
9 days ago Added label: ci-pipeline-passed
汪超Collaborators
9 days ago Comments:

/lgtm

likedislike
wangshaojun
wangshaojunCollaborators
9 days ago Comments:

/approve

likedislike
CANN-robotCANN-robotCollaborators
9 days ago Added label: lgtmapproved
CANN-robotCANN-robotCollaborators
9 days ago Merged pull request