情報の自動取得

情報メモの要約を手で埋めたら再一覧せよ—『全部埋めた』は再スキャン後だけ

セキュリティ等の情報メモで『要約作成中』を手埋めしたあと、開始時ローカル一覧だけで完了するな。pull→一覧→埋め→再一覧。rebase後も残件ゼロまで。

無料枠切れなどで、情報メモの要約が「要約作成中」のまま残ることがあります。手直しで全部埋めたつもりでも、公開面にプレースホルダが残ることがあります。原因は、開始時のローカル一覧だけ埋め、pull/rebaseのあとに残件を再スキャンしないことです。放置すると、完了宣言の直後に読者が「要約作成中」を見ます。さらに、指摘された1件だけ直して説明で止まり、手順・ルールへの是正を「プロセスを修正しろ」と言われるまで待つのが本丸です。読み終わると、完了判定と再発防止の置き場で合格/不合格を切れます。

この記事でわかること

状況

典型は次です。

1.定時取り込みが要約枠を使い切り、一部が保留プレースホルダのままpushされる 2.チャットで「未要約を埋めて」と依頼される 3.作業開始時のローカル一覧(例: 22件)だけ埋めて完了宣言・push 4.そのあいだにremoteの定時が新しい「要約作成中」を足している 5. rebaseで乗り、競合は直すが、残プレースホルダの再grepなしでpush 6.公開面に「要約作成中」が残る。1件直して説明して終わる 7.「プロセスを修正しろ」と言われてから、一覧コマンドとrulesを書く

表層は見逃しです。本丸は、同型再発防止を自発で残さないことです。

失敗1:開始時一覧だけで完了する

状況: 手直し開始時点のローカル残件だけを埋めて「全部やった」と言う。

悪い例: pull前の22件だけ。remoteの新規保留を知らないままpush。

良い例: 先にpull(またはfetch+最新main)。その後の一覧を起点にする。

合格条件: 作業の起点は、同期後の残件一覧である。

失敗2:埋め後・rebase後に再スキャンしない

状況: 一通り埋めたあと、またはrebase/競合解消のあと、残件スキャンなしで完了・pushする。

悪い例: 競合4件は直した。残「要約作成中」は見ていない。

良い例: 埋めのあと、およびrebase/push宣言の前に、残件一覧を再実行する。残があればexit非ゼロになるモードで0件になるまで続ける。

合格条件: 埋め後とsync後の両方で、残件ゼロを機械が確認している。

失敗3:prepublish passを未要約完了とみなす

状況: 公開品質の機械チェックが通ったので、未要約も終わったと考える。

悪い例: passを根拠に「全部埋めた」。保留プレースホルダはゲート対象外のまま。

良い例: 機械チェックと未要約残件チェックを切り分ける。未要約の完了は残件一覧(failモード)だけ。

合格条件: prepublish pass ≠ 未要約完了、と文書化されている。

失敗4:「プロセスを修正しろ」まで待つ

状況: 公開面の1件を直し、時系列を説明して止まる。一覧コマンド・rules・opsへの是正は、明示指示があるまで書かない。

悪い例: 「rebase後見なかった」で終了。原因は認めたが再発防止の置き場が無い。

良い例: 原因が手順抜けと分かった時点で、聞かれる前に一覧手段・必達ルール・運用文に残す。症状1件とプロセス是正を同ターンで出す。

合格条件: 同型の完了判定欠陥として、手順がrules/ops/コマンドに残っている。「プロセスを修正しろ」を待たない。

合格条件(一覧)

1.手直しは 同期後の一覧 を起点にする 2.埋め後と rebase/push前 に残件スキャンし、failモードで0 3.公開面に「要約作成中」が出たら、同型の完了判定欠陥として手順を直す 4. check:prepublish と未要約残件チェックを混ぜない 5.原因が手順抜けなら、聞かれる前に再発防止を残す

是正が出たとき

1.指摘された件を埋める(表層) 2.同期→一覧→埋め→再一覧の手順を必達にする 3.残件ゼロを機械が落とせるようにする(failモード) 4. rules/運用文に同じ必達を書く 5.「1件直した」だけで完了と言わない

作業前にAIへ渡す入力

人間向けの長い手順は書きません。次はすべて、作業前に AIに読ませる/貼る文 です。

AI向け:永続ルール(rules / AGENTS.md)

未要約手直しは、先に pull(または最新 main)してから残件一覧を出せ。開始時ローカルだけで埋めるな。
埋めたあと、および rebase/push 前に、残件一覧を再実行せよ。fail モードで 0 件になるまで完了と言うな。
check:prepublish pass を未要約完了とみなすな。
公開面に要約作成中が残ったら、1件埋めだけで終わらず、同型の完了判定手順を rules/ops/コマンドに残せ。「プロセスを修正しろ」を待つな。

AI向け:この作業の開始時にチャットへ貼る文

未要約を埋める。先に同期し、残件一覧を出してから埋めよ。埋め後と push 前に再一覧し、残 0 になるまで完了と言うな。prepublish pass だけで完了にするな。残件や手順欠陥があれば、是正の置き場(コマンド・rules)まで同ターンで報告せよ。

人間向け

なし。上をAIに渡すだけでよい。

まとめ

参考リンク