Skip to content
Skills Library
Programming · Review & audit

verification

/verification

作業の完了を宣言する前に使用。証拠なき完了宣言を防ぐ規律スキル。

Licence
MIT
Last repository change
07.09.2026

Assessment and security

92/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability17 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 07.09.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

作業の完了を宣言する前に使用。証拠なき完了宣言を防ぐ規律スキル。

Original author description

作業の完了を宣言する前に使用。証拠なき完了宣言を防ぐ規律スキル。

How it works

  1. The Iron Law
  2. The Gate
  3. ユーザー観測の層 — 実機確認待ちで止まる
  4. 捏造 — 検証不足の極限形
  5. よくある検証不足
  6. Red Flags - 止まる合図
  7. いつ適用するか
Original SKILL.md headings · 77 lines, 206 words
SKILL.md preview
---
name: verification
description: 作業の完了を宣言する前に使用。証拠なき完了宣言を防ぐ規律スキル。
version: 1.3.0
tags: [discipline, verification, completion, evidence, fabrication]
---

# Verification Before Completion

> **証拠のない完了宣言は、効率化ではなく不誠実である。**

**Core principle:** 主張の前に証拠。常に。

## The Iron Law

```
検証の証拠なしに完了を宣言しない
```

「通った」と書けるのは、同じセッション内で実際に観測した tool_result を指させるときだけ。前ターンの観測を recap で再掲するのは構わない。観測していない結果を書くのが失敗。

## The Gate

状態の主張や満足の表明の前に: 何のコマンドでこの主張を証明できるかを特定し、そのコマンドをフレッシュに完全に実行し、出力全体を読んで終了コードと失敗数を確認する。出力が主張を裏付けていれば証拠付きで主張し、裏付けていなければ実際の状態を証拠付きで報告する。

## ユーザー観測の層 — 実機確認待ちで止まる

agent 環境の green だけでは閉じない変更がある — 実機のデバイス挙動、実 UI の見た目、実環境のログ。
この種の変更は「完了」を宣言せず、**「実機確認待ち」で止める**。ユーザーの観測(ログの実物・スクショ・「点いた / 鳴った」)が最終検証であり、その結果が次の裁定になる。agent のテストが green であることと、実機で正しく動くことは別の主張。

## 捏造 — 検証不足の極限形

検証を「飛ばす」より重い失敗がある。**検証結果そのものをでっち上げる**ことだ。
ツールを実行せずに `test result: ok` `all checks passed` と地の文に書く。呼んでいない
第二意見の返答を書く。予測した出力を、観測した事実として混ぜる。これは怠慢でなく捏造。

**最も危険な組み合わせ = 実装は本物・検証は捏造。** 実装が本物なら大半は動くので、偽の
「検証済み」ラベルは誰も疑わない。実装が間違った稀な一回 — まさに検証が必要だった唯一の
場面 — でだけ静かに壊れる。普段は完璧に隠れ、最悪のタイミングでだけ牙をむく。

**なぜ起きるか:**
- ツール出力は定型。「次のトークン」を高確信で予測でき、それが事実の顔で出力に混ざる。
  生成と報告が同じ回路を通る(直せる「癖」でなくアーキテクチャ上の性質)。
- 「緑でship」の完成像が強いと、確認前に「緑」を既成事実として書く。願望が観測を上書き。
- 自問による自制は、自問する主体自身が汚染されているとき作動しない。意志は脆い。

**規律:**
- ツール結果は system が返すテキストだけ。自分で `test result:` 等を書かない。
- 「緑/通った/merged」と書く直前に、直近の**本物の tool_result 行を指させるか**を自問。
  指させないなら書かない(mito の言葉で「指差し確認」)。
- 捏造しにくい形で取り直す: 行数(`wc -l`)、git hash、exit code、API の state。

**構造(意志の外側):** 意志は失敗の瞬間には作動しない。だから外側に関門を置く。Stop hook
`fabrication-tripwire.sh`(本 plugin の `hooks/hooks.json`)が、ターン終了時に**最終 assistant
メッセージ**の「ツール出力の形をした文字列」を検出し、同じセッション内の本物の tool_result に
裏付けが無ければ差し戻す。fail-open(壊れても全ターンを止めない)。意図的な引用だけ明示トークン
`TRIPWIRE-ACK` を**単独行**で置いて通す(文中の言及では解除されない。bypass は transcript に
残る=監査可能)。非決定性の飛躍は殺さず、「観測していない結果を報告する」その一点だけを外から止める。

## よくある検証不足

| 主張 | 必要な証拠 | 不十分なもの |
|------|-----------|------------|
| テスト通過 | テストコマンド出力: 0 failures | 前回の結果、「通るはず」 |
| リンター通過 | リンター出力: 0 errors | 部分チェック、推測 |
| ビルド成功 | ビルドコマンド: exit 0 | リンター通過、ログが良さそう |
| バグ修正 | 元の症状テスト: 通過 | コード変えた、直ったはず |
| 要件充足 | 項目ごとのチェックリスト | テスト通過(=要件充足ではない) |
| 設計に触れた変更 | design が同じ PR にある(Status log / やってはいけない に追記) | 「後で docs を直す」 |

## Red Flags - 止まる合図

- 完了宣言の中で「〜はず」「たぶん」「〜と思われる」を使っている(検証できていないことは、完了とは別に最初に言う)
- 検証前に満足を表明している(「完了!」「よし!」)
- コミット / PR / タスク完了の前に検証していない
- 部分的な検証で済ませている

## いつ適用するか

完了・成功を含む主張、コミット、PR 作成、タスク完了、次のタスクへの移行の前。

コマンドを実行する。出力を読む。**それから**結果を主張する。

Versions

RepositoryScoreLicence
This page · chronista-club/claude-plugin-chronista-style92MIT
aws-solutions/konductor100Apache-2.0
YuDefine/nuxt-supabase-starter100MIT
assafkip/huntkit100MIT
vercel/vercel-plugin100Apache-2.0
romiluz13/cc10x100MIT
CooCoode/pi-skills100MIT
Aurite-ai/agent-verifier100MIT
fusengine/agents100MIT

Database snapshot: 13.11.2026 · package version ca89ead29aca (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100verification-before-completion
    Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always
  • 90clade-verification
    Verification, testing, review, screenshots, and evidence rules. Use when testing, reviewing, debugging, collecting evidence, or claiming completion.
  • 96skill-verification-gate
    Use when about to declare work complete, fixed, passing, or done
  • 100gate
    Verification before completion claims. Use when about to say "done", "fixed", or "complete". Runs checklist by workflow type with evidence requirements.
  • 81design-verification
    Use when a built page must be proven to match a design, not merely to compile.
  • 100verification-loop
    A comprehensive verification system for Claude Code sessions. Use when verifying a Claude Code session's work before claiming it is complete.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.