菜单
Fires when plumbing is about to be written wrong instead of as the matching construct in python-wiring-success — a top-level def outside a route file or the composition root, or a class/private helper with no modeled entry claiming it.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Fires when a boundary crossing is about to be hand-rolled instead of built as the matching construct in python-adapters-success — a before-validator that indexes/renames/routes/computes on raw foreign data, a try/except catching Exception or ValidationError or running multiple statements in its except body, or .model_dump/.model_dump_json called anywhere but a route reply or client binding.
Build the three boundary-crossing constructs — foreign model, contract model, ordered union — the only shapes for data crossing in or out of the program. Fires before touching a foreign payload, file format, message, or client reply; before declaring an API surface or response shape; or before writing a try/except, error handler, retry, fallback, or None-check around foreign input.
Fires when live state or a transport client is about to land somewhere wrong instead of the matching construct in python-state-success — frozen=True on the consistency model, a client field with no verb emitting through it, or arbitrary_types_allowed=True on any model other than the consistency model.
Build the two live-node constructs — consistency model and binding — the only places mutable state and transport clients are allowed to converge. Fires before holding a socket, database, bus, or client; before declaring a mutable field; before writing a manager, an engine, or a second unfrozen model in a context; or before writing a connect/setup/wiring class.
Fires when domain data is about to be shaped wrong instead of as the matching construct in python-values-success — a bare primitive field, an unproven scalar or collection, a T | None absence, free-floating vocabulary, a drifted or unmodeled enum, an after-validator policing a relation the fields should reparameterize, a bare .root held mid-graph, an open (unfrozen or extra-allowing) model, a union alias built without a discriminator, a union wrapped in a class, or a field the ontology never declared.
Build the five proven shapes for domain data — semantic scalar, value object, concept model, collection, union. Fires before writing a bare primitive field, a dataclass/NamedTuple/TypedDict, a list/set/dict field, a T | None field, a raw Literal or bare StrEnum field, or a match/if-elif/isinstance ladder selecting by kind.
| name | python-wiring-failure |
| description | Fires when plumbing is about to be written wrong instead of as the matching construct in python-wiring-success — a top-level def outside a route file or the composition root, or a class/private helper with no modeled entry claiming it. |
Two ways plumbing escapes its licensed home (config, route, composition root — python-wiring-success).
A top-level def outside route and composition-root files is free-floating behavior. Behavior lives on models as derivations, or in the two file kinds that license module functions.
A fact you are about to compute in a function is a derivation that has not found its model yet: name it on the value whose fields imply it, and the procedure is gone, the work done by the construction the derivation returns. A standalone function computing from a model's fields is that derivation escaped from its owner.
The two licensed homes are the only ones:
main() that wires config, clients, bindings, the consistency model, and routes.Anywhere else, the meaning belongs on a model: a derivation for an implied fact, a verb for a state transition.
def normalize(x): ... # a derivation on the value whose fields imply the normalized fact
A class in a file no row claims is source the catalog is silent about. The ontology is the authority for what a file may hold; every class traces to a row that homes it there.
A class the code needs that no row claims is a meaning to place in the ontology, with its construct home, before it is written. A private helper carrying behavior is a derivation or verb that has not found its model.
class _Helper: ... # nothing in the catalog says this belongs here: place a row that homes the class, or its behavior is a derivation or verb on a model