AGENT SKILL

pinocchio

Explains Pinocchio receipts (PASS / FAIL / CAN'T TELL) and how to configure claim checking. Use when a Pinocchio receipt or block appears, or the user asks about Pinocchio settings.

License 许可
MIT
所属仓库
STiFLeR7/pinocchio
最近更新
2026-10-26
Stars
★ 2
Forks
0

01 前言 Front Matter

name
pinocchio
description
Explains Pinocchio receipts (PASS / FAIL / CAN'T TELL) and how to configure claim checking. Use when a Pinocchio receipt or block appears, or the user asks about Pinocchio settings.

03 SKILL.md 正文

Pinocchio

Pinocchio checks completion claims at every stop against evidence you did not produce:

  • stale-tests: you said tests pass, but no test command ran after your last edit.
  • red-tests: the last test run after your last edit failed (exit code, failure summary, or a fresh JUnit report).
  • phantom-edit: you said you changed or fixed something, but no file changed.
  • tampering (warning only): deleted tests, new skip markers, or removed assertions.

Each receipt has one verdict:

  • PASS: the evidence supports every claim, or no claim was made.
  • FAIL: the evidence contradicts a claim (for example, no test ran after your last edit).
  • CAN'T TELL: Pinocchio could not confirm or refute a claim (for example, no recognized test command, no edits this session, or tests may have run in a subagent).

Modes (mode in the settings below):

  • default: block on FAIL only; CAN'T TELL is reported, not blocked.
  • report: never block; only show the receipt.
  • strict: block on FAIL and on CAN'T TELL.
  • off: do nothing.

At most maxBlocksPerSession blocks (default 2) happen in one session, then Pinocchio only reports.

When Pinocchio blocks you: do the missing step (usually run the tests), then report the actual result. Never restate a claim without new evidence.

Settings live in .claude/pinocchio.json: {"mode":"default|report|strict|off","testCommands":["^make verify$"],"claimPhrases":{"tests":["ci is green"]},"maxBlocksPerSession":2,"commitLedger":false}. PINOCCHIO=off disables it for one session. The ledger is .claude/pinocchio/ledger.jsonl.

04 同仓库更多 Skills