# External Cannbot Ops Ascendc Regbase Best Practice

> 当需要为 DAV_3510 RegBase 算子确认 API 约束、实现结构、排查常见陷阱或选择真实参考算子时使用。

- Skill: `ascend-ai-coding/external-cannbot-ops-ascendc-regbase-best-practice` (Agent Skill, multi-file: 24 files)
- Install (CLI): `npx skillmds@latest add ascend-ai-coding/external-cannbot-ops-ascendc-regbase-best-practice`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ascend-ai-coding/external-cannbot-ops-ascendc-regbase-best-practice/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- License: UNKNOWN
- Author: ascend-ai-coding (https://skillmd.com/u/ascend-ai-coding)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ascend-ai-coding/external-cannbot-ops-ascendc-regbase-best-practice

---


# 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`，需要说清楚。