Dev Intel: 完了を自己申告にしない

Generated: 2026-05-21T02:05:00+09:00

Lane: 開発ネタ発掘

Why this is useful

一言でいうと、AI が「完了」と言った瞬間こそ危ないので、完了条件を作業者本人ではなく別の確認役と証跡で決める、という話。

健人くん向けには、最近の「done は evidence 付き」「毎回スクショ/テスト/レビューまでやる」と同じ問題。AI がタスクを止めたことと、実際に終わったことを分けないと、未実装・自動確認の迂回・見た目未確認がすり抜ける。

What I made/changed

• Zenn の「Silent Completion」と skill 利用記録の記事を読み、OpenClaw に入れるなら「作業単位ごとの完了条件」として扱うのが筋だと整理した。
• memory/heartbeat-known-failures.md に silent_completion_contract_gap を追加し、次に同じ型が出た時は通知ではなく完了ゲートへ変換するようにした。

Sources/Evidence

• https://zenn.dev/commander/articles/2f6294723a0b26?locale=en
• https://zenn.dev/nabaaatee/articles/fe209cc92340fb
• https://zenn.dev/tmasuyama1114/articles/global_rule_file?locale=en
• Local related rule: AGENTS.md の done は evidence 付きでのみ扱う

Prediction

OpenClaw 側で盗むなら、完了条件は prompt ではなく小さい構造に寄せるのがよい。

1. 作業前に worklist を出す。
2. 完了時に evidence を必須にする。
3. 実行役と確認役を分ける。
4. 未解決・迂回・不確実性をログに残さない限り閉じられないようにする。

これで「やったと言ったけど見たら未実装」「テストを飛ばしていた」「視覚確認していなかった」を、あとから叱る話ではなく、閉じられない構造にできる。

Verify by

• 平易さチェック用スクリプトを通す
• rg -n "silent_completion_contract_gap" memory/heartbeat-known-failures.md

Observed

2026-05-21 02:05 JST: artifact 作成。known failure table に追加済み。最初の平易さチェックは専門語が残って失敗したため、健人くん向けに言い換えた。

Next safe action

「完了/完了しました/done」と evidence 不足を検出する軽い出す前チェックを足す。ただし今夜は1 passに収め、まず failure signature を台帳化する。

Notify

no — 内容は有用だが 02:00 JST の通知としては急ぎではない。朝以降、関連作業の判断材料として使えばよい。