已开启
[Requirement|需求建议]: 申请成为 cannbot-knowledge 仓库 Committer(AscendC 编程与知识评审方向) #69
bianque创建于  7 天前
bianque成员
7 天前 创建

Background(背景信息)

本人 GitCode 账号为 bianque,持续参与 CANN 社区 asc-devkit 仓库的开发与评审,贡献内容涉及 Ascend C API、硬件约束、接口边界行为、示例和开发文档。截至本次申请,个人在 asc-devkit 已有 9 个 PR 合入。[1]

除直接提交 PR 外,本人也持续参与其他贡献者的代码和文档评审:针对接口参数语义、文档与实现的一致性、头文件路径等提出具体修改意见,并参与示例修复的评审确认。希望将这些开发与评审经验用于 cannbot-knowledge 的知识建设和质量把关。

在 cannbot-knowledge 中,本人计划以 AscendC 编程领域的知识建设与评审为主要贡献方向,持续参与相关知识的开发、评审和维护。目前已完成 20 张知识卡的开发,分为 8 个 PR 提交,正在陆续评审合入;同时提交了 1 个增强查询 Skill 的 RFC PR,探索为知识检索补充版本、架构适用面及接口声明级证据。

申请信息

项目 内容
申请人 bianque
申请角色 cannbot-knowledge 仓库 Committer
贡献方向(责任田) AscendC 编程领域的知识建设、评审与维护
已有贡献 asc-devkit 已合入 PR 9 个,并持续参与代码和文档评审;cannbot-knowledge 已开发 20 张知识卡,分为 8 个 PR 提交并陆续合入中,另提交增强查询 Skill RFC PR 1 个
代表性贡献链接 见下方贡献概述及 asc-devkit 开发实例

cannbot-knowledge 已提交贡献

围绕 AscendC 编程领域,已开发 20 张知识卡,分为 8 个 PR 提交,正在陆续评审合入;另提交 1 个增强查询 Skill 的 RFC PR,合计 9 个 PR。

知识内容涵盖 Kernel 与 AI CPU 调试诊断、芯片与平台映射、编程模型与术语、Device C++ 标准及语法限制、废弃接口替换、架构迁移、硬件与软仿精度差异、Cube 存储通路、Reg 理论吞吐、数据类型支持和构建环境选择;同时探索为知识检索补充版本、架构适用面与接口声明级证据。

asc-devkit 代表性贡献(各附一句说明)

评审贡献

持续参与 asc-devkit 仓库的代码与文档评审,月均评审 PR 30+ 个,贡献内容涵盖 AscendC API 与 Tensor API、数据类型转换、编程示例、接口文档及知识检索工具;重点关注接口与参数语义、边界条件、文档与实现的一致性、示例正确性,以及版本和平台适用范围,协助完善相关代码与知识内容的质量。

直接贡献

  1. asc-devkit !3575:新增 Reg 矢量计算接口边界值汇总文档(已合入)——按基础算术、复合计算、比较与选择、类型转换、归约计算和索引操作六类整理边界值及特殊值输入下的计算结果,覆盖 INF/NAN 模式与饱和模式。[2]
  2. asc-devkit !6216:3510 硬件约束解决方案(已合入)——补充 NPU 架构版本 3510 的硬件约束与解决建议,涉及内存对齐、Cube/Vector、指令队列、流水同步等,并同步导航、术语和产品适用范围。[3]

Benefit / Necessity(价值/作用)

cannbot-knowledge 中的技术知识需要准确说明“接口如何使用、适用于哪些架构、有哪些约束,以及出现问题时如何排查”。已有的 API 边界行为整理、硬件约束文档建设和日常评审经验,可以用于相关知识的补充与核验,减少参数含义不清、适用范围遗漏、文档与实现不一致等问题。

申请成为 Committer 后,愿在上述责任田内持续承担:

  • 知识建设:围绕 AscendC 编程,持续补充编程模型、API 使用、性能优化、编译调试和工程实践等方面的知识,将实际开发经验整理为便于检索、引用和维护的知识卡。
  • 内容评审:核对知识来源、接口语义、架构及版本适用范围,检查示例与结论是否一致,对问题给出具体修改建议。
  • 存量维护:结合上游接口和文档变化,及时修正过时内容,补充必要的约束说明与关联链接。
  • 贡献协作:协助贡献者完善内容和验证依据,跟进评审问题关闭,并按社区规则承担责任田内的评审与合入职责。

Design(设计方案)

本 Issue 为角色任命申请,不涉及代码变更。请 SIG 例会提名并安排陈述。

Sources

[1] https://gitcode.com/cann/asc-devkit/pulls?categorysearch=%255B%257B"field":"author_id","value":%257B"id":6327611,"username":"bianque"%257D,"label":"bianque"%257D,%257B"field":"order_by_sort","value":"merged_at_desc","label":"最近合并"%257D%255D&order_by=merged_at&sort=desc&page=1&state=merged
[2] https://gitcode.com/cann/asc-devkit/merge_requests/3575
[3] https://gitcode.com/cann/asc-devkit/merge_requests/6216

likedislike
Bbianque成员
7 天前 修改了issue 的描述
Bbianque成员
7 天前 修改了issue 的描述
Bbianque成员
7 天前 修改了issue 的描述