Echo-aloha/asphalt-codex-skills-5 / skills/pfc5-fish
pfc5-fish
VerifiedAuthor and audit PFC 5.0 FISH for asphalt cases, including def/end functions, globals and locals, callbacks, numbered histories, object traversal, command blocks, IO, and stop logic.
PFC5 FISH
Use this skill when a PFC 5.0 asphalt case needs FISH functions, callbacks, histories, traversal, IO, controllers, or stop conditions.
Required Inputs
- PFC2D/PFC3D 5.0 and target stage;
- object types and identifiers/groups;
- inputs, intended globals, outputs, callback timing, and stop rule;
- expected history/file schema and runtime probe.
Workflow
- Write the function contract before code: inputs, globals, return symbol, side effects.
- Prefer the documented PFC5
define name ... endspelling and explicit command blocks; acceptdefonly as a verified abbreviation in retained legacy sources. - Keep intentional globals few; initialize callback state before activation.
- Use numbered
history idoutputs and document each ID. - Guard object pointers and empty collections.
- Use either
whilestepping(automatic registration at-1.0) or an explicitset fish callback; prove the expected call count with a counter/history. - Inspect callback registrations after restore and remove/re-register only from evidence; one removal clears only one duplicate registration.
- Run
scripts/audit_pfc5_fish.py, then a minimal PFC5 runtime probe.
Read patterns.md for maintained skeletons.
Working Rules
- Do not mix syntax families in one block.
- Do not leave controller functions defined but never activated.
- Do not explicitly register a
whilesteppingfunction a second time unless double execution is intentional. - Do not put unwrapped PFC commands directly inside a FISH function.
- Inline evaluation belongs at command level, not inside FISH expressions.
- Static delimiter checks do not validate intrinsic names.
Output Contract
Return function/global/history/callback maps, source files, audit result, activation proof, and runtime-validation status.
Local Contents
references/patterns.md— PFC5 function/history/callback patterns.scripts/audit_pfc5_fish.py— syntax-family and block-balance audit.agents/openai.yaml— interface metadata.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |