メインコンテンツへスキップ

2つのPRは、どちらもテスト合格。でも合わせると動かない

公開日:
飯飯田 友広
AIエージェントNode.jsGitHubテスト開発
二つの実装がそれぞれPASSしても、合流するとtotalCentsとtotalのAPI契約不一致でFAILになる構造図。

AIが書いた変更を2件受け取り、それぞれのテストが緑だったとします。次に必要なのは、その2件を実際に組み合わせた状態で確かめることです。緑の表示は、どの入力・どのコードに対する結果なのかで意味が変わります。

ここではNode.jsの標準テスト機能 node:test だけを使います。注文APIとCSV出力の架空の教育用例であり、Netsujoや他社の実障害、実際のGitマージ失敗を報告するものではありません。実際に再現するのはコードのAPI契約不一致です。

2件が別々にPASSする理由

架空のPR Aは注文APIの金額を小数の total: 49.95 から整数の totalCents: 4995 に変更します。整数の最小通貨単位を使うという契約です。

agent-a.mjs:
export function fetchOrder() {
  return { id: 'demo-order-1', totalCents: 4995 };
}

その単独試験 agent-a.test.mjs:

import test from 'node:test';
import assert from 'node:assert/strict';
import { fetchOrder } from './agent-a.mjs';

test('producer returns totalCents', () => {
  assert.deepEqual(fetchOrder(), {
    id: 'demo-order-1', totalCents: 4995
  });
});

架空のPR BはCSVへ金額を出力する関数を持っています。ただし、こちらは古いfixtureを使って単独テストを実行している設定です。

agent-b.mjs:
export function exportAmount(order) {
  return order.total.toFixed(2);
}
agent-b.test.mjs:
import test from 'node:test';
import assert from 'node:assert/strict';
import { exportAmount } from './agent-b.mjs';

test('old fixture passes', () => {
  assert.equal(
    exportAmount({ id: 'demo-order-1', total: 49.95 }),
    '49.95'
  );
});

2つのテストを個別に実行するとPASSします。

node --test agent-a.test.mjs agent-b.test.mjs
# tests 2 / pass 2 / fail 0

B側が正しいと確認できたのは、古い入力に対する動作です。新しいA側の返り値と動くことは、まだ確認していません。

連結した実入力を渡すと、1件FAILする

combined.test.mjs:
import test from 'node:test';
import assert from 'node:assert/strict';
import { fetchOrder } from './agent-a.mjs';
import { exportAmount } from './agent-b.mjs';

test('producer and consumer contract', () => {
  assert.equal(exportAmount(fetchOrder()), '49.95');
});
node --test combined.test.mjs
# tests 1 / pass 0 / fail 1 / exit 1(意図した失敗)
fetchOrder() の返り値には total がありません。したがって order.total.toFixed(2) は TypeError になります。Gitが同じ行への編集を検知して止まる「テキストのマージ競合」とは違い、別ファイルの変更を組み合わせた後に見える不整合です。

契約を合わせて、同じ組合せを再検証する

agent-b-fixed.mjs:
export function exportAmount(order) {
  return (order.totalCents / 100).toFixed(2);
}
repaired.test.mjs:
import test from 'node:test';
import assert from 'node:assert/strict';
import { fetchOrder } from './agent-a.mjs';
import { exportAmount } from './agent-b-fixed.mjs';

test('aligned contract passes', () => {
  assert.equal(exportAmount(fetchOrder()), '49.95');
});
node --test repaired.test.mjs
# tests 1 / pass 1 / fail 0

この修正は、サンプルの1種類の金額だけを扱います。一般的な通貨変換の丸めや通貨種別まで保証するものではありません。実案件では仕様、データ型、互換性、例外系も別途確認します。

自分のPRで確認する4つのこと

1. どのcommitで緑になったか。 テストやレビューの対象SHAが、その後の修正で変わっていないか。

2. 何をモックしていたか。 単独テストのfixtureが古いAPI契約を隠していないか。

3. 何を組み合わせて走らせたか。 producerとconsumerが両方とも最終候補のコードか。

4. 統合後に再確認したか。 mainや他のPRを取り込んだら、変更後の候補でテストをやり直したか。

レビュー担当が実装者の説明だけを信じず、実際のdiff・対象commit・実行されたテストを独立に確認することも大切です。ただし、それだけでは新しい組合せのテストを省略できません。

この例の発端となるAIレビューの独立性についての議論では、同じPRを複数のAIが見ても独立した検証とは限らないと問いかけています。ここではその問いを、別々にPASSした変更を統合するときの練習へ展開しました。並列作業の構成と統合責任の設計は、Netsujoの既存解説を参照してください。

この7ファイルはNode.js v24.22.1を用いた隔離準備で「個別2 PASS→組合せ1 FAIL→修正後1 PASS」を確認しています。これは正規リポジトリの必須CIや独立QC、実際のAI PRの安全性を示すものではありません。

みやこでITでは、こうした小さな再現を持ち寄って技術を試せます。次の勉強会・交流会はイベント一覧で確認できます。

🏷️このカテゴリ:コミュニティ運営

カテゴリ一覧

もくもく会・勉強会・交流会の運営ノウハウとケース。

AIのPR下書き:変更範囲を決める

架空のPR下書きで、編集してよい範囲、拒否、差分の読み戻しを試す手順です。

英語ページがあっても言語対応は片方向だった|日本語3ページを直し、日英6ページで確かめた記録

「みやこでIT」のサイトで、日本語3ページが対になる英語ページへのhreflangを出していませんでした。原因、共通関数への置き換え、実ページを読む回帰テスト、本番6URLの確認と、まだ測っていない効果を記録します。

