By name: external-cannbot-ops-ascendc-regbase-best-practice description: 当需要为 DAV_3510 RegBase 算子确认 API 约束、实现结构、排查常见陷阱或选择真实参考算子时使用。 original-name: ascendc-regbase-best-practice synced-from: https://gitcode.com/cann/cannbot-skills synced-date: '2026-05-26' synced-commit: ac5bbd2b4cf427d011874e11f8d1e8b1bef66eda license: UNKNOWN
Ascend C RegBase 开发
该能力解决 RegBase 路线下的四类问题：API 约束确认、实现结构参考、常见陷阱排查、真实参考算子选择。
reference-ops 子树是轻量参考资产。算子名称或基础类型匹配只表示“值得查看的候选参考”，不能证明目标任务可以直接复用、融合或复制该实现。是否复用必须重新做 RegBase 专项设计判断。
何时使用
满足以下任一条件时使用该能力：
- Architect 在方案决策中把 RegBase 作为候选路线。
- 用户、DESIGN.md 或代码明确出现 RegBase / RegTensor / asc_vf_call / simd_vf 等信号。
- Developer 或 Reviewer 需要确认 RegBase 专属 API、实现结构、陷阱或参考实现。
不要把该能力当成默认算子开发路径的通用替代品。技术路线未决时，由 Architect 完成 SIMD/MemBase 与 RegBase 的方案决策。
阅读入口
- 端到端开发主线：
references/regbase_development_guide.md - API 约束和签名：
references/api/index.md - 陷阱和精度风险：
references/pitfalls/index.md - 工程经验和路线判断：
references/dev-experience/index.md - 真实参考实现：
references/reference-ops/open_source_operator_table.md
按阶段选择
- 方案决策：
references/regbase_development_guide.md、references/dev-experience/index.md - 设计：
references/regbase_development_guide.md、references/api/index.md - 实现：
references/api/index.md、references/dev-experience/regbase_programming_notes.md、references/reference-ops/open_source_operator_table.md - 审查：
references/pitfalls/index.md、references/dev-experience/index.md - 修复和调试：
references/pitfalls/symptom_to_cause.md、references/dev-experience/index.md
进入 api/、pitfalls/ 或 dev-experience/ 后，先读该目录的 index.md，再打开叶子文档。针对一个子问题，最多展开 5 篇叶子文档；仍不够时拆分问题，而不是一次加载整个子树。
约束
- 引用 API 前必须检查 API 白名单、API reference 或官方文档；不要凭函数名猜测。
- 设计伪代码不能直接当作可编译实现；写代码时必须回到真实工程模板和 API 签名。
- 编写新 RegBase 算子前，必须通过
open_source_operator_table.md定位候选目录，并阅读至少一个经确认包含 RegBase 证据的真实实现。 - 看到
RegTensor/MaskReg/asc_vf_call/__simd_vf__等关键词时，优先检查 API 层和 pitfalls 层。 - 架构判断必须显式说明。如果某条经验来自兼容路径而不是主路径
DAV_3510 / RegBase，需要说清楚。