CANN源码分析执行总纲

Source Analysis — 执行总纲

【免费下载链接】cannbot-skillsCANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体，本仓库为其提供可复用的 Skills 模块。项目地址: https://gitcode.com/cann/cannbot-skills

角色

分析算子源码（tiling + kernel + 接口），提取分支路径和参数维度，产出代码路径清单、算子接口模型、参数定义和测试设计文档，供下游 Step 5（case mapper）和 Step 6（pytest）消费。

输入

源码读取范围规则（强制）

S2P0_file_manifest.json体积较大，子 agent 只需文件清单和读取范围。主 Agent 在 Phase 0→1 过渡阶段提取tiling.file_list+kernel.file_list+tiling.excluded+kernel.excluded，按固定格式拼接为文本块后内联传入 Task A 和 Task D。子 Agent 严格按此范围读取，不得自行添加。

格式化模板

Phase 0→1 过渡阶段，主 Agent 将S2P0_file_manifest.json提取为以下文本块，传入 Phase 1 Task A 和 Phase 2 Task D：

源码读取范围（严格遵守，禁止自行添加其他文件）： 【tiling】 - P0: {path} — {read_strategy 描述，附 symbols} - P1: {path} — 仅读符号 {symbols}（read_strategy={value}） 【kernel】 - P0: {path} — 仅读 TILING_KEY_IS dispatch 块（{key_count}条, pattern={pattern}） - 总计 {kernel.total_key_count} 条 key 【排除】以下文件禁止读取： - {excluded path} — {reason}

输出文件

可选产物（不阻塞门禁）：

执行顺序约束（强制）

以下 Phase 必须按编号顺序逐步执行，禁止跳步或抢跑。

并行规则：

• Phase 0：Scout-T 和 Scout-K并行派发，两者完成后派 Scout-Verify
• Phase 1：Task A、B、C并行派发（无依赖）
• Phase 2：Task D串行（依赖 Phase 1 全部完成）
• Phase 3：3a 和 3b串行（3b 依赖 3a 完成）

校验失败处理：

• Scout-Verifyverification.status=fail→ 重跑失败的 Scout（最多 1 次），仍 fail → 触发轮次耗尽协议
• Phase 0→1 过渡：pass/pass_with_fixes→ 进入 Phase 1

完成标志：S2P3_test_design.md已生成，Phase 3a 的 disputed 路径已由用户确认（无 disputed 则自动满足）。

子 Agent Prompt 模板

主 Agent 派发 Task A/B/C/D 子 agent 时，Read 本节对应模板，替换占位符后作为 prompt 发送。禁止自行改写模板结构或措辞，仅允许替换{占位符}。

占位符定义

Task A：代码路径分析

你是代码路径分析专家。请执行 Phase 1 Task A：代码路径分析（tiling + kernel）。 **优先执行入口文件顶部的执行顺序约束节**。 请先 Read 参考文档 `{skill_base}/references/source-analysis/04-code-analyzer.md`，然后按照文档中的规则逐步执行代码路径分析。 上下文参数： - 算子名称：{op_name} - 算子路径：{op_path} - platform：npu_arch={npu_arch}, soc_version={soc_version}, chip_model={chip_model}, core_count={core_count}, ub_size={ub_size} - skill_base：{skill_base} - 产出写入路径：{output_dir} - S2P0_scout_t.md 路径：{scout_t_path} - S2P0_scout_k.md 路径：{scout_k_path} {file_manifest_text} 请生成 `S2P1_path_list.json` 和 `S2P1_tiling_glossary.md` 到产出路径。完成后返回产出的文件路径和关键发现摘要（路径总数、分组数、disputed 路径列表）。

Task B：接口分析

你是接口分析专家。请执行 Phase 1 Task B：接口分析。 **优先执行入口文件顶部的执行顺序约束节**。 请先 Read 参考文档 `{skill_base}/references/source-analysis/05-interface-analyzer.md`，然后按照文档中的规则逐步执行接口分析。 上下文参数： - 算子名称：{op_name} - 算子路径：{op_path} - platform：npu_arch={npu_arch}, soc_version={soc_version}, chip_model={chip_model}, core_count={core_count}, ub_size={ub_size} - skill_base：{skill_base} - 产出写入路径：{output_dir} 请生成 `S2P1_operator_model.json` 到产出路径。完成后返回产出的文件路径和接口模型摘要（inputs/outputs/attributes 列表）。

Task C：网络搜索

你是网络搜索专家。请执行 Phase 1 Task C：常见网络 shape 配置搜索。 **优先执行入口文件顶部的执行顺序约束节**。 请先 Read 参考文档 `{skill_base}/references/source-analysis/08-network-search.md`，然后按照文档中的规则逐步执行网络搜索。 上下文参数： - 算子名称：{op_name} - 算子路径：{op_path} - platform：npu_arch={npu_arch}, soc_version={soc_version}, chip_model={chip_model}, core_count={core_count}, ub_size={ub_size} - skill_base：{skill_base} - 产出写入路径：{output_dir} 请生成 `S2P1_low_configs.json` 到产出路径。完成后返回产出的文件路径和搜索到的典型配置数量。

Task D：参数推导

你是参数推导工程师。请执行 Phase 2 Task D：路径枚举 + 参数推导。 **优先执行入口文件顶部的执行顺序约束节**。 请先 Read 参考文档 `{skill_base}/references/source-analysis/06-param-derivation.md`，然后按照文档中的规则逐步执行参数推导。 上下文参数： - 算子名称：{op_name} - 算子路径：{op_path} - platform：npu_arch={npu_arch}, soc_version={soc_version}, chip_model={chip_model}, core_count={core_count}, ub_size={ub_size} - skill_base：{skill_base} - 产出写入路径：{output_dir} - S2P1_path_list.json 路径：{path_list_path} - S2P1_operator_model.json 路径：{operator_model_path} - S2P1_low_configs.json 路径：{low_configs_path} {file_manifest_text} 完成后返回产出的文件路径、参数分组数量和关键发现摘要。

Phase 3a：disputed 路径处理规则

Task D 返回的 disputed 列表（路径可达性不确定的条目）由主 Agent 处理：

1. 向用户提问（一次性问完所有 disputed 项）
2. 选项：全部接受建议 / 逐条确认
3. 用户确认后，主 Agent 更新S2P1_path_list.json：
   • accepted → reachable
   • excluded → dead 并记录原因
4. 无 disputed 则跳过此步骤

文件索引

【免费下载链接】cannbot-skillsCANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体，本仓库为其提供可复用的 Skills 模块。项目地址: https://gitcode.com/cann/cannbot-skills