自働化

頼る部品は、コマンドの側に書いておく——QDが、コマンドごとに使う部品を宣言させ、毎晩それだけを読んで1本ずつ別に動かす理由

2026.11.10 / 読了目安 7分 / 執筆: Qronix 開発チーム

#QD#CAD自働化#ツール開発事例
抜き勾配を面ごとに確かめる
今朝下がった抜き勾配のチェックの画面。この記事の例に挙げた、5つの部品に頼るコマンドです(見本の形で撮影・開発中の画面)
▶ YouTube で見る(音つき・30秒)

「自分のパソコンでは動くのに、渡した先では動かない」。社内のマクロやツールでよく聞く話です。火曜日は、QDの設計の考え方の回です。今回は、コマンドが頼っている部品を、コマンドの側に書いておくという決まりについて書きます。地味な決まりですが、必要なコマンドだけを配る、直した所が別の所を壊さない、という2つを支えています。

CONTENTS
1. 全部を読み込めば動く、が困るのは配る日 2. 頼っている部品が見えないと、何が起きるか 3. QDの答え:頼る部品は、コマンドごとに書いておく 4. 毎晩、書いた部品だけで、1本ずつ別に動かす 5. 今朝の数字:498本、下がった1本も単体では同じ答え 6. 社内のツールで、今日から始められること

全部を読み込めば動く、が困るのは配る日

社内で育ったツールは、たいてい全部入りで動いています。共通の計算をまとめたファイル、画面の部品、設定。作った人の手元では、それが全部そろった状態で使われます。

困るのは、一部だけを別の人に渡す日です。「この確認だけ使いたい」と言われて、そのファイルを渡す。ところが、それが頼っている共通の計算が抜けていて、相手の手元で初めて止まります。

どのファイルが要るかは、作った人の頭の中にしかありません。作った人が異動したり、時間が経ったりすると、全部入りのまま渡すしかなくなります。要る物が分からないツールは、まとめてしか動かせません。

設計の確認は、部署や取引先ごとに要る物が違います。全部入りでしか渡せないと、使わない機能まで入れて、そのぶん説明と確認が増えます。

頼っている部品が見えないと、何が起きるか

見えない頼り方にはもう1つあります。あるコマンドが、自分では読み込んでいない計算を、別のコマンドが先に読み込んでくれていたおかげで使えている、という状態です。

全部入りで動かしている間は、これに誰も気づきません。読み込む順番が変わった日や、片方のコマンドを外した日に、関係のないはずのコマンドが止まります。

前回の月曜日の回で書いた「直していない所が壊れる」理由の1つ、見えないつながりがこれです。気をつけて書けば防げる、という種類の話ではなく、数が増えるほど必ず出てきます。

ですから、頼っている部品は、人の記憶ではなく、ファイルに書いておく。そして書いた通りで本当に足りているかを、機械に確かめさせる。この2つをQDの決まりにしました。

抜き勾配のチェックが頼る5つの部品形の共通の計算どのコマンドも使う、形を読む・測る…曲線の書き出し結果の線を書き出す共通の部品勾配の計算面ごとの角度を出す計算金型の作業台の共通計算同じ作業台のコマンドで共有する計算コマンド本体1つのファイルに1つのコマンド
図1: コマンドの側に一覧を書いておく。配るときも、毎晩の単体の検査も、この一覧だけを読む。
JAVASCRIPTQDのコマンドより抜粋:単体の検査では、書いた部品だけを読み、全部を読んだときの答えと比べる
// 単体:一覧に書いたものだけを読む
if (isolated) { (C.deps || []).forEach(req); return; }

// …検証ケースを流す…

// 単体の結果が、全部を読んだときの結果と同じなら独立している
const iso = { pass: R.pass, n: R.n, deps: R.deps,
  same: !!prev && noTime(prev) === noTime(R) && prev.caseHash === R.caseHash };
console.log((iso.same ? 'OK ' : 'NG ') + cmd + ' 単体(deps ' + R.deps.length + ' 本だけ)で ' + R.pass + '/' + R.n);

QDの答え:頼る部品は、コマンドごとに書いておく

QDは1つのファイルに1つのコマンドで作っています。そのうえで、コマンドごとに、動くのに要る部品の一覧を書いておきます。

たとえば今朝下がった抜き勾配のチェックなら、一覧は5つです。形の共通の計算、曲線の書き出し、勾配の計算、金型の作業台で共通に使う計算、そしてコマンド本体です。これ以外は読みません。

別の作業台の共通の計算を借りるときは、コマンドのファイルの頭に、借りる先を書きます。配る物をまとめるときは、この書き置きを見て、借りた先のファイルも一緒に入れます。今は436本のコマンドが、この書き置きを持っています。

ファイルが無いコマンドは、QDに存在しない、というのが元からの決まりです。頼る部品が書いてあれば、要るコマンドだけを選んで、要るファイルだけを入れた配布物を作れます。

頼る部品は、人の記憶ではなくファイルに書く。
書いた通りで足りているかは、毎晩機械が確かめる。

毎晩の単体の検査で、書き漏れを見つけるまで全部を読んで検証ケースを流す1本ずつ別に起動し書いた部品だけ読む全部を読んだときと同じ答えか一覧で足りていると記録する書き漏れの疑いとして名前を残す朝、422本の結果がそろうはいいいえ
図2: 1本ずつ別に起動し、書いた部品だけを読ませる。全部を読んだときと同じ答えなら、書いた一覧で足りている。
コマンドが頼る部品の数(今朝の422本)1〜2つ12本3つ85本4つ136本いちばん多い
図3: 3〜5つのコマンドが315本。いちばん多いものでも15。

