情報の自動取得
情報メモの要約を手で埋めたら再一覧せよ—『全部埋めた』は再スキャン後だけ
セキュリティ等の情報メモで『要約作成中』を手埋めしたあと、開始時ローカル一覧だけで完了するな。pull→一覧→埋め→再一覧。rebase後も残件ゼロまで。
無料枠切れなどで、情報メモの要約が「要約作成中」のまま残ることがあります。手直しで全部埋めたつもりでも、公開面にプレースホルダが残ることがあります。原因は、開始時のローカル一覧だけ埋め、pull/rebaseのあとに残件を再スキャンしないことです。放置すると、完了宣言の直後に読者が「要約作成中」を見ます。さらに、指摘された1件だけ直して説明で止まり、手順・ルールへの是正を「プロセスを修正しろ」と言われるまで待つのが本丸です。読み終わると、完了判定と再発防止の置き場で合格/不合格を切れます。
この記事でわかること
- 開始時スナップショットだけで「全部やった」を不合格と判定できる
- pull→一覧→埋め→再一覧(
--fail)の完了条件を適用できる check:prepublishpassと未要約完了を取り違えない- 症状1件直しで止まらず、手順を残す
- 作業前にAIへ渡す入力(貼り付け文)がある
状況
典型は次です。
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に渡すだけでよい。
まとめ
- 起点は同期後の一覧(開始時ローカルだけではない)
- 埋め後・rebase後も再スキャンし、残0
- prepublish pass ≠ 未要約完了
- 症状1件直しで止まらず、手順を残す