AI開発
物件の売値を直しても、一覧の仮値が履歴に残ると大暴落に見える
不動産クロールで詳細の売値だけ直して履歴先頭の仮値を据え置くと、変動率が嘘の値下がりになる。現行を直すパッチは履歴も整合させる。
不動産の出物をサイトから集めるとき、一覧ページの仮の売値と、詳細ページの確定売値がずれることがあります。詳細を取り直して「いまの売値」だけ直すと、画面上の値下がり率（変動率）が −60% や −80% のように見えることがあります。式は合っていても、履歴の最初の点が一覧の仮値のまま残っているのが原因です。この記事は、その型を止めるための判断基準と、作業前にAIへ渡す入力です。
この記事でわかること
- 変動率が嘘をつくときの切り分け（式より履歴の初回）
- 一覧の仮値と詳細の確定値を混ぜない理由
- 現行売値を直すパッチが履歴も直すべき理由
- 修復後に集計と配信経路まで揃える理由
- 作業前にAIへ渡す入力
状況
典型は次です。
1.不動産ポータルなどから出物を日次でクロールする 2.一覧では売値だけ取れ、詳細にしか無い項目は後回し（仮の点）になる 3.その仮売値が、値動き履歴の「最初の記録」に入る 4.あとから詳細を取り直し、いま表示している売値だけ正しい金額に直す 5.履歴の先頭は仮値のまま。画面は「初回からの値下がり率」を出し、大暴落に見える
利用者から見ると実売の暴落に見えます。エージェントから見ると「価格は直した」ので気づきにくいです。
失敗1 — 異常な変動率を式のバグだと思う
悪い例
- 「÷ 初回売値」の式だけ疑い、履歴先頭の出所を見ない
- 同じ仮売値が別物件に共有されているのに、「みんな値下がりした」と誤認する
- 表示のパーセント表記や四捨五入だけをいじる
良い例
- 異常な変動率の初動は、履歴の最初の点と、いまの売値の出所を見る（一覧／詳細／あとからの再取得）
- 式が合っていても、分母がゴミなら結果は嘘になる、と先に疑う
合格条件
変動率がおかしいと報告されたとき、式の修正より先に「初回点は一覧の仮値か／詳細の確定値か」を答えられること。
失敗2 — いまの売値だけ直して履歴を据え置く
悪い例
- 詳細の再取得や一括直しで、現行の売値フィールドだけ更新する
- 履歴配列は「以前のまま残す」と明示的にコピーして据え置く
- その後の日次は現行＝確定値のままなので、履歴とのズレが永久に残る
良い例
- 現行の売値を直す変更は、履歴も同じターンで整合させる（据え置き禁止）
- 一覧だけの仮点（売値だけで、詳細で分かる項目が欠けている等）が現行と食い違うなら、誤った初回として落とす。本物の値下がりと混ぜない
合格条件
現行売値を書き換えるパッチ・再取得の完了条件に、「履歴先頭と現行が矛盾しない」が入っていること。
失敗3 — 画面用の差分と、分析用の履歴正本を混ぜる
悪い例
- 「更新日」（元サイトが言う情報の更新）と、「値動き履歴」（自前クロールで売値が変わった記録）を同じ意味で扱う
- 元サイトに更新日が無いのに、クロールした日を更新日列に埋める
- 変動率を、更新日の無い行にも出して意味をぼかす
良い例
- 列の意味を一文で分ける。更新日はソース側、値動きは自前履歴
- 画面の前回差・初回差・変動率は履歴から都度計算してよい。分析用の履歴正本は保存用データ（最新の物件レコード）に残す
合格条件
「更新日」「値下がり率」「履歴の初回」が、文書上一文ずつ別物として説明できること。
失敗4 — ローカルで直して配信経路を忘れる
悪い例
- 手元で保存用データや集計JSONだけ直し、「画面用データは直った」と言う
- 翌朝、日次バッチが古いロジックのまま集計を上書きして、嘘の変動率が戻る
- Webの画面デプロイだけして、集計を書くバッチ側をデプロイしない
良い例
- 修復の完了は、データ修正 → 集計の再生成 → 集計を書く実行系のデプロイまで含める
- 「データが無い」と思ったら、最後に集計を書いた実行のコード版も疑う（画面に出ない系と同型）
合格条件
履歴を直した作業の完了宣言の前に、翌朝の自動更新で戻らない経路になっていること。
作業前にAIへ渡す入力
人間向けの長い手順は書きません。次はすべて、作業前に AIに読ませる／貼る文 です。
AI向け：永続ルール（rules / AGENTS.md）
不動産など出物の売値・値動き履歴・一覧／詳細クロールを触るとき:
1. 異常な値下がり率・変動率は、式より履歴の初回点の出所（一覧の仮値か詳細の確定値か）を先に疑え
2. 現行売値を直すパッチ・再取得は履歴も同じターンで整合させよ。履歴据え置き禁止
3. 一覧だけの仮点で現行と食い違うものは誤初回として落とせ。本物の値下がりと混ぜるな
4. 「更新日」（ソース）と「値動き履歴」（自前クロール）を同一視するな。画面列の意味を一文で分けよ
5. 修復の完了はデータ修正＋集計再生成＋集計を書く実行系のデプロイまで。手元の JSON だけ直して終わるな
最初の返信はコード差分ではなく、初回点の出所・履歴整合の要否・配信経路の完了条件を書け。AI向け：この作業の開始時にチャットへ貼る文
次の作業に入る前に、売値フィールドだけ直す実装はするな。
変動率がおかしいなら、履歴の初回点の出所（一覧仮値／詳細確定／再取得）を先に示せ。
現行を直すなら履歴整合の手順と、翌朝の自動更新で戻らない完了条件を書け。履歴の据え置きは禁止。人間向け
なし。上をAIに渡すだけでよい。
まとめ
物件の売値を「いま」だけ直しても、一覧の仮値が履歴の初回に残っていれば、変動率は嘘の大暴落になります。式より初回点、現行と履歴の同時整合、更新日と値動きの切り分け、配信経路までの完了が合格です。作業前にAIへ渡す入力として残さない限り、同じ型は再発します。