菜单
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.