Configures Claude Code hooks and Codex hooks.json/notify. Use when adding PreToolUse guards, Stop hooks, managed hooks, format-on-save, preflight, audits, or worktree/budget hooks.
日本語の概要は準備中です。原文の説明を表示しています。
Chooses under uncertainty: value of more data, cost-based thresholds, abstention, when to stop a test and ship, robust choice. Use when deciding, not estimating.
インストールする前に、エージェントに与えられる指示の中身を確認できます。
Apply when:
Skip and use something else when:
Primitive index — the only one in this skill; each playbook has the definition, inputs, failure modes, and a worked example.
| # | Primitive | Reach for it when |
|---|---|---|
| 1 | Expected Utility | Ranking risky options with known or estimable probabilities |
| 2 | Bayesian Decision | Evidence has arrived and the action should update; posterior expected loss |
| 3 | Minimax Regret | Probabilities unknown or contested; robustness check on a weak prior |
| 4 | Value of Information | Deciding whether a study, pilot, spike, call, or question is worth buying |
| 5 | Multi-Criteria Decision Analysis | Incommensurable criteria; weights must be disclosed and stress-tested |
| 6 | Risk Aversion | Variance or downside matters beyond the mean; certainty equivalent |
| 7 | Real Options | Irreversible commitment while uncertainty will resolve; defer/expand/abandon |
| 8 | Prospect Theory | Normative-vs-descriptive boundary only; behavioral detail lives in behavioral-economics |
| 9 | Ellsberg and Allais | Ambiguity or certainty effects make EU inputs unreliable |
| 10 | Multi-Armed Bandit | Reward collected during learning matters (regret objective) |
| 11 | Stochastic Dominance | Utility-free ranking of known outcome distributions |
| — | Thresholds, stopping, and OPE | Cost-based thresholds, abstention, best-arm identification, expected-loss stopping, off-policy evaluation |
| Misuse | Why it is wrong | Correction |
|---|---|---|
| Optimising expected value for a risk-averse or ruin-exposed decision maker | EV ignores utility curvature and absorbing losses | Expected utility and certainty equivalent (#6); ruin constraints (below) |
| Approving a study because EVPI exceeds its cost | EVPI is only an upper bound for a perfect reveal; real signals are noisy | Approve on EVSI of the specific design vs utility-compatible cost; EVPI < cost only excludes |
| Treating MCDA weights as objective, or skipping rank-reversal tests | Weights encode preferences. In one audit of 27 published MCDM pipeline/dataset combinations, recomposition consistency (RRT3) failed in about 48% and transitivity (RRT2) in about 15% | Disclose weights, run sensitivity, and run the Wang–Triantaphyllou RRT1–RRT3 tests (Cabral et al., arXiv:2508.00129) |
| Applying EU under deep ambiguity | Unknown probabilities break the input contract | Minimax regret, maximin, or ambiguity-aware criteria (#3, #9) |
| Using a bandit when you need an unbiased effect size | Adaptive allocation biases naive per-arm estimates; it fits badly with delayed, long-horizon, or guardrail metrics | Fixed-allocation randomised test; use bandits when in-experiment reward dominates (OPE ref §3) |
| Stopping on "P(best) > 0.99" | Ignores magnitude: it can hold forever on ties or clear on trivial gaps | Expected loss below a pre-declared threshold of caring (§4) |
| Reallocating on stochastic dominance of sample rewards | FSD of observed outcomes says nothing about posterior uncertainty in the mean; FSD is univariate | Scalarise quality and cost into one declared utility, then use expected loss |
| Thresholding an uncalibrated score, or a calibrated one after a prevalence shift | The Bayes threshold assumes calibrated probabilities at the deployment base rate | Calibrate, adjust for prevalence, then use c_FP/(c_FP+c_FN) (§1) |
| Sunk-cost continuation | Past spend is irrelevant to the forward decision | Price the option to abandon (#7) |
| Comparing only means | Tails and dominance can reverse the choice | Stochastic dominance (#11) and downside risk (#6) |
| Treating a positive-EV recurring business (rake, spread, underwriting) as ergodic | The operator lives one path; correlated exposures collapse into a single joint loss | Bound the worst joint loss against capital |
More traps and pattern stacks: references/patterns-scenarios-traps.md.
EU ranks lotteries from stated probabilities and a utility function. It misleads in practice when a one-period payoff model is reused for a repeated, multiplicative, path-dependent, or ruin-constrained process. There, the arithmetic expected return can be positive while long-run log growth is negative (Peters 2019).
Most failures are in the inputs, not the arithmetic.
| Trap | Correction |
|---|---|
| Anchoring on the first number stated | Elicit independently before discussion (Delphi-style), then aggregate |
| False-precision point estimates | Elicit ranges or 10/50/90 percentiles; calibration-train for high stakes |
| Analysis paralysis | Compute EVPI/EVSI (#4) before approving more elicitation or study |
| Weights presented as model output | Treat MCDA weights as negotiated inputs; disclose provenance |
| Stated vs revealed risk tolerance | Cross-check elicited risk parameters (#6) against past real-stakes choices |
| Ambiguity flattened into 50/50 | Run the Ellsberg/Allais diagnostic (#9) first |
Score an LLM forecaster like any panel member:
All VoI cost gates assume utility-compatible additive costs. Otherwise, put costs and delay into terminal outcomes and recompute expected utility (practical contract).
Worked example. An outside action is worth 0. A risky action pays +1 or −1 with equal probability. Perfect information is worth 0.5. A symmetric signal that is right 75% of the time gives posterior means of ±0.5, so EVSI = 0.25. Run it only if it costs less than 0.25. A percentage reduction in posterior variance is not a percentage of EVPI. For small finite problems, use the calculator.
Calibrate the score and adjust it to the deployment prevalence. Derive p* = c_FP/(c_FP+c_FN). Add a deferral band where the review cost is below both error costs (Chow's rule), and report risk and coverage across a range of cost ratios (§1–2).
Sun (arXiv:2604.00414, §2–3) supports separating decision context, policy, and execution. Its contribution is architectural; cite Heath & Baio (arXiv:1709.02319, §2) for the EVSI calculation rather than treating Sun as a tested VoI policy.
data/finite-state-decision-fixtures.json and run python3 scripts/decision_calculator.py model.json (see the contract). Verify the calculator with python3 scripts/test_decision_calculator.py (tests).Cross-link only to other foundations when a task needs joint coverage: game-theory (strategic agents), causal-inference (identification, propensity logic shared with OPE), statistical-inference (calibration, anytime-valid inference after adaptive allocation), behavioral-economics (descriptive choice, loss-aversion estimates), measurement-theory (score validity).
When prior decisions or pitfalls are relevant, consult learnings.consolidated.md if present; use learnings.md only for needed history or as the available fallback. Otherwise skip both.
After applying it, if you encountered a pattern worth remembering, a mistake worth preventing, or a domain fact that surprised you, append one dated bullet to learnings.md via agents-skills-feedback-loop/scripts/append_learning.py. Do not modify SKILL.md itself.
まだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
Configures Claude Code hooks and Codex hooks.json/notify. Use when adding PreToolUse guards, Stop hooks, managed hooks, format-on-save, preflight, audits, or worktree/budget hooks.
日本語の概要は準備中です。原文の説明を表示しています。
Configures and hardens Claude Code and Codex MCP servers. Use when connecting databases, APIs, SaaS, building servers, or serving a clearance-filtered knowledge base.
日本語の概要は準備中です。原文の説明を表示しています。
Owns instruction files: AGENTS.md, CLAUDE.md, personal and repo rules. Use when writing, pruning, auditing them, sharing rules across Claude and Codex, or fixing ignored rules.
日本語の概要は準備中です。原文の説明を表示しています。
Creates and audits agent skills: SKILL.md, references, scripts, runtime metadata. Use when writing, validating, or security-reviewing a skill, or fixing truncated skill listings.
日本語の概要は準備中です。原文の説明を表示しています。
Adds per-skill learnings loops for dated patterns, mistakes, and domain facts. Use when wiring skill memory, consolidation, or drift audits.
日本語の概要は準備中です。原文の説明を表示しています。
Chooses subagent, team, workflow, or debate and launches it on Claude Code or Codex. Use when delegating, running agent review boards, or installing shared agents.
日本語の概要は準備中です。原文の説明を表示しています。