おかしな入力には、黙らずに「おかしい」と返す——QDが検証ケースの3件を、わざと壊れた入力に当てる理由
設計のチェックを機械に任せると、結果の一覧が毎回出てきます。困るのは、一覧が間違っているときより、入力がおかしかったのに一覧がいつもどおりに見えるときです。木曜日は品質と開発の裏側の回です。QDが、壊れた入力を受けたときの返し方を、どう決めてどう測っているかを書きます。
「落ちない」と「黙らない」は、別のこと
おかしな入力を受けたときのソフトの振る舞いは、大きく3つに分かれます。止まって落ちるか、何も言わずにそれらしい結果を返すか、おかしいと知らせるかです。
落ちるのは、困りますが気づけます。画面が止まり、誰かが調べ始めます。厄介なのは2つ目です。落ちずに、黙って、いつもの形の結果を返す。使う人は、その結果を正しいと思って次の作業に進みます。
チェックの道具でこれが起きると、確かめたつもりの形が、実は確かめられていなかったことになります。落ちないように作ることと、黙らないように作ることは、別の仕事です。
黙って通るのは、正しい答えに見えるから
たとえば、フォルダの中の形を一括で確かめる処理に、形が1つも入っていないフォルダを渡したとします。処理は0件を数え、『0件でした』と返します。計算としては間違っていません。ですが、使う人が知りたいのは、確かめた結果が0件だったのか、確かめる物が無かったのかです。
座標に数でない値が混じった形や、三角形が1枚も無い空のデータも同じです。面積や体積の計算は、数でない値を含んだまま最後まで進み、もっともらしい表を作ることがあります。
作る側は、たいてい正しい入力で試します。正しい入力で正しい答えが出れば、作業は終わったように見えます。壊れた入力でどう振る舞うかは、わざと試さないと分かりません。
QDの決まり——20件のうち3件は、わざと壊れた入力
QDでは、1つのコマンドに検証ケースを20件付けます。内訳は、答えが式で出る基本の形5件、製品らしい実務の形5件、しきい値ちょうどの境界3件、回したり伸ばしたりした変形4件、そして異常な入力3件です。
異常の3件には、空のデータ、数でない値の混じった座標、受け付けない種類の形、読めない文字を含む条件など、実際に起こりうる壊れ方を選びます。合格の条件は1つです。例外で止まらず、結果に警告かエラーを付けて返すこと。答えの数字が何であっても、知らせていなければ不合格です。
この割合を『異常検出率』として毎晩測り、目標は100%です。社内の案件で使ってよい段階(実用)に上がるには、ここが100%であることが条件の1つになっています。
落ちないことと、黙らないことは別の仕事。
壊れた入力でどう振る舞うかは、わざと試さないと分からない。
言葉も測る——何が悪いかと、次に何をするか
警告を出せば終わり、ではありません。『エラー』とだけ書かれても、使う人は次に何をすればよいか分かりません。QDは警告とエラーの言葉そのものも測ります。
決まりは単純で、言葉が日本語で8文字以上あることです。短く見えますが、8文字あれば『何が悪いか』と『次に何をするか』の少なくとも片方は書けます。『形が1つもありません。フォルダを確かめてください』のような言葉です。この割合も、実用に上がる条件で100%を求めています。
数字の結果と警告は、別々の欄に並べて返します。結果の表はいつもの形のまま使え、警告の欄が空でなければ、その表をそのまま信じてよいかを先に見る。使う人の順番が、そう決まります。
// meshes: 確かめる形の配列。1つの形は { name, tris: [[x,y,z], ...] }
function checkAll(meshes) {
const out = { rows: [], warn: [] };
if (!Array.isArray(meshes) || meshes.length === 0) {
out.warn.push('形が1つもありません。フォルダを確かめてください');
return out;
}
for (const m of meshes) {
if (!m.tris || m.tris.length === 0) {
out.warn.push(m.name + ':三角形が0枚です。書き出しをやり直してください');
continue;
}
if (m.tris.some(p => !p.every(Number.isFinite))) {
out.warn.push(m.name + ':座標に数でない値があります。この形は測っていません');
continue;
}
out.rows.push({ name: m.name, n: m.tris.length });
}
return out; // rows が空でも、warn が空でなければ『確かめていない』
}お客様の側で変わること
チェックを一括で回す使い方ほど、この違いが効きます。何十個の形を夜に流し、朝に一覧を見るとき、空のフォルダや壊れた形が紛れていても、一覧の上に警告が並びます。『問題なし』と『確かめていない』を取り違えなくなります。
警告は、確かめた結果と一緒に記録に残ります。あとで『この形は本当に確かめたのか』と聞かれたとき、確かめた物と確かめられなかった物を分けて答えられます。
何を異常とするかは、形の種類やコマンドによって変わります。御社の形で起こりやすい壊れ方があれば、それを検証ケースに足すところから始められます。
今朝の数字——498のコマンドと、知らせずに通した85件
今朝(10月29日)の夜間の試験では、498のコマンドを判定しました。段階ごとの数は、実用69・簡易307・試作104・未実装18・製品0。前の朝より実用が2つ増え、簡易が2つ減りました。段階が下がったコマンドは1つで、実用から簡易へ。代表の形20件のうち1件と、時間の上限が届きませんでした。ゲートの終了コードは1です。
異常と境界のケースで、結果に警告もエラーも付けずに通したものは、今朝は85件ありました。43のコマンドにまたがっています。前の朝は83件・41のコマンドでした。例外で止まったのは1件だけで、残りはすべて『黙って通した』ほうです。空のフォルダ、数でない値の混じった数値、判定の無い結果、三角形が0枚のデータ。上に書いた壊れ方が、そのまま並んでいます。
異常検出率を測れた422のコマンドのうち、100%に届いているのは373です。残りの49は、どれも記録に名前が残り、直すまで実用には上がりません。黙って通した件数を、毎朝そのまま数えて残します。一括のチェックで結果を信じてよいか迷っている作業があれば、その形を1〜2点お借りして、壊れた入力も一緒に流すところから始めています。ヒアリングと自働化設計書のご提案までは無料です。QDで確かめられることの全体は、製品ページQRONIX QDにまとめています。
QD 品質チェック 498 コマンド
レベル別 Q0 18 Q1 104 Q2 307 Q3 69 Q4 0
下がった 1 ゲート終了コード 1
NG フォルダの一括処理 代表 19/20
No.18 [異常]STL が 1 つも無いフォルダ … 異常なのに知らせていない(結果に warn / error が無い)
NG 結果の集計表 代表 17/20
No.18 [異常]一括処理の結果が無い(null) … 異常なのに知らせていない
No.19 [異常]数値に NaN が混じる … 異常なのに知らせていない
No.20 [異常]判定の無い結果(judge が無い) … 異常なのに知らせていない
(2026-10-29 の夜間の記録から。読みやすいようにコマンドの番号を外し、行を選んで並べた)