external-gitcode-ascend-atb-ops-to-aclnn-migration-workflow

name	external-gitcode-ascend-atb-ops-to-aclnn-migration-workflow
description	ATB OPS→ACLNN 迁移标准化工作流主模板。整合前置学习、设计文档生成、CSV用例设计、 实际迁移、编译验证、测试验证全流程，提供明确的阶段 Gates 和用户确认机制。
keywords	["atb","aclnn","workflow","migration","ops","template","标准化流程","昇腾"]
metadata	{"author":"ascend-transformer-boost-team + Claude Code + deepseek-v4-pro","version":"1.6.0","created":"2026-04-20","updated":"2026-04-29","skill-type":"workflow","allowed-tools":"Bash(docker|bash|cd|ls|grep|find|echo|cat|git) Read(*) Write(*)","gates":[{"id":"gate-1","description":"设计文档确认","trigger":"Phase 1 完成后，等待用户确认设计文档"},{"id":"gate-2","description":"CSV 用例确认","trigger":"Phase 2 完成后，等待用户确认 CSV 用例"},{"id":"gate-5b","description":"全量回归门控","trigger":"Phase 5b 完成后，所有相关 CSV 必须全部通过，方可进入 Phase 6"},{"id":"gate-6","description":"最终交付确认","trigger":"Phase 6 完成后，等待用户确认交付报告"}]}
hooks	{"PreToolUse":[{"matcher":"Write|Edit|Bash","hooks":"[Truncated]"}],"PostToolUse":[{"matcher":"Write|Edit","hooks":"[Truncated]"}],"Stop":[{"hooks":"[Truncated]"}]}
original-name	atb-ops-to-aclnn-migration-workflow
synced-from	https://gitcode.com/Ascend/agent-skills
synced-date	2026-05-26
synced-commit	1f7666e7768a0ceb21bb1d40ce4b5179fcb6f1d6
license	UNKNOWN

ATB OPS→ACLNN 迁移标准化工作流

功能概述

定义 ATB 算子从 OPS 接口迁移至 ACLNN 接口的标准化 7 阶段工作流，含 Human in the Loop 用户确认机制。

调用时机

• {xxx}Quant、{xxx}Norm、Softmax 等算子的 OPS→ACLNN 迁移
• 910B/950 设备启用 ACLNN 加速
• 保持对其他设备的兼容性

---

详细内容

🔍 查看详细内容

阶段 Gates 概览

[Phase 0] 前置知识学习
    │
    ▼
[Phase 1] 设计文档生成 ────→ [用户确认 Gate 1] ───┐
    │                                         │
    ▼                                         │
[Phase 2] CSV用例设计 ─────→ [用户确认 Gate 2] ───┤
    │                                         │
    ▼                                         ▼
[Phase 3] 实际迁移（TDD） ←───────────────────────┘
    │
    ▼
[Phase 4] 编译验证（≤3次尝试）
    │
    ▼
[Phase 5a] 小范围验证
    ├─ Step 1: 前台跑 _func.csv（正例+反例, ~30s）
    └─ Step 2: 后台 subagent 跑 _perf.csv（性能, ~10min, 不阻塞）
    │
    ▼
[Phase 5b] 全量回归（所有相关 CSV）──→ [Gate 5b: 全量通过] ──┐
    │ （汇合 subagent 性能结果）                               │
    ▼                                                        ▼
[Phase 6] 交付报告 ←──────────────────────────────────────────┘

Phase 0-6 详细说明

详见下方各阶段详细文档。

---

禁止跳步规则 ⛔

⚠️ 以下规则在每次 Phase 转换时必须强制执行，不可绕过：

Phase 依赖矩阵

Phase	前置 Gate	未通过时的行为
Phase 1	Gate 0 (文档齐全)	阻断 — 缺少接口文档时禁止进入设计阶段
Phase 2	Gate 1 (设计确认)	阻断 — 用户未确认设计文档前禁止写 CSV
Phase 3	Gate 2 (CSV 确认)	阻断 — 用户未确认 CSV 用例前禁止写代码
Phase 4	Phase 3 完成	可执行（编译验证）
Phase 5a	Phase 4 通过	先跑 Phase 2 再跑 Phase 5a — 用例未设计完禁止测试
Phase 5b	Phase 5a 通过	全量回归 — 所有相关 CSV 必须全部运行并通过
Phase 6	Gate 5b 通过	可执行（交付报告）

每阶段开始时必须执行的检查

1. 确认上一阶段 Gate 状态:
   - Gate X 是否已获用户确认?
   - 确认记录在哪里 (commit message / working_files / 对话记录)?

2. 如果 Gate 未通过:
   - 立即停止
   - 向用户报告: "Phase Y 需要 Gate X 确认，当前 Gate X 状态: 未确认"
   - 等待用户指示

3. 如果 Gate 已通过:
   - 明确告知用户: "Gate X 已通过，进入 Phase Y"
   - 继续执行

常见跳步错误与拦截话术