CANN稀疏矩阵算子库README审查

README 审查清单与流程用于 readme-review 模式【免费下载链接】ops-sparse本项目是CANN提供的高性能稀疏矩阵计算的算子库专注于优化稀疏矩阵的计算效率。项目地址: https://gitcode.com/cann/ops-sparse审查清单9 项编号检查项检查内容1模板完整性所有章节存在算子概述、产品支持、函数原型、参数说明、约束、稀疏格式说明、调用示例占位符已替换为实际内容2API 函数签名函数原型与cann_ops_sparse.h声明逐字匹配参数名、类型、const 限定符、顺序一致Generic API 的描述符类型aclsparseConstSpMatDescr_t等正确3参数类型示例代码中 C 类型与函数签名匹配如float*非uint8_t*类型转换使用static_cast4RAII 模式描述符使用SpMatManager/DnVecManager/DnMatManager管理或aclsparseDestroy*与aclsparseCreate*严格配对Device 内存使用DeviceBuffer或aclrtFree配对禁止泄漏5API 名称正确性aclrtSynchronizeStream非aclrtStreamSynchronize、aclsparseCreate、aclsparseDestroySpMat等拼写正确6头文件完备仅包含cstdio、memory、vector、acl/acl.h、cann_ops_sparse.h禁止cstdint等冗余头文件7交叉引用调用示例标题与代码块之间包含compile_and_run_example.md链接格式示例代码如下仅供参考具体编译和执行过程请参考[编译与运行样例](https://link.gitcode.com/i/f283a8d9778c9d7a5f11c9e69ebfd19b)。8内存位置标注参数表中每行明确标注 Host 内存 / Device 内存9约束描述约束列表与 host.cpp 中Validate{Op}Params逻辑匹配无约束时写无不留空稀疏格式支持列表与实际实现一致审查流程5 阶段阶段 1获取输入读取src/{operator_name}/README.md从include/cann_ops_sparse.h查找对应 API 声明读取src/{operator_name}/archXX/{operator_name}_host.cpp获取约束验证逻辑阶段 2创建追踪任务使用 TaskCreate 创建 9 个审查任务每项一个初始状态 pending若工具不可用在上下文中输出检查点清单阶段 3逐项审查循环对每个 pending 任务TaskUpdate 锁定当前任务status: in_progress按清单逐项对照检查记录证据代码行号、文档引用评定每项状态通过 / 发现问题附行号和期望值TaskUpdate 完成确认status: completed阶段 4生成审查报告输出文件.agent/dev-docs/{operator_name}/4.1.1-审查报告.md格式每项一行状态 证据通过则简要说明发现问题则附行号期望值汇总通过项数 / 总项数明确标记整体通过或失败阶段 5输出日志摘要--- ## 日志摘要供任务下发方写入开发日志 - **状态**: ✅通过 / ❌失败 - **通过项**: N/9 - **发现问题**: 列表每项一行附行号【免费下载链接】ops-sparse本项目是CANN提供的高性能稀疏矩阵计算的算子库专注于优化稀疏矩阵的计算效率。项目地址: https://gitcode.com/cann/ops-sparse创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考