毎晩、書いた部品だけで、1本ずつ別に動かす

書いておくだけでは、書き漏れがあっても分かりません。そこで毎晩の検査で、検証ケースを持つ422本のコマンドを、1本ずつ別々に起動し、一覧に書いた部品だけを読ませて動かしています。

その結果を、全部を読み込んで動かしたときの結果と比べます。同じ答えが出れば、一覧に書いた部品だけで足りている、つまり見えない頼り方をしていない、と言えます。違えば、どこかで書いていない部品に頼っています。

今朝は422本すべてが、全部を読んだときと同じ答えを返しました。一覧に書いた部品の数は4つが136本でいちばん多く、3〜5つのコマンドが315本です。いちばん多いものでも15です。

1本ずつ別に起動するので、全部を一度に動かすより時間はかかります。それでも毎晩流しているのは、書き漏れが入った夜に、その夜のうちに名前が分かるようにするためです。

今朝11月10日の夜間の検査✓単体の検査:422本すべてが、全部を読んだときと同じ答え✓前の晩に下がった位置合わせ:試験136件をすべて通り、実用に戻った✗抜き勾配のチェック:試験152件のうち2件が通らず、実用から簡易へ✓498本の段階:実用69・簡易308・試作103・未実装18
図4: 1本下がって検査は失敗で終わったが、単体の検査は422本すべてが全部を読んだときと同じ答え。

今朝の数字:498本、下がった1本も単体では同じ答え

今朝11月10日の夜間の検査は、午前2時に始まって4時3分に終わりました。498のコマンドのうち、実用が69、簡易が308、試作が103、未実装が18です。

下がったのは1本で、抜き勾配のチェックが実用から簡易に下がりました。代表の検証ケース22件は全部通りましたが、形を変えて自動で作った試験152件のうち2件が通りませんでした。検査は失敗として終わり、名前が記録に残っています。

このチェックも、一覧に書いた5つの部品だけで動かしたときは、全部を読んだときと同じ答えでした。今回の下がり方は、見えない頼り方が原因ではないということです。何が答えを揺らしたかは、この記事を書いている時点ではまだ調べている途中です。

前の晩に下がった位置合わせのコマンドは、今朝は形を変えた試験136件をすべて通り、実用に戻りました。1本戻って1本下がったので、実用の数は前の晩と同じ69です。

PYTHON参考実装例:ツールの頭に書いた部品だけを空のフォルダに写して動かし、全部入りのときと答えを比べる
import shutil, subprocess, tempfile, pathlib


def needs_of(tool):
    """ファイルの頭の『# needs: a.py, b.py』を読む"""
    for line in pathlib.Path(tool).read_text(encoding="utf-8").splitlines()[:10]:
        if line.startswith("# needs:"):
            return [x.strip() for x in line[8:].split(",") if x.strip()]
    return []


def run(folder, tool, sample):
    r = subprocess.run(["python", tool, sample], cwd=folder, capture_output=True, text=True)
    return r.returncode, r.stdout


def check(src, tool, sample):
    full = run(src, tool, sample)                    # 全部入りのフォルダで動かす
    with tempfile.TemporaryDirectory() as tmp:       # 空のフォルダに、書いた物だけ写す
        for f in [tool, sample] + needs_of(pathlib.Path(src, tool)):
            shutil.copy(pathlib.Path(src, f), tmp)
        alone = run(tmp, tool, sample)
    return "OK 書いた部品で足りている" if alone == full else "NG 書いていない物に頼っている"


print(check("tools", "bom_check.py", "sample.csv"))

社内のツールで、今日から始められること

QDのような仕組みがなくても、始められることがあります。まず、マクロやツールのファイルの頭に、そのファイルが使う共通のモジュールや設定ファイルの名前を書いておきます。使う人にも、次に直す人にも読める場所です。

次に、ふだん使っていないパソコンや、まっさらな作業用のフォルダに、そのファイルと、頭に書いた物だけを置いて動かしてみます。止まれば、書いていない物に頼っています。全部のツールで一度ずつやるだけでも、渡した先で止まる回数は減ります。

最後に、それを直すたびに繰り返します。手で続かなければ、画面を開かずにフォルダごと流す回や、毎晩すべてを測り直す回に書いたように、決まった時刻に機械に流させます。

社内のマクロが全部入りでしか動かず、部署ごとに配り分けられなくて困っている、という相談もお受けしています。今のツール一式をお借りして、どの機能が何に頼っているかを書き出すところから始めます。ヒアリングと自働化設計書のご提案までは無料です。QDで確かめられることの全体は、製品ページQRONIX QDにまとめています。

Qronix 開発チーム

愛知県の大手自動車メーカー及びグループ各社で設計ツール開発の技術責任者を務めたメンバーを中心とする、CAD自働化のスペシャリスト集団。2024年創業、特許第7907964号を保有。

「うちの資産でもできる?」
まずその質問からどうぞ。

できる・できないの判定と自働化設計書のご提案までは無料です。

contact@qronix.jp へ相談する
記事一覧をすべて見る →
← 記事一覧へトップページへ →