메뉴
ops-blas 仓 AscendC 编码规范 + MR 安全编码规则速查索引。 **非开发期常驻上下文**：作为代码提交前的自查工具，按需读取。 触发时机：① 2.x.2 联调前 ② 2.x.3 验收前 ③ 3.1/4.2 代码检视前 ④ reviewer 检视 MR 代码时。 详细规则内容位于 references/ 目录，由调用方按需加载相关文档。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
ops-blas 算子全流程开发技能，协调 agent 团队完成设计->开发->验收->上库的完整开发链路。触发：用户要求开发新算子或实现某 BLAS 接口时。
为 BLAS 算子开发 GTest + CSV 驱动的精度 ST。触发场景： - 新算子 ST、编写 xxx_param.h / xxx_golden.h / xxx_npu_wrapper.h / xxx_test.cpp / xxx_test.csv - 改写旧式 TEST_F 为 CSV 参数化测试 按 6 步执行：分析 API → 写 param → 写 cpu/npu → 写 GTest → CMake → build.sh 验证。
ops-blas 日志框架使用规范。提供 Host 侧 dlog 日志集成模板、日志配置 API 说明和最佳实践。触发：算子开发中需要集成日志、检视日志使用规范、迁移 printf 到 dlog 时。
生成 PR 或 Issue 文件，并可通过 GitCode API 直接提交到仓库。仅当用户明确说"提PR"、"创建PR"、"提交Issue"、"推送到PR"、"amend"、"force push"等时才触发，禁止根据上下文推断自动触发。所有操作必须经过用户许可，禁止擅自行动。
BLAS 算子仓编译与验证命令参考。编译算子、运行测试、打包的常用命令。触发：需要编译算子、运行测试、查看 build.sh 用法时。
工作流维护技能。任何对 agent/ 目录下文件的新增、修改、删除操作，都必须先触发本技能再执行操作，包括修改本技能自身。禁止未触发直接修改。
| name | blas-ascendc-coding-rules |
| description | ops-blas 仓 AscendC 编码规范 + MR 安全编码规则速查索引。 **非开发期常驻上下文**：作为代码提交前的自查工具，按需读取。 触发时机：① 2.x.2 联调前 ② 2.x.3 验收前 ③ 3.1/4.2 代码检视前 ④ reviewer 检视 MR 代码时。 详细规则内容位于 references/ 目录，由调用方按需加载相关文档。 |
本规则为自查清单，不加载为开发期常驻上下文。仅在以下节点由 agent 按需调用：
| 调用时机 | 适用角色 | 调用方式 |
|---|---|---|
| 2.x.1.A 算子初稿完成后 | developer | 加载本 skill，按 references/checklist.md 自查一次 |
| 2.x.2 联调前 | developer | 同上 |
| 2.x.3 测试验收前 | developer | 同上 + 加载 references/mr-rules-essential.md 做 MR 合规审查 |
| CP2.x 打点前 | developer | 同上 |
| 3.1 / 4.2 代码检视前 | reviewer | 加载本 skill，对照 references/mr-rules-essential.md + references/mr-rules-general.md 做检视 |
| 编号 | 规则 | reference |
|---|---|---|
| R1 | 禁止逐元素操作 | references/R1-禁止逐元素操作.md |
| R2 | 动态获取 CoreNum（禁止硬编码） | references/R2-动态获取CoreNum.md |
| R3 | TPipe 禁止作为成员变量 | references/R3-TPipe禁止成员变量.md |
| R4 | TilingData 禁止使用数组做核间分配 | references/R4-TilingData禁止数组.md |
| R5-R10 | 圈复杂度/嵌套深度/函数行数/除零防御/许可证头/extern 引用 | references/ascendc-r5-r10.md |
| reference | 包含内容 | 适用场景 |
|---|---|---|
references/mr-rules-essential.md | 严重/致命级规则（G.PRE.05、G.INC.、G.FUU.09/10/12/13/15、G.MEM.04、G.STD.、OAT 等 ~18 条） | MR 提交前必查 |
references/mr-rules-general.md | 一般/建议级规则（G.EXP.、G.CTL.03、G.AST.03、G.FUU.11/14、CQ.、CIP.01 等 ~17 条） | 代码检视深度审查 |
| reference | 内容 | 适用场景 |
|---|---|---|
references/checklist.md | 8 步检查流程（文件级 → 头文件 → 函数级 → 表达式 → 安全函数 → 内存 → 标准库 → 冗余告警） | 提交前系统自查 |
references/fix-guide.md | 14 种常见违规的修复方法对照表 | 发现违规后查修复方案 |
在 2.x.1.A 完成后，调用本 skill 执行自检：
1. 加载 `references/checklist.md`，按 8 步流程逐条检查代码
2. 发现 R6 嵌套深度超标 → 加载 `references/ascendc-r5-r10.md` 查看修复方法
3. 发现 G.FUU.09 使用了 realloc → 加载 `references/mr-rules-essential.md` 确认级别与修复方案
4. 修复完成后再次执行 checklist.md 直至通过
在 3.1 / 4.2 检视前，加载：
1. `references/mr-rules-essential.md` 对照严重/致命规则做检视（必须零违规）
2. `references/mr-rules-general.md` 做深度审查（建议修复）
3. `references/ascendc-r5-r10.md` 检查代码质量指标（圈复杂度/嵌套深度/行数）
注意：本 skill 的 SKILL.md 仅作为索引与触发说明。Agent 在执行自查/检视时，应直接读取相应的 references 文件获取完整规则，不要在开发过程中常驻本 skill 的全部内容。