AIの支払案を資金が動く前に検査する|ARCのオンチェーン金融デモを架空データで実行した記録

Agent Role Contractsのfinance・Safeデモと追加の宣言検査を、架空データで実行した記録を読みます。想定した拒否、元に戻すとPASSに戻る動き、手元で再現する手順、検査していないことまで分けて示します。

AIにWebサイト改善を任せてわかった、テストが通っても残る問題

みやこでITのサイト改善で見つかった、料金条件の取りこぼし、HTML読み取り、日本語の改行。修正と反例テスト、本番確認までの実例を紹介します。

大阪から京都のもくもく会へ。一人で参加する休日の組み立て方

大阪から京都のもくもく会へ一人で参加する準備を、実際の開催案内を例に整理。会場までの経路、参加枠ごとの料金、作業の準備、帰宅までを考えます。

京都で、誰かと、何かをつくる。みやこでITが育てたい「出会いのその先」

京都のITコミュニティ「みやこでIT」が大切にする、人との出会いから生まれる学び、仲間、小さな挑戦。2019年から活動を続けてきた主宰が、これから育てたいコミュニティの価値を語ります。

AIエージェントのLTで「動いた」をどう証明するか|公開デモのPASS→FAIL→PASSを1枚にする

AIエージェント実践LT会の開催記録を起点に、Agent Role Contractsの公開デモの入力・期待結果・過去CIを使い、再現可能な発表の証拠の残し方を整理。

大光寺のもくもく会をヒントに、初対面の人へ「詰まり」を伝える4行メモ

大光寺のもくもく会#62を起点に、初対面の相手へ短時間で相談内容を伝える4行メモを提案。実際の活動記録と架空の練習例、未検証の効果を区別します。

✍️この著者:飯田 友広

著者ページ

京都を拠点にIT人材・企業・大学・地域をつなぐ京都のITコミュニティ「みやこでIT」を主宰。7年167回の運営からTEMPLEモデルを抽出し、地域コミュニティの実装可能性を研究しています。

京都で、誰かと、何かをつくる。みやこでITが育てたい「出会いのその先」

京都のITコミュニティ「みやこでIT」が大切にする、人との出会いから生まれる学び、仲間、小さな挑戦。2019年から活動を続けてきた主宰が、これから育てたいコミュニティの価値を語ります。

「試したこと」をコードで外へ返す。Agent Role ContractsをOSSとして公開しました

Agent Role Contracts 0.5.0をnpm latestの安定版として公開しました。役割・権限・レビュー分離・作業範囲・引き継ぎの宣言を、実行前にどう検査するかを最小の例で紹介します。

AIエージェント分業を試す|ChatGPT・Claude Code・Codexの実践手順

ChatGPT、Claude Code、Codexを役割分担して使う開発フローを、個人開発やもくもく会で試せる形に再設計しました。タスク契約、実装、決定論的チェック、独立レビュー、人間の最終判断までを具体的な手順で整理します。

生成AI時代のIT勉強会の価値|京都「みやこでIT」で見えた、教わる場から試す場への変化

生成AIで技術情報を得るコストが下がった今、IT勉強会の価値はどこにあるのか。京都で活動する「みやこでIT」のClaude Code、AIエージェント、AI動画、量子コンピュータの開催実績から、「教わる場」から「実際に試した結果を持ち寄る場」への変化を考えます。

京都で技術相談先を探す方法|技術顧問・CTO代行の選び方

京都の企業・研究者が技術の相談先を探すときの進め方を整理しました。契約形態を先に決めず「何を判断してほしいか」から分ける方法、相談先9種類の特徴、コミュニティにできること・できないことを解説します。「みやこでIT」と運営会社の関係も明記します。

TEMPLEモデル|社内・地域コミュニティ設計の6つの観点

京都の「みやこでIT」を7年運営した経験を、Theme・Environment・Members・Persistence・Local・Evolutionの6つの観点へ整理した仮説モデルです。当てはめれば成功する法則ではなく、続いた企画と止まった企画を振り返って、判断に使える問いへ落としました。観点ごとの確認する指標と、当てはめにくい状況までまとめています。

企業のスポンサー協賛でITコミュニティを支援する効果と進め方

採用ブランディング・技術広報の文脈でITコミュニティを協賛する企業が増えています。京都651名・7年167回の運営から、効果・連携メニュー・進め方・失敗パターンを整理しました。

自治体がIT人材コミュニティと連携する方法 — 京都の地域実例から

京都府IT産業振興WG・大正大学京都アカデミア・京都知恵産業創造の森との連携実績から、自治体・地域団体がIT人材コミュニティと連携する形態・進め方・失敗パターンを整理しました。

コミュニティに参加する

京都でITエンジニア仲間を見つけたい方へ

「みやこでIT」では、京都のお寺・町家・大学などで、もくもく会や勉強会を毎月開催しています。

📊 Source data

本記事に登場する「7年・167回・651名」「お寺/町家会場での開催」等の数値は、 「みやこでIT」年次統計レポート(/community-stats) の一次データに基づきます。年別開催数・会場分布・イベント種別構成の集計を公開しています。

⛩️

LM-4無料配布資料

京都のお寺でコードを書く — 「みやこでIT」参加ガイドブック2026

7年167回運営の実績から整理した、初参加を成功させる実践ガイド

対象:京都のITエンジニア・転職検討者・勉強会初参加の個人

主催者が公開しているイベント告知画像(オンライン)申込受付中

12月4日(金)

書籍から得た学びは、意外と自分の中に定着しにくいものです。

開催時間20:00〜21:30
開催エリアオンライン