【免费下载链接】pto-isaParallel Tile Operation (PTO) is a virtual instruction set architecture designed by Ascend CANN, focusing on tile-level operations. This repository offers high-performance, cross-platform tile operations across Ascend platforms.项目地址: https://gitcode.com/cann/pto-isaname: PTO指令文档更新模式 description: PTO ISA 新增指令时需要更新的文档文件和位置模式总结。根据 docs/assembly/README.md 中的分类动态选择需要修改的汇编文件。触发新增 PTO 指令如 TPOW、TPOWS后需要同步更新文档时。 license: CANN Open Software License Agreement Version 2.0PTO指令文档更新模式此 skill 总结了为 PTO ISA 添加新指令如 TPOW、TPOWS时需要更新的文档文件和位置模式。适用场景当新增 PTO 指令后需要同步更新相关文档时使用此 skill。使用git status查看当前 staging 的文件列表来确认所有需要修改的文件。Git Staged 文件分类新增文件需预先创建类型说明指令diagramsdocs/figures/isa/{指令名}.svg- 指令操作示意图指令文档docs/isa/{指令名}.md- 详细指令文档英文指令文档docs/isa/{指令名}_zh.md- 详细指令文档中文修改文件需同步更新类型说明ISA主索引docs/PTOISA.md- ISA索引表格ISA主索引docs/PTOISA_zh.md- ISA索引表格中文ISA参考目录docs/isa/README.md- 按分类排序的指令列表ISA参考目录docs/isa/README_zh.md- 按分类排序的指令列表中文菜单文档docs/menu_apis.md- 按分类排序的中文链接汇编参考docs/assembly/类别-ops.md- 根据指令类型动态选择指令族矩阵docs/mkdocs/src/manual/appendix-d-instruction-family-matrix.md- 指令族矩阵指令族矩阵docs/mkdocs/src/manual/appendix-d-instruction-family-matrix_zh.md- 指令族矩阵中文include索引include/README.md- 实现状态表格include索引include/README_zh.md- 实现状态表格中文动态选择汇编文档根据docs/assembly/README.md中的### 2. PTO Tile Operation Categories决定需要修改的汇编文件。汇编文件列表对应分类分类汇编文件说明Elementwise (Tile-Tile)elementwise-ops.mdtile-tile 逐元素操作Tile-Scalar / Tile-Immediatetile-scalar-ops.mdtile-标量操作Axis Reduce / Expandaxis-ops.md轴归约/扩展操作Memory (GM ↔ Tile)memory-ops.md内存操作Matrix Multiplymatrix-ops.md矩阵乘操作Data Movement / Layoutdata-movement-ops.md数据搬运/布局操作Complexcomplex-ops.md复杂操作Manual Resource Bindingmanual-binding-ops.md手动资源绑定操作Scalar Arithmeticscalar-arith-ops.md标量算术操作Control Flowcontrol-flow-ops.md控制流操作Auxiliary Functionsnonisa-ops.md辅助函数操作动态选择规则确定指令分类- 查看docs/assembly/README.md中的分类定义选择对应文件- 根据分类选择对应的类别-ops.md文件更新计数- 更新该文件中**Total Operations:** N的计数添加章节- 在该分类最后一个指令后插入新指令章节更新模式详解1. ISA 主索引文件docs/PTOISA.md / docs/PTOISA_zh.md位置: 指令索引表格分类:逐元素Tile-Tile指令 → 插在TFMOD后Tile-标量 / Tile-立即数 → 插在TSUBSC后include/README.md / include/README_zh.md位置: 实现状态表格按字母序分类:TPOW → 插在TPRELU和TPUT之间TPOWS → 插在TPUT_ASYNC和TQUANT之间2. ISA 参考目录docs/isa/README.md / docs/isa/README_zh.md位置: 按分类排序的指令列表分类:Elementwise (Tile-Tile) → 插在TFMOD后Tile-Scalar / Tile-Immediate → 插在TSUBSC后3. 菜单文档docs/menu_apis.md位置: 按分类排序的中文链接列表同 ISA 参考目录结构4. 汇编文档动态选择根据指令类型选择对应的文件指令类型目标文件插入位置TPOW (Elementwise)elementwise-ops.mdTFMOD 后TPOWS (Tile-Scalar)tile-scalar-ops.mdTSU BSC 后TROWSUM (Axis)axis-ops.md最后一个 Axis 指令后TLOAD (Memory)memory-ops.md最后一个 Memory 指令后TMATMUL (Matrix)matrix-ops.md最后一个 Matrix 指令后TMOV (Data Movement)data-movement-ops.md最后一个 Data Movement 指令后TQUANT (Complex)complex-ops.md最后一个 Complex 指令后TASSIGN (Manual Binding)manual-binding-ops.md最后一个 Manual 指令后5. 指令族矩阵docs/mkdocs/src/manual/appendix-d-instruction-family-matrix.md位置: D.2 覆盖统计表 D.4 家族矩阵表D.2 更新示例:| Elementwise (Tile-Tile) | 28 → 29 | | Tile-Scalar / Tile-Immediate | 19 → 20 | | Total | 126 → 128 |D.4 更新:在对应分类的最后一条目后插入新指令docs/mkdocs/src/manual/appendix-d-instruction-family-matrix_zh.md同英文版本常见新增指令分类与插入位置Tile-Tile (逐元素双Tile)插入位置:TFMOD之后对应文件:elementwise-ops.md示例: TPOWTile-Scalar (Tile与标量)插入位置:TSUBSC之后对应文件:tile-scalar-ops.md示例: TPOWSAxis Reduce / Expand插入位置: 最后一个 Axis 指令之后对应文件:axis-ops.mdMemory (GM ↔ Tile)插入位置: 最后一个 Memory 指令之后对应文件:memory-ops.md更新检查清单新增文件预先创建docs/figures/isa/{新指令}.svg- 指令操作示意图docs/isa/{新指令}.md- 详细指令文档英文docs/isa/{新指令}_zh.md- 详细指令文档中文修改文件同步更新docs/PTOISA.md- ISA主索引docs/PTOISA_zh.md- ISA主索引中文include/README.md- include索引include/README_zh.md- include索引中文docs/isa/README.md- ISA参考目录docs/isa/README_zh.md- ISA参考目录中文docs/menu_apis.md- 菜单文档docs/assembly/类别-ops.md- 动态选择的汇编文件英文中文docs/mkdocs/src/manual/appendix-d-instruction-family-matrix.md- 指令族矩阵docs/mkdocs/src/manual/appendix-d-instruction-family-matrix_zh.md- 指令族矩阵中文注意事项英文中文: 每个文件都有中英文两个版本需要同步更新动态选择: 根据docs/assembly/README.md选择的分类来确定需要修改的汇编文件计数变化: 需要同时更新 Operation Count分类小计和 Total总计详细指令文档: 需要预先创建在docs/isa/目录下diagrams: 需要预先创建在docs/figures/isa/目录下使用git status可以查看当前 staging 的文件列表这是确认所有需要修改文件的最佳方式【免费下载链接】pto-isaParallel Tile Operation (PTO) is a virtual instruction set architecture designed by Ascend CANN, focusing on tile-level operations. This repository offers high-performance, cross-platform tile operations across Ascend platforms.项目地址: https://gitcode.com/cann/pto-isa创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考