Skip to content

foryourhealth111-pixel/Vibe-Skills

Vibe Code Orchestrator (VCO) is a governed runtime entry that freezes requirements, bounds execution, and enforces verification and phase cleanup.

FileKindSize
SKILL.mdskill md17.2 KB
agents/templates/debugger.mdmarkdown323 B
agents/templates/planner.mdmarkdown313 B
agents/templates/reviewer.mdmarkdown331 B
agents/templates/security-reviewer.mdmarkdown341 B
references/change-proof-matrix.mdmarkdown2.6 KB
references/contributor-zone-decision-table.mdmarkdown2.2 KB
references/developer-entry-contract.mdmarkdown2.7 KB
references/fixtures/external-corpus/external-corpus-gate.jsonconfig8.6 KB
references/fixtures/external-corpus/prompt-signals.jsonconfig412.4 KB
references/fixtures/external-corpus/skill-keyword-index.backup.jsonconfig30.6 KB
references/fixtures/external-corpus/skill-keyword-index.candidate.jsonconfig26.5 KB
references/fixtures/external-corpus/vco-suggestions.jsonconfig16.6 KB
references/fixtures/migration-map.jsonconfig7.8 KB
references/fixtures/retro-compare/safety-gate/baseline-cer.jsonconfig294 B
references/fixtures/retro-compare/safety-gate/current-cer.jsonconfig1.1 KB
references/fixtures/retro-compare/safety-gate/delta.jsonconfig1.0 KB
references/fixtures/retro-compare/sample-run/baseline-cer.jsonconfig324 B
references/fixtures/retro-compare/sample-run/current-cer.jsonconfig1.2 KB
references/fixtures/retro-compare/sample-run/delta.jsonconfig1.0 KB
references/fixtures/retro-compare/smoke/baseline-smoke.jsonconfig266 B
references/fixtures/retro-compare/smoke/current-smoke.jsonconfig1.0 KB
references/fixtures/retro-compare/smoke/delta-smoke.jsonconfig1.0 KB
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/cleanup-receipt.jsonconfig1.3 KB
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/governance-capsule.jsonconfig408 B
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/intent-contract.jsonconfig2.2 KB
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/phase-plan-execute.jsonconfig2.4 KB
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/skeleton-receipt.jsonconfig722 B
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/stage-lineage.jsonconfig1.3 KB
references/fixtures/skills-audit/bio-science-problem/bio-science-problem-map.csvother9.2 KB
references/fixtures/skills-audit/bio-science-problem/bio-science-problem-map.jsonconfig18.1 KB
references/fixtures/verify/routing-stability/vibe-routing-stability-gate.jsonconfig24.4 KB
references/index.mdmarkdown1.3 KB
references/proof-bundles/claude-code-managed-closure-candidate/linux-managed-run-01-local-host/installed-runtime-outputs/runtime-freshness-receipt.jsonconfig262 B
references/proof-bundles/claude-code-managed-closure-candidate/manifest.jsonconfig2.6 KB
references/proof-bundles/linux-full-authoritative-candidate/linux-pwsh-run-01-wsl/installed-runtime-outputs/runtime-freshness-receipt.jsonconfig298 B
references/proof-bundles/linux-full-authoritative-candidate/linux-pwsh-run-02-docker/installed-runtime-outputs/runtime-freshness-receipt.jsonconfig298 B
references/proof-bundles/linux-full-authoritative-candidate/manifest.jsonconfig3.3 KB
references/proof-bundles/openclaw-runtime-core-preview-candidate/manifest.jsonconfig1.9 KB
references/release-ledger.jsonlother5.1 KB
scripts/README.mdmarkdown1.7 KB
scripts/bootstrap/one-shot-setup.ps1script797 B
scripts/bootstrap/one-shot-setup.shscript482 B
scripts/bootstrap/scaffold-claude-preview.ps1script875 B
scripts/bootstrap/scaffold-claude-preview.shexecutablescript866 B
scripts/bootstrap/sync-local-compat.ps1script2.6 KB
scripts/common/AntiProxyGoalDrift.ps1script15.1 KB
scripts/common/NodeLaunchWrapper.ps1script13.1 KB
scripts/common/ProcessLedger.ps1script27.1 KB
scripts/common/ProtectedDocumentCleanup.ps1script6.9 KB
scripts/common/README.mdmarkdown1.9 KB
scripts/common/Resolve-VgoAdapter.ps1script4.3 KB
scripts/common/adapter_registry_query.pyexecutablescript3.8 KB
scripts/common/python_helpers.shscript2.8 KB
scripts/common/resolve_vgo_adapter.pyexecutablescript2.4 KB
scripts/common/runtime_contracts.pyscript3.7 KB
scripts/common/vibe-governance-helpers.ps1script75.6 KB
scripts/common/vibe-wave-gate-runner.ps1script28.3 KB
scripts/governance/Invoke-NodeProcessAudit.ps1script3.6 KB
scripts/governance/Invoke-NodeZombieCleanup.ps1script3.7 KB
scripts/governance/README.mdmarkdown5.1 KB
scripts/governance/audit-upstream.ps1script22.7 KB
scripts/governance/export-repo-cleanliness-inventory.ps1script8.6 KB
scripts/governance/install-local-worktree-excludes.ps1script2.0 KB
scripts/governance/invoke-mem0-policy.ps1script1.0 KB
scripts/governance/invoke-openspec-governance.ps1script8.6 KB
scripts/governance/new-origin-record.ps1script3.3 KB
scripts/governance/phase-end-cleanup.ps1script10.7 KB
scripts/governance/publish-absorption-soft-rollout.ps1script3.2 KB
scripts/governance/publish-openspec-soft-rollout.ps1script9.3 KB
scripts/governance/release-cut.ps1script25.1 KB
scripts/governance/set-gsd-overlay-rollout.ps1script3.9 KB
scripts/governance/set-openspec-rollout.ps1script3.1 KB
scripts/governance/sync-bundled-vibe.ps1script20.3 KB
scripts/install/Install-VgoAdapter.ps1script2.0 KB
scripts/install/install_vgo_adapter.pyexecutablescript524 B
scripts/overlay/README.mdmarkdown885 B
scripts/overlay/suggest-browserops-provider.ps1script9.3 KB
scripts/overlay/suggest-overlays.ps1script17.3 KB
scripts/release/build_release_bundle.pyscript6.5 KB
scripts/research/README.mdmarkdown1.1 KB
scripts/research/build-eval-slicing-catalog.ps1script2.6 KB
scripts/research/build-watch-portfolio-review.ps1script3.5 KB
scripts/research/build-xl-operator-checklist.ps1script2.3 KB
scripts/research/extract-prompt-signals.ps1script6.7 KB
scripts/research/generate-vco-suggestions.ps1script9.7 KB
scripts/research/sync-mcp-catalog.ps1script3.5 KB
scripts/research/vibe-adaptive-train.ps1script10.1 KB
scripts/router/README.mdmarkdown1.8 KB
scripts/router/invoke-pack-route.pyscript428 B
scripts/router/modules/00-core-utils.ps1script14.6 KB
scripts/router/modules/01-openai-responses.ps1script17.9 KB
scripts/router/modules/10-observability.ps1script11.7 KB
scripts/router/modules/11-route-probe.ps1script20.7 KB
scripts/router/modules/12-heartbeat.ps1script19.9 KB
scripts/router/modules/19-custom-admission.ps1script16.3 KB
scripts/router/modules/20-routing-rules.ps1script1.7 KB
scripts/router/modules/21-capability-interview.ps1script11.8 KB
scripts/router/modules/22-intent-contract.ps1script18.2 KB
scripts/router/modules/30-openspec.ps1script8.3 KB
scripts/router/modules/31-gsd-overlay.ps1script5.5 KB
scripts/router/modules/32-prompt-overlay.ps1script8.0 KB
scripts/router/modules/33-memory-governance.ps1script5.5 KB
scripts/router/modules/34-data-scale-overlay.ps1script25.8 KB
scripts/router/modules/35-quality-debt-overlay.ps1script13.4 KB
scripts/router/modules/36-framework-interop-overlay.ps1script16.9 KB
scripts/router/modules/37-ml-lifecycle-overlay.ps1script22.4 KB
scripts/router/modules/38-python-clean-code-overlay.ps1script16.2 KB
scripts/router/modules/39-system-design-overlay.ps1script15.5 KB
scripts/router/modules/40-cuda-kernel-overlay.ps1script17.7 KB
scripts/router/modules/42-ai-rerank-overlay.ps1script14.0 KB
scripts/router/modules/43-retrieval-overlay.ps1script22.4 KB
scripts/router/modules/44-dialectic-team-gate.ps1script7.5 KB
scripts/router/modules/44-exploration-overlay.ps1script17.7 KB
scripts/router/modules/45-daily-dialectic-guard.ps1script6.6 KB
scripts/router/modules/47-closure-overlay.ps1script9.2 KB
scripts/router/modules/48-llm-acceleration-overlay.ps1script104.6 KB
scripts/router/modules/49-prompt-asset-boost.ps1script28.3 KB
scripts/router/resolve-pack-route.ps1script4.1 KB
scripts/router/runtime_neutral/custom_admission.pyscript349 B
scripts/router/runtime_neutral/router_contract.pyscript356 B
scripts/ruc-nlpir/preflight.ps1script5.3 KB
scripts/runtime/Freeze-RuntimeInputPacket.ps1script33.0 KB
scripts/runtime/Invoke-AntiProxyGoalDriftCompaction.ps1script551 B
scripts/runtime/Invoke-DeepInterview.ps1script1.1 KB
scripts/runtime/Invoke-PhaseCleanup.ps1script11.1 KB
scripts/runtime/Invoke-PlanExecute.ps1script13.7 KB
scripts/runtime/Invoke-SkeletonCheck.ps1script3.1 KB
scripts/runtime/Invoke-VibeCanonicalEntry.ps1script12.9 KB
scripts/runtime/VibeMemoryActivation.Common.ps1script41.3 KB
scripts/runtime/VibeMemoryBackends.Common.ps1script12.4 KB
scripts/runtime/VibeRuntime.Common.ps1script298.6 KB
scripts/runtime/VibeSkillRouting.Common.ps1script19.0 KB
scripts/runtime/VibeWorkspaceMemory.Common.ps1script6.9 KB
scripts/runtime/Write-RequirementDoc.ps1script23.7 KB
scripts/runtime/Write-XlPlan.ps1script32.3 KB
scripts/runtime/invoke-vibe-runtime.ps1script69.7 KB
scripts/runtime/memory_backend_driver.pyscript14.2 KB
scripts/runtime/skill_authority_driver.pyscript375 B
scripts/runtime/workspace_memory_driver.pyscript24.8 KB
scripts/setup/check-kvm-host-readiness.shscript3.4 KB
scripts/setup/check-windows-eval-iso-readiness.shexecutablescript2.2 KB
scripts/setup/check-windows-proof-vm-state.shexecutablescript2.0 KB
scripts/setup/export-codex-settings-sanitized.ps1script2.6 KB
scripts/setup/fetch-windows11-eval-iso.shexecutablescript4.1 KB
scripts/setup/install-local-vm-host.shexecutablescript1.6 KB
scripts/setup/persist-codex-openai-env.ps1script2.4 KB
scripts/setup/run-windows-proof-vm.shexecutablescript11.4 KB
scripts/setup/send-qmp-boot-keys.pyexecutablescript3.0 KB
scripts/setup/send-qmp-text.pyexecutablescript3.0 KB
scripts/setup/show-windows-proof-media-options.shexecutablescript1.6 KB
scripts/setup/stop-windows-proof-vm.shexecutablescript1.6 KB
scripts/setup/sync-codex-settings-to-user-env.ps1script2.6 KB
scripts/uninstall/Uninstall-VgoAdapter.ps1script1.4 KB
scripts/uninstall/uninstall_vgo_adapter.pyscript526 B
scripts/verify/README.mdmarkdown3.8 KB
scripts/verify/cer-compare.ps1script8.5 KB
scripts/verify/fixtures/README.mdmarkdown1.1 KB
scripts/verify/fixtures/document-cleanup-safety/README.mdmarkdown527 B
scripts/verify/fixtures/document-cleanup-safety/ambiguous-cn-set/metadata.jsonconfig101 B
scripts/verify/fixtures/document-cleanup-safety/ambiguous-cn-set/source/.tmp/docs/重庆市永川区技术预见与制度创新项目申报书1-修订版.docxbinary56 B
scripts/verify/fixtures/document-cleanup-safety/ambiguous-cn-set/source/.tmp/docs/重庆市永川区技术预见与制度创新项目申报书1-补充材料.pdfbinary56 B
scripts/verify/fixtures/document-cleanup-safety/ambiguous-cn-set/source/docs/重庆市永川区技术预见与制度创新项目申报书1-正式版.docxbinary36 B
scripts/verify/fixtures/document-cleanup-safety/mixed-office-assets/metadata.jsonconfig101 B
scripts/verify/fixtures/document-cleanup-safety/mixed-office-assets/source/.tmp/staging/budget-review.xlsxbinary59 B
scripts/verify/fixtures/document-cleanup-safety/mixed-office-assets/source/.tmp/staging/quarterly-review-deck.pptxbinary60 B
scripts/verify/fixtures/document-cleanup-safety/mixed-office-assets/source/docs/reference-manual.pdfbinary21 B
scripts/verify/fixtures/document-cleanup-safety/non-protected-control/metadata.jsonconfig101 B
scripts/verify/fixtures/document-cleanup-safety/non-protected-control/source/.tmp/control.txtmarkdown54 B
scripts/verify/fixtures/llm-acceleration.mock.jsonconfig1.0 KB
scripts/verify/fixtures/pilot-browserops.jsonconfig541 B
scripts/verify/fixtures/pilot-deep-extraction.jsonconfig731 B
scripts/verify/fixtures/pilot-desktopops.jsonconfig587 B
scripts/verify/fixtures/pilot-memory.jsonconfig575 B
scripts/verify/fixtures/pilot-prompt.jsonconfig525 B
scripts/verify/fixtures/process-health/external-node-protected-fixture.jsonconfig345 B
scripts/verify/fixtures/process-health/healthy-managed-fixture.jsonconfig1.1 KB
scripts/verify/fixtures/process-health/managed-completed-alive-fixture.jsonconfig1.2 KB
scripts/verify/fixtures/process-health/managed-stale-fixture.jsonconfig1.1 KB
scripts/verify/fixtures/process-health/no-node-processes-fixture.jsonconfig131 B
scripts/verify/fixtures/prompt-asset-boost.mock.jsonconfig1.2 KB
scripts/verify/gate-family-index.mdmarkdown2.5 KB
scripts/verify/lib/VibeOfflineSkillsAudit.Suites.ps1script11.8 KB
scripts/verify/lib/VibeOfflineSkillsAudit.ps1script12.2 KB
scripts/verify/lib/VibeRouteAudit.Suites.ps1script7.9 KB
scripts/verify/lib/VibeRouteAudit.ps1script5.2 KB
scripts/verify/live-document-gate.pyscript7.6 KB
scripts/verify/probe-scientific-packs.ps1script55.1 KB
scripts/verify/publish-proof.pyscript409 B
scripts/verify/runtime_neutral/README.mdmarkdown2.5 KB
scripts/verify/runtime_neutral/_bootstrap.pyscript321 B
scripts/verify/runtime_neutral/bio_science_pack_consolidation_audit.pyscript421 B
scripts/verify/runtime_neutral/bootstrap_doctor.pyscript494 B
scripts/verify/runtime_neutral/code_quality_pack_consolidation_audit.pyscript717 B
scripts/verify/runtime_neutral/coherence_gate.pyscript529 B
scripts/verify/runtime_neutral/freshness_gate.pyscript494 B
scripts/verify/runtime_neutral/global_pack_consolidation_audit.pyscript635 B
scripts/verify/runtime_neutral/ml_skills_pruning_audit.pyscript574 B
scripts/verify/runtime_neutral/opencode_preview_smoke.pyscript674 B
scripts/verify/runtime_neutral/release_notes_quality.pyscript701 B

scripts/router/modules/38-python-clean-code-overlay.ps1

View on GitHub
# Auto-extracted router module. Keep function bodies behavior-identical.

function Get-PythonCleanCodeAdvice {
    param(
        [string]$Prompt,
        [string]$PromptLower,
        [string]$Grade,
        [string]$TaskType,
        [string]$RouteMode,
        [string]$SelectedPackId,
        [string]$SelectedSkill,
        [string[]]$PackCandidates,
        [object]$PythonCleanCodeOverlayPolicy
    )

    $base = [ordered]@{
        enabled = $false
        mode = "off"
        task_applicable = $false
        grade_applicable = $false
        pack_applicable = $false
        skill_applicable = $false
        scope_applicable = $false
        enforcement = "none"
        reason = "policy_missing"
        preserve_routing_assignment = $true
        paths_detected = @()
        paths_existing = @()
        python_file_signal = $false
        language_keyword_hits = @()
        principle_groups_matched = @()
        principle_group_hits = [pscustomobject]@{}
        principle_group_scores = [pscustomobject]@{}
        anti_pattern_hits = @()
        suppress_keyword_hits = @()
        python_signal_score = 0.0
        signal_likelihood = "none"
        trigger_active = $false
        confirm_recommended = $false
        confirm_required = $false
        strict_scope_applied = $false
        recommended_refactors = @()
        should_apply_hook = $false
    }

    if (-not $PythonCleanCodeOverlayPolicy) {
        return [pscustomobject]$base
    }

    $enabled = $true
    if ($PythonCleanCodeOverlayPolicy.enabled -ne $null) {
        $enabled = [bool]$PythonCleanCodeOverlayPolicy.enabled
    }
    $mode = if ($PythonCleanCodeOverlayPolicy.mode) { [string]$PythonCleanCodeOverlayPolicy.mode } else { "off" }
    if ((-not $enabled) -or ($mode -eq "off")) {
        $base.enabled = $false
        $base.mode = "off"
        $base.reason = "policy_off"
        return [pscustomobject]$base
    }

    $taskAllow = @("coding", "review", "debug")
    if ($PythonCleanCodeOverlayPolicy.task_allow) {
        $taskAllow = @($PythonCleanCodeOverlayPolicy.task_allow)
    }
    $gradeAllow = @("M", "L", "XL")
    if ($PythonCleanCodeOverlayPolicy.grade_allow) {
        $gradeAllow = @($PythonCleanCodeOverlayPolicy.grade_allow)
    }

    $packAllow = @()
    $skillAllow = @()
    if ($PythonCleanCodeOverlayPolicy.monitor) {
        if ($PythonCleanCodeOverlayPolicy.monitor.pack_allow) {
            $packAllow = @($PythonCleanCodeOverlayPolicy.monitor.pack_allow)
        }
        if ($PythonCleanCodeOverlayPolicy.monitor.skill_allow) {
            $skillAllow = @($PythonCleanCodeOverlayPolicy.monitor.skill_allow)
        }
    }

    $taskApplicable = ($taskAllow -contains $TaskType)
    $gradeApplicable = ($gradeAllow -contains $Grade)
    $packApplicable = if ($packAllow.Count -gt 0) { $packAllow -contains $SelectedPackId } else { $true }
    $skillApplicable = if ($skillAllow.Count -gt 0) { $skillAllow -contains $SelectedSkill } else { $true }
    $scopeApplicable = ($taskApplicable -and $gradeApplicable -and $packApplicable -and $skillApplicable)

    $preserveRoutingAssignment = $true
    if ($PythonCleanCodeOverlayPolicy.preserve_routing_assignment -ne $null) {
        $preserveRoutingAssignment = [bool]$PythonCleanCodeOverlayPolicy.preserve_routing_assignment
    }

    $base.enabled = $true
    $base.mode = $mode
    $base.task_applicable = $taskApplicable
    $base.grade_applicable = $gradeApplicable
    $base.pack_applicable = $packApplicable
    $base.skill_applicable = $skillApplicable
    $base.scope_applicable = $scopeApplicable
    $base.preserve_routing_assignment = $preserveRoutingAssignment

    if (-not $scopeApplicable) {
        $base.reason = "outside_scope"
        return [pscustomobject]$base
    }

    $probeEnabled = $true
    $extractFromPrompt = $true
    $workspaceProbeWhenNoPath = $false
    $workspaceProbeLimit = 2
    $workspaceProbeExtensions = @("py", "pyi")
    if ($PythonCleanCodeOverlayPolicy.path_probe) {
        if ($PythonCleanCodeOverlayPolicy.path_probe.enabled -ne $null) {
            $probeEnabled = [bool]$PythonCleanCodeOverlayPolicy.path_probe.enabled
        }
        if ($PythonCleanCodeOverlayPolicy.path_probe.extract_from_prompt -ne $null) {
            $extractFromPrompt = [bool]$PythonCleanCodeOverlayPolicy.path_probe.extract_from_prompt
        }
        if ($PythonCleanCodeOverlayPolicy.path_probe.workspace_probe_when_no_path -ne $null) {
            $workspaceProbeWhenNoPath = [bool]$PythonCleanCodeOverlayPolicy.path_probe.workspace_probe_when_no_path
        }
        if ($PythonCleanCodeOverlayPolicy.path_probe.workspace_probe_limit -ne $null) {
            $workspaceProbeLimit = [int]$PythonCleanCodeOverlayPolicy.path_probe.workspace_probe_limit
        }
        if ($PythonCleanCodeOverlayPolicy.path_probe.workspace_probe_extensions) {
            $workspaceProbeExtensions = @($PythonCleanCodeOverlayPolicy.path_probe.workspace_probe_extensions)
        }
    }

    $pathsDetected = @()
    if ($probeEnabled -and $extractFromPrompt) {
        $pathsDetected = Get-PathCandidatesFromPrompt -Prompt $Prompt -SupportedExtensions $workspaceProbeExtensions
    }
    $pathsExisting = @()
    if ($probeEnabled) {
        $pathsExisting = Resolve-ExistingPathCandidates `
            -PathCandidates $pathsDetected `
            -WorkspaceProbeEnabled $workspaceProbeWhenNoPath `
            -WorkspaceProbeLimit $workspaceProbeLimit `
            -WorkspaceProbeExtensions $workspaceProbeExtensions
    }

    $base.paths_detected = @($pathsDetected)
    $base.paths_existing = @($pathsExisting)
    $pythonFileSignal = ((@($pathsDetected).Count -gt 0) -or (@($pathsExisting).Count -gt 0))
    $base.python_file_signal = $pythonFileSignal

    $languageKeywords = @(
        "python",
        ".py",
        ".pyi",
        "pytest",
        "dataclass",
        "type hints",
        "async def",
        "pep8",
        "pydantic",
        "flake8",
        "ruff",
        "mypy",
        "python文件",
        "python脚本",
        "写python",
        "重构python"
    )
    if ($PythonCleanCodeOverlayPolicy.language_keywords) {
        $languageKeywords = @($PythonCleanCodeOverlayPolicy.language_keywords)
    }

    $principleGroups = [ordered]@{
        naming = @("naming", "meaningful name", "clear name", "命名", "可读命名")
        function_design = @("single responsibility", "long function", "too many arguments", "boolean parameter", "函数过长", "参数过多", "布尔参数")
        class_design = @("solid", "class responsibility", "god object", "god class", "类职责", "大而全类")
        side_effects = @("side effect", "pure function", "immutable", "副作用", "纯函数")
        duplication = @("duplicate logic", "duplication", "dry", "重复代码", "去重逻辑")
        error_handling = @("raise", "exception handling", "error boundary", "异常处理", "错误处理")
        tests = @("pytest", "unit test", "testability", "可测试性", "单元测试")
    }
    if ($PythonCleanCodeOverlayPolicy.principle_groups) {
        $principleGroups = [ordered]@{}
        foreach ($groupName in @($PythonCleanCodeOverlayPolicy.principle_groups.PSObject.Properties.Name)) {
            $principleGroups[[string]$groupName] = @($PythonCleanCodeOverlayPolicy.principle_groups.$groupName)
        }
    }

    $antiPatternKeywords = @(
        "god class",
        "god object",
        "long function",
        "too many arguments",
        "boolean parameter",
        "magic number",
        "duplicate logic",
        "side effect",
        "spaghetti",
        "函数过长",
        "参数过多",
        "布尔参数",
        "魔法数字",
        "重复代码",
        "副作用"
    )
    if ($PythonCleanCodeOverlayPolicy.anti_pattern_keywords) {
        $antiPatternKeywords = @($PythonCleanCodeOverlayPolicy.anti_pattern_keywords)
    }

    $suppressKeywords = @(
        "generated",
        "migration",
        "vendor",
        "autogen",
        "docs only",
        "benchmark only",
        "notebook draft",
        "自动生成",
        "迁移脚本",
        "仅文档"
    )
    if ($PythonCleanCodeOverlayPolicy.suppress_keywords) {
        $suppressKeywords = @($PythonCleanCodeOverlayPolicy.suppress_keywords)
    }

    $triggerMin = 0.45
    $confirmMin = 0.6
    $highSignalMin = 0.78
    $suppressWeight = 0.25
    $minAntiHitsForConfirm = 1
    if ($PythonCleanCodeOverlayPolicy.thresholds) {
        if ($PythonCleanCodeOverlayPolicy.thresholds.trigger_signal_score_min -ne $null) {
            $triggerMin = [double]$PythonCleanCodeOverlayPolicy.thresholds.trigger_signal_score_min
        }
        if ($PythonCleanCodeOverlayPolicy.thresholds.confirm_signal_score_min -ne $null) {
            $confirmMin = [double]$PythonCleanCodeOverlayPolicy.thresholds.confirm_signal_score_min
        }
        if ($PythonCleanCodeOverlayPolicy.thresholds.high_signal_score_min -ne $null) {
            $highSignalMin = [double]$PythonCleanCodeOverlayPolicy.thresholds.high_signal_score_min
        }
        if ($PythonCleanCodeOverlayPolicy.thresholds.suppress_penalty_weight -ne $null) {
            $suppressWeight = [double]$PythonCleanCodeOverlayPolicy.thresholds.suppress_penalty_weight
        }
        if ($PythonCleanCodeOverlayPolicy.thresholds.min_anti_pattern_hits_for_confirm -ne $null) {
            $minAntiHitsForConfirm = [int]$PythonCleanCodeOverlayPolicy.thresholds.min_anti_pattern_hits_for_confirm
        }
    }

    $languageMatches = @()
    foreach ($kw in $languageKeywords) {
        if (Test-KeywordHit -PromptLower $PromptLower -Keyword ([string]$kw)) {
            $languageMatches += [string]$kw
        }
    }
    $antiPatternMatches = @()
    foreach ($kw in $antiPatternKeywords) {
        if (Test-KeywordHit -PromptLower $PromptLower -Keyword ([string]$kw)) {
            $antiPatternMatches += [string]$kw
        }
    }
    $suppressMatches = @()
    foreach ($kw in $suppressKeywords) {
        if (Test-KeywordHit -PromptLower $PromptLower -Keyword ([string]$kw)) {
            $suppressMatches += [string]$kw
        }
    }

    $groupHits = [ordered]@{}
    $groupScores = [ordered]@{}
    $matchedGroups = @()
    $principleMatches = @()
    foreach ($groupName in @($principleGroups.Keys)) {
        $keywords = @($principleGroups[$groupName])
        $hits = @()
        foreach ($kw in $keywords) {
            if (Test-KeywordHit -PromptLower $PromptLower -Keyword ([string]$kw)) {
                $hits += [string]$kw
            }
        }
        $score = Get-KeywordRatio -PromptLower $PromptLower -Keywords $keywords
        $groupHits[[string]$groupName] = @($hits)
        $groupScores[[string]$groupName] = [Math]::Round([double]$score, 4)
        if ($hits.Count -gt 0) {
            $matchedGroups += [string]$groupName
            $principleMatches += @($hits)
        }
    }

    $languageRatio = Get-KeywordRatio -PromptLower $PromptLower -Keywords $languageKeywords
    $principleRatio = if ($principleMatches.Count -gt 0) { Get-KeywordRatio -PromptLower $PromptLower -Keywords @($principleMatches | Select-Object -Unique) } else { 0.0 }
    $antiPatternRatio = Get-KeywordRatio -PromptLower $PromptLower -Keywords $antiPatternKeywords
    $suppressRatio = Get-KeywordRatio -PromptLower $PromptLower -Keywords $suppressKeywords
    $fileSignal = if ($pythonFileSignal) { 1.0 } else { 0.0 }
    $semanticRatio = [Math]::Max([double]$principleRatio, [double]$antiPatternRatio)

    $signalScore = (0.65 * $fileSignal) + (0.20 * $languageRatio) + (0.15 * $semanticRatio) - ($suppressWeight * $suppressRatio)
    if ($pythonFileSignal -and $signalScore -lt $triggerMin) {
        $signalScore = [Math]::Max($signalScore, $triggerMin)
    }
    $signalScore = [Math]::Max(0.0, [Math]::Min(1.0, $signalScore))
    $signalScore = [Math]::Round([double]$signalScore, 4)

    $signalLikelihood = "none"
    if ($signalScore -ge $highSignalMin) {
        $signalLikelihood = "high"
    } elseif ($signalScore -ge $confirmMin) {
        $signalLikelihood = "medium"
    } elseif ($signalScore -gt 0) {
        $signalLikelihood = "low"
    }

    $triggerActive = ($scopeApplicable -and (($signalScore -ge $triggerMin) -or $pythonFileSignal))
    $confirmRecommended = (
        $triggerActive -and
        ($signalScore -ge $confirmMin) -and
        (
            ($antiPatternMatches.Count -ge $minAntiHitsForConfirm) -or
            ($matchedGroups.Count -ge 2) -or
            ($TaskType -eq "review")
        )
    )

    $strictGrades = @("L", "XL")
    $strictTasks = @("coding", "review")
    if ($PythonCleanCodeOverlayPolicy.strict_confirm_scope) {
        if ($PythonCleanCodeOverlayPolicy.strict_confirm_scope.grades) {
            $strictGrades = @($PythonCleanCodeOverlayPolicy.strict_confirm_scope.grades)
        }
        if ($PythonCleanCodeOverlayPolicy.strict_confirm_scope.task_types) {
            $strictTasks = @($PythonCleanCodeOverlayPolicy.strict_confirm_scope.task_types)
        }
    }
    $strictScopeApplied = (($strictGrades -contains $Grade) -and ($strictTasks -contains $TaskType))
    $confirmRequired = (
        $triggerActive -and
        ($mode -eq "strict") -and
        $strictScopeApplied -and
        $confirmRecommended -and
        ($antiPatternMatches.Count -ge $minAntiHitsForConfirm)
    )

    $enforcement = "none"
    $reason = "outside_scope"
    if ($scopeApplicable) {
        if (-not $triggerActive) {
            $enforcement = "advisory"
            $reason = "signal_below_threshold"
        } else {
            switch ($mode) {
                "shadow" {
                    $enforcement = "advisory"
                    $reason = "shadow_python_advisory"
                }
                "soft" {
                    $enforcement = "advisory"
                    if ($confirmRecommended) {
                        $reason = "soft_python_confirm_recommended"
                    } else {
                        $reason = "soft_python_advisory"
                    }
                }
                "strict" {
                    if ($confirmRequired) {
                        $enforcement = "confirm_required"
                        $reason = "strict_python_clean_code_confirmation"
                    } else {
                        $enforcement = "advisory"
                        $reason = "strict_python_advisory"
                    }
                }
                default {
                    $enforcement = "advisory"
                    $reason = "unknown_mode_advisory"
                }
            }
        }
    }

    $recommendationMap = $null
    if ($PythonCleanCodeOverlayPolicy.recommendations_by_group) {
        $recommendationMap = $PythonCleanCodeOverlayPolicy.recommendations_by_group
    }
    $recommendedRefactors = @()
    if ($triggerActive) {
        $recommendationKeys = if ($recommendationMap) { @($recommendationMap.PSObject.Properties.Name) } else { @() }
        foreach ($groupName in @($matchedGroups)) {
            if ($recommendationMap -and ($recommendationKeys -contains $groupName)) {
                $recommendedRefactors += [string]$recommendationMap.$groupName
            }
        }
        if ($antiPatternMatches.Count -gt 0) {
            $recommendedRefactors += "Prioritize removing detected anti-pattern hotspots before adding new behavior."
        }
        if ($recommendedRefactors.Count -eq 0) {
            $recommendedRefactors += "Apply Python clean-code checks: naming clarity, function focus, side-effect isolation, and duplication cleanup."
        }
    }

    $base.enforcement = $enforcement
    $base.reason = $reason
    $base.language_keyword_hits = @($languageMatches)
    $base.principle_groups_matched = @($matchedGroups)
    $base.principle_group_hits = [pscustomobject]$groupHits
    $base.principle_group_scores = [pscustomobject]$groupScores
    $base.anti_pattern_hits = @($antiPatternMatches)
    $base.suppress_keyword_hits = @($suppressMatches)
    $base.python_signal_score = $signalScore
    $base.signal_likelihood = $signalLikelihood
    $base.trigger_active = $triggerActive
    $base.confirm_recommended = $confirmRecommended
    $base.confirm_required = $confirmRequired
    $base.strict_scope_applied = $strictScopeApplied
    $base.recommended_refactors = @($recommendedRefactors | Select-Object -Unique)
    $base.should_apply_hook = ($scopeApplicable -and $triggerActive)

    return [pscustomobject]$base
}


receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall