메뉴
Audit pyjinhx public API surface—pyjinhx.__all__, top-level exports vs canonical implementations, docs/reference/public-api.md alignment, tests/36_public_api_test.py. Use before releases, after refactors, or when removing deprecated symbols. Read-only.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Audit pyjinhx for dead code—removed API ghosts in code/docs/tests, symbols with no callers, obsolete backward-compat paths, unused parameters, and tests for deleted behavior. Use after refactors, API removals, or when the user asks to "sweep for dead code", "find unused code", or "remove leftovers". Read-only report.
Orchestrate a full structural code audit of pyjinhx using eight focused lenses (file responsibility, module placement, domain entities, state shape, duplication, indirection, public API, dead code). Use when the user asks to "audit the codebase", "sweep for quality", "review architecture", "audit reactive/", or before a large PR merge. Produces a merged read-only report; remediation is a separate pass unless requested.
Audit whether classes and module names match domain concepts—entities vs algorithms, ABC vs hub vs value object, procedural filenames vs type names. Use when naming new types, reviewing package structure, or asking "what should this be called". Read-only report.
Audit where mutable state lives in Python modules—module globals and ContextVars vs class classmethods, pure functions vs hubs, ABC vs coordinator split. Use when reviewing singletons, request scope, caches, or "should this be a class". Read-only.
Audit for duplicated workflows and parallel call sequences that will drift—same orchestration in two modules, duplicate parsing/validation, identical decorator and context-manager bodies. Use when reviewing refactors, merge conflicts, or "keep these in sync" code. Read-only report; documents intentional asymmetry.
Audit Python files for single responsibility—oversized modules, mixed concerns (parsing + algorithm + runtime in one file), misleading filenames, empty package __init__ without module maps. Use when a file feels crowded or before splitting a module. Read-only report.
| name | public-api-audit |
| description | Audit pyjinhx public API surface—pyjinhx.__all__, top-level exports vs canonical implementations, docs/reference/public-api.md alignment, tests/36_public_api_test.py. Use before releases, after refactors, or when removing deprecated symbols. Read-only. |
| disable-model-invocation | true |
I own: pyjinhx/__init__.py __all__, docs index vs exports, public-api test alignment.
I don't own: internal wrapper removal (→ indirection-audit), where impl files live (→ module-placement-audit), zero-caller symbols (→ dead-code-audit).
Read: CONVENTIONS.md.
__all__ name points at one canonical implementation (no alias assignment in __init__.py).docs/reference/public-api.mddocs/api/*.mdREADME.md examples (or updated to canonical names)integrations/:
from pyjinhx.integrations.fastapi import FastAPIClientBackend in __init__.py ✓LoadCache.invalidate, MountedManifest.parse, MutationTracker.recordimport pyjinhx; set(pyjinhx.__all__) == set(dir intended)mutation_scope, dirty_keys, get_load_context, fastapi_client_backend, top-level invalidate, etc.)PjxKey, TriggerManifest, PJX_TRIGGER_HEADER)tests/36_public_api_test.py imports match __all__PjxContext.current, not get_load_context)python -c "import pyjinhx; print(sorted(pyjinhx.__all__))"
rg 'mutation_scope|dirty_keys|get_load_context|load_scope|fastapi_client_backend|data-pjx-key|dirtied=|mounted=|parse_loaded_assets|client_has_mounted_manifest|set_invalidation_backend|get_load_cache_scope' docs/ README.md
Compare docs/reference/public-api.md table to pyjinhx.__all__.
Use CONVENTIONS template. Severity: P1 for docs exporting removed APIs; P2 for __all__/test drift; P3 for example snippets.