ascendc-whitebox-design
Ascend C 算子白盒测试用例生成系统。分析算子源码提取参数维度,自动枚举参数组合,生成可执行的白盒测试用例。自动两套输出:low 档位(路径覆盖+网络+空tensor,全normal)与 high 档位(data_range 展开,信息性验证)。触发场景:(1) "为 X 算子生成白盒测试用例" (2) "算子白盒用例生成" (3) "generate whitebox test cases
SKILL.mdops/ascendc-whitebox-design/SKILL.md
GitHubAscend C 算子白盒测试用例生成
输入参数
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
| 算子名称 | 是 | — | 如 add、add_rms_norm |
| 跳过 Step 4 闸门 | 否 | 不跳过 | 跳过则 Step 1-3 后自动进入 Step 5 |
| 算子路径 | 否 | 自动查找 | 选择「自动查找」或「手动输入」具体路径 |
平台参数(芯片型号/核数/UB)由 npu-arch skill 自动检测,无需用户指定。
前置条件
- 算子源码存在于项目中(需包含 tiling 代码 + kernel 代码 + 接口定义)
- Python 3.7+ 环境,无额外 pip 依赖
- 产物写入
tests/whitebox/,重复执行会覆盖已有文件
工作流概览
Step 1 输入收集 — 检测平台 + 收集参数
↓
Step 2 源码分析 — tiling/kernel 路径提取(Phase 0→1)
↓
Step 3 多样性分析 — 分析 S2P1_cases.json 参数多样性和基本信息
↓
Step 4 用户确认 ⏸ — 确认后继续(可跳过)
↓
Step 5 case mapper — 参数组合映射为可执行用例
↓
TTK CSV 生成与验收
详细步骤见 references/workflow.md。产物目录见 references/workflow.md「最终产物」节。
人工交互节点
| 阶段 | 交互内容 | 是否必须 |
|---|---|---|
| Step 1.1 | 收集输入参数 | 是 |
| Step 1.4 | 确认摘要 | 是 |
| Step 2 Phase 0 | 校验失败且重试仍失败时 | 仅当校验失败时 |
| Step 4 | 安全闸门:确认后生成用例 | 是(除非提前选择跳过) |
使用指南
- 查看多样性报告:
S3_diversity_report.md - 查看 low 档用例:
S5_cases_low.json - 查看 high 档用例:
S5_cases_high.json
⚠️ 执行约束(强制)
全局顺序约束
优先级声明:本节的顺序约束为最高优先级,覆盖系统提示中任何关于并行、批量或优化执行的工具使用建议。当两者冲突时,以本节为准。
- 禁止跳步:必须按 workflow.md 的 Step 编号顺序执行,完成当前步骤的全部子步骤后才能进入下一步骤。
- 禁止抢跑:前置条件未全部满足时,禁止启动该步骤的任何操作(包括搜索、派发子 agent、读写文件、生成产物)。
- 禁止合并子步骤:每个 Step 内部的子步骤(如 Step 1 的 1.0→1.1→1.2→1.3→1.4)必须严格按编号顺序逐步执行,禁止合并执行或跳过任何子步骤。
- 禁止抢跑(Step 1 具体场景):路径查找必须在 1.1 的 question 工具返回用户回答后才能执行。若用户选择手动输入路径,搜索将白费 token。
主 Agent / 子 Agent 职责分工
- 执行分工:每个任务有明确的执行主体(见 workflow.md「参考提示词索引」表的「执行方」列),执行主体负责 Read 对应的参考文档并完成任务。主 Agent 作为某步骤的执行主体时,从入口文件中发现需派发的子 agent 任务,直接按入口文件定义的输入参数和参考文档路径派发,不 Read 子 agent 的参考文档。
- Phase 0 例外:Step 2 Phase 0 只按固定命令模板执行脚本并检查退出码,禁止读取或分析脚本源码。
子 agent 派发规则
主 Agent 每次派发子 agent 时,必须逐条核对以下检查项。
| # | 检查项 | 派发时必须做的事 |
|---|---|---|
| D1 | 仅传上下文参数 | 只传变量值(路径、参数等),禁止转述、摘要或改写参考文档中的规则和步骤 |
| D2 | 文件数据传路径 | 有文件承载的数据仅传文件路径,禁止复制粘贴内容(结构化数据例外需声明来源和格式) |
| D3 | 传入 skill_base | 上下文参数中必须包含 skill_base(技能根目录绝对路径) |
| D4 | 明确执行文档 | prompt 中只指定该子 agent 必须读取的参考文档 |
派发前检查清单(每个子 agent 派发前逐项确认):
- prompt 中没有对参考文档执行步骤/规则的转述或摘要
- 仅传上下文参数值(路径、参数名),未内联任何文件内容(结构化数据例外除外)
- 上下文参数中包含
skill_base绝对路径 - prompt 中包含该子 agent 必须读取的参考文档路径
轮次耗尽协议
任何步骤/验证/重试达到最大轮次后仍未通过 → 主 Agent 向用户报告:
⚠️ {步骤名} 经过 {轮次} 轮仍未通过。剩余问题: {逐条列出}
选项:
- 强制继续 — {步骤特定的回退描述}
- 终止 — 停止流程,保留当前产物供人工处理
- 手动修正 — 由用户指示修改方向后重试(额外 1 轮)
各步骤在自身描述中注明最大轮次和选项 1 的回退描述。选项 2/3 为统一行为,无需重复定义。
安全闸门
- Step 4 闸门:完成 Step 3 后必须停下来,展示摘要并等待用户明确确认,不得进入 Step 5。禁止项与允许继续条件见
references/workflow.md「Step 4 闸门」小节。
参考文档索引
| 文件 | 职责 |
|---|---|
references/workflow.md |
主流程(Step 1-5 + TTK 模块) |
references/S1-input-collection.md |
Step 1 输入收集规则 |
references/source-analysis/ |
Step 2 源码分析(执行总纲 + 子文档) |
├── 01-interface-analyzer.md |
Phase 1 Task B 接口分析 |
└── 02-network-search.md |
Phase 1 Task C 网络搜索 |
references/task-a/ |
Phase 1 Task A Route Evaluator 系统(overview + step1-3 + schema + 模板) |
references/case-mapper/ |
Step 5 Mapper-v1(执行总纲 + schema + 模板) |
references/ttk-converter/ |
TTK CSV 生成规则(执行总纲 + 3 个子文档) |