[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7190DDBDA9SE6R3VS4M8GC9":3,"skill-same:01M7190DDBDA9SE6R3VS4M8GC9":122},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":26,"publishedAt":47,"linkOnly":48,"markdownContent":49,"markdownBody":50,"frontMatter":51,"refName":80,"commitSha":81,"skillDirectory":82,"forksCount":83,"repositoryHtmlUrl":84,"repositoryHomepageUrl":6,"ownerHtmlUrl":85,"ownerBlogUrl":86,"ownerDescription":6,"updatedAt":87,"install":88,"resources":101},"01M7190DDBDA9SE6R3VS4M8GC9","slopgate-hygiene-orchestrator",null,"Orchestrate systematic elimination of linter warnings and errors across Python, TypeScript, and Rust codebases. Use when asked to \"clean up lints\", \"fix all warnings\", \"run hygiene\", \"eliminate type errors\", \"orchestrate code quality fixes\", \"fix lint errors\", \"resolve quality gate failures\", \"pass CI checks\", \"reduce tech debt\", \"refactor to pass hooks\", or when a Slopgate hook denies with QUALITY-LINT-001, PY-CODE-017, PY-CODE-018, or any collector finding. This skill coordinates multiple code-hygiene-enforcer agents working in parallel on non-conflicting file groupings, tracks progress persistently via JSON exports, and loops until all issues are resolved. CRITICAL: Never run linters directly—always use `slopgate lint check` as the primary gate, discover project-specific tools from config files, and export findings to JSON for tracking.","vasceannie\u002Fslopgate","vasceannie","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F20271133?v=4","01M718RGA8VV2EF22XJEMXVQ0Q","Travis Vasceannie","01M718RGB0GWSXBBZBN67Q6NHQ",1,"MIT","https:\u002F\u002Fgithub.com\u002Fvasceannie\u002Fslopgate\u002Fblob\u002Fmaster\u002F.codex\u002Fskills\u002Fslopgate-hygiene-orchestrator\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000007","代码审查","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46],"hygiene","orchestrator","slopgate hygiene orchestrator","hook","quality-gates","debt","typescript","config","systematic","lint check","run","reduce","cleanup","files","never run","clean","local","ci","fix","project","2026-11-10 10:12:30",false,"---\nname: slopgate-hygiene-orchestrator\ndescription: |\n  Orchestrate systematic elimination of linter warnings and errors across Python, TypeScript, and Rust codebases. Use when asked to \"clean up lints\", \"fix all warnings\", \"run hygiene\", \"eliminate type errors\", \"orchestrate code quality fixes\", \"fix lint errors\", \"resolve quality gate failures\", \"pass CI checks\", \"reduce tech debt\", \"refactor to pass hooks\", or when a Slopgate hook denies with QUALITY-LINT-001, PY-CODE-017, PY-CODE-018, or any collector finding. This skill coordinates multiple code-hygiene-enforcer agents working in parallel on non-conflicting file groupings, tracks progress persistently via JSON exports, and loops until all issues are resolved. CRITICAL: Never run linters directly—always use `slopgate lint check` as the primary gate, discover project-specific tools from config files, and export findings to JSON for tracking.\nversion: 1.0.0\nauthor: Slopgate\nlicense: MIT\ncompatibility: claude-code, opencode, codex, hermes, slopgate\nmetadata:\n  hermes:\n    tags: [slopgate,lint,quality-gates,bulk-remediation,hygiene]\n    related_skills: [slopgate-code-hygiene-refactor,slopgate-test-extender,slopgate-code-smell-utility-locator]\n  slopgate:\n    rule_ids: [QUALITY-LINT-001,PY-CODE-017,PY-CODE-018]\n    activation:\n      primary: [repo-wide lint cleanup,multi-file hook remediation,slopgate lint tracking]\n      avoid: [single local denial,one-file refactor,test-only coverage gap]\n---\n\n# Hygiene Orchestrator\n\nCoordinate systematic elimination of linter warnings\u002Ferrors using parallelized agents, JSON-exported findings, and persistent progress tracking.\n\n## When to Use\n\nUse when the task is repo-wide, multi-file, or multi-rule Slopgate cleanup.\n\n- User asks to fix all warnings, clean up lints, pass the quality gate, or coordinate hygiene work.\n- `slopgate lint check --details` produces many findings that need grouping, tracking, and dispatch.\n- Multiple files or collectors are involved and progress needs a persistent `.hygiene\u002F` tracking artifact.\n- Use this as the coordinator; delegate local structural repairs to `slopgate-code-hygiene-refactor` and test gaps to `slopgate-test-extender`.\n\n## When Not to Use\n\nDo not use for a single hook denial or one touched file. Use `slopgate-code-hygiene-refactor` for local structure, `slopgate-code-smell-utility-locator` for helper\u002Fconstant ownership, and `slopgate-test-extender` for test-only findings.\n\nDo not use when the task is only to inspect current telemetry or explain a rule without applying a cleanup plan.\n\n## Critical Rules\n\n1. **NEVER run linters directly in terminal** — Use `slopgate lint check` (repo root, no path args) as the primary gate. Discover project-specific tools by inspecting `package.json`, `pyproject.toml`, `Cargo.toml`, etc.\n2. **Always export to JSON** — Lint outputs must be parsed into structured JSON for tracking and dispatch\n3. **Update tracking before context compaction** — Progress must survive context limits via `.hygiene\u002Ftracking.json`\n4. **Remind all agents about related skills** — Invoke `\u002Ftype-strictness` for type fixes, `\u002Fcode-hygiene-refactor` for structural issues, `\u002Ftest-extender` for coverage gaps\n\n## Workflow Overview\n\n```\n┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐\n│  1. Export      │───>│  2. Parse &      │───>│  3. Dispatch    │\n│  Lint Results   │    │  Group Issues    │    │  Parallel Agents│\n└─────────────────┘    └──────────────────┘    └─────────────────┘\n         ^                                              │\n         │              ┌──────────────────┐            │\n         └──────────────│  4. Validate &   │\u003C───────────┘\n                        │  Update Tracking │\n                        └──────────────────┘\n```\n\n## Phase 1: Export Lint Results\n\n### Primary: `slopgate lint check`\n\nRun from the repo root. No path argument is accepted.\n\n```bash\n# Basic run\nHOME=\u002Fhome\u002Ftrav \u002Fhome\u002Ftrav\u002F.local\u002Fbin\u002Fslopgate lint check\n\n# Detailed output with repair guidance\nHOME=\u002Fhome\u002Ftrav \u002Fhome\u002Ftrav\u002F.local\u002Fbin\u002Fslopgate lint check --details\n\n# Export to JSON for parsing (pipe stdout to a parser)\nHOME=\u002Fhome\u002Ftrav \u002Fhome\u002Ftrav\u002F.local\u002Fbin\u002Fslopgate lint check --details 2>&1 | \\\n  python3 \u002Fpath\u002Fto\u002Fskill\u002Fscripts\u002Fparse_slopgate_lint.py --output .hygiene\u002Fslopgate_lint.json\n```\n\nThe `--details` flag adds per-finding fields: `file`, `location`, `signature`, `detail`, `stable-id`, `prognosis`, `scaffold`, `metadata.*`, `agent-context`, `validation`, `verify`.\n\n### Secondary: project-specific lint tools\n\nIf the project uses additional linters beyond Slopgate, discover the correct invocation rather than assuming a Makefile:\n\n```bash\n# Look for common entrypoints\nls package.json 2>\u002Fdev\u002Fnull && npm run lint --silent 2>\u002Fdev\u002Fnull\nls pyproject.toml 2>\u002Fdev\u002Fnull && python3 -m ruff check . 2>\u002Fdev\u002Fnull\nls Cargo.toml 2>\u002Fdev\u002Fnull && cargo clippy --all-targets 2>\u002Fdev\u002Fnull\n```\n\nPipe any secondary lint output through a parser into `.hygiene\u002F` JSON or text. Do not assume `make` targets exist.\n\n## Phase 2: Parse and Group Issues\n\n### Parsing Slopgate Lint Output\n\nUse `scripts\u002Fparse_slopgate_lint.py` to parse `--details` output into structured JSON:\n\n```bash\npython \u002Fpath\u002Fto\u002Fskill\u002Fscripts\u002Fparse_slopgate_lint.py \\\n  --input \u003C(slopgate lint check --details 2>&1) \\\n  --output .hygiene\u002Fslopgate_lint.json\n```\n\nThe parser produces:\n\n```json\n{\n  \"header\": {\n    \"project\": \"\u002Fpath\u002Fto\u002Frepo\",\n    \"baseline\": \"\u002Fpath\u002Fto\u002Frepo\u002Fbaselines.json\"\n  },\n  \"summary\": {\n    \"collectors\": [\n      {\"name\": \"long-method\", \"total\": 3, \"new\": 2},\n      {\"name\": \"untested-production-code\", \"total\": 1, \"new\": 1}\n    ],\n    \"total_findings\": 4,\n    \"new_findings\": 3,\n    \"baseline_findings\": 1,\n    \"fixed_findings\": 0\n  },\n  \"findings\": [\n    {\n      \"status\": \"NEW\",\n      \"collector\": \"long-method\",\n      \"fields\": {\n        \"file\": \"src\u002Fmain.py\",\n        \"location\": \"src\u002Fmain.py:52\",\n        \"signature\": \"callable `f`\",\n        \"detail\": \"lines=52\",\n        \"stable-id\": \"long-method|src\u002Fmain.py|f|lines=52\",\n        \"prognosis\": \"function is doing multiple phases inline.\",\n        \"scaffold\": \"extract named helpers for parse\u002Fvalidate\u002Ftransform\u002Fpersist\u002Frender phases; keep data flow explicit.\"\n      }\n    }\n  ]\n}\n```\n\n### Grouping Strategy\n\nGroup issues into **non-conflicting batches** for parallel agent work:\n\n| Priority | Grouping Criteria | Rationale |\n|----------|-------------------|-----------|\n| 1 | By file (no overlaps) | Agents can't conflict on different files |\n| 2 | By collector \u002F error category | Similar fixes, consistent patterns |\n| 3 | By severity | Errors before warnings |\n| 4 | By dependency order | Fix imports\u002Ftypes before consumers |\n\n**Non-conflicting batch rules:**\n- Files in batch A share NO imports with files in batch B\n- Type definition files before files that use those types\n- Base classes before derived classes\n\nUse `stable-id` to deduplicate findings across iterations.\n\n## Phase 3: Dispatch Parallel Agents\n\n### Agent Configuration\n\nEach agent batch receives:\n1. **File list**: Non-overlapping with other batches\n2. **Issue manifest**: Specific findings with `stable-id`, `scaffold`, and `location`\n3. **Context reminder**: Relevant skills, project conventions\n\n### Dispatch Template\n\n```yaml\n# For each batch, spawn code-hygiene-enforcer agent:\nbatch_1:\n  files: [src\u002Fnoteflow\u002Fgrpc\u002F_mixins\u002Fannotation.py, src\u002Fnoteflow\u002Fgrpc\u002F_mixins\u002Fcalendar.py]\n  findings:\n    - stable-id: \"long-method|src\u002Fnoteflow\u002Fgrpc\u002F_mixins\u002Fannotation.py|parse|lines=65\"\n      scaffold: \"extract named helpers for parse\u002Fvalidate\u002Ftransform phases\"\n  agent: code-hygiene-enforcer\n  instructions: |\n    Fix the following issues. Remember: use \u002Ftype-strictness skill for all type fixes.\n    Never add # type: ignore. Update all dependent code.\n\nbatch_2:\n  files: [src\u002Fnoteflow\u002Fgrpc\u002F_mixins\u002Fproject\u002F_membership.py, src\u002Fnoteflow\u002Fgrpc\u002F_mixins\u002Fproject\u002F_mixin.py]\n  findings:\n    - stable-id: \"untested-production-code|src\u002Fnoteflow\u002Fgrpc\u002F_mixins\u002Fproject\u002F_membership.py|coverage-001\"\n      scaffold: \"add behavior tests for the unreferenced public symbols\"\n  agent: code-hygiene-enforcer\n  instructions: |\n    Fix None-safety issues. Add proper guards or update function signatures.\n    Use \u002Ftest-extender for test additions. Use \u002Ftype-strictness for type refinements.\n```\n\n### Parallel Execution\n\nUse Task tool to launch multiple agents simultaneously:\n\n```\nTask(subagent_type=\"code-hygiene-enforcer\", prompt=\"...\", run_in_background=true)\nTask(subagent_type=\"code-hygiene-enforcer\", prompt=\"...\", run_in_background=true)\n...\n```\n\nMonitor with `TaskOutput(task_id=..., block=true)`.\n\n## Phase 4: Validate and Update Tracking\n\n### Post-Agent Validation\n\nAfter each agent completes:\n\n1. **Re-run slopgate lint**:\n   ```bash\n   HOME=\u002Fhome\u002Ftrav \u002Fhome\u002Ftrav\u002F.local\u002Fbin\u002Fslopgate lint check --details 2>&1 | \\\n     python3 \u002Fpath\u002Fto\u002Fskill\u002Fscripts\u002Fparse_slopgate_lint.py --output .hygiene\u002Fslopgate_lint.json\n   ```\n\n2. **Verify no regressions** with the project's test command:\n   ```bash\n   # Discover the test runner; don't assume make\n   ls pytest.ini pyproject.toml tox.ini 2>\u002Fdev\u002Fnull && python3 -m pytest -q\n   ls package.json 2>\u002Fdev\u002Fnull && npm test --silent 2>\u002Fdev\u002Fnull\n   ls Cargo.toml 2>\u002Fdev\u002Fnull && cargo test --quiet 2>\u002Fdev\u002Fnull\n   ```\n\n3. **Check for new issues** introduced by fixes\n\n### Update Tracking File\n\nMaintain `.hygiene\u002Ftracking.json`:\n\n```json\n{\n  \"session_id\": \"2025-01-02T03:45:00Z\",\n  \"iteration\": 3,\n  \"repo\": \"\u002Fpath\u002Fto\u002Frepo\",\n  \"baseline\": \"\u002Fpath\u002Fto\u002Frepo\u002Fbaselines.json\",\n  \"initial_counts\": {\n    \"long-method\": 5,\n    \"untested-production-code\": 3,\n    \"repeated-code-block\": 12\n  },\n  \"current_counts\": {\n    \"long-method\": 1,\n    \"untested-production-code\": 0,\n    \"repeated-code-block\": 4\n  },\n  \"completed_items\": [\n    {\n      \"stable_id\": \"long-method|src\u002Ffoo.py|process|lines=68\",\n      \"file\": \"src\u002Ffoo.py\",\n      \"collector\": \"long-method\",\n      \"resolved_at\": \"2025-01-02T04:00:00Z\"\n    }\n  ],\n  \"pending_items\": [\n    {\n      \"stable_id\": \"long-method|src\u002Fbar.py|transform|lines=72\",\n      \"file\": \"src\u002Fbar.py\",\n      \"collector\": \"long-method\",\n      \"scaffold\": \"extract named helpers for transform\u002Fpersist phases\",\n      \"status\": \"open\"\n    }\n  ],\n  \"blocked_items\": [\n    {\n      \"stable_id\": \"repeated-code-block|src\u002Fqux.py|helper|lines 10-15\",\n      \"file\": \"src\u002Fqux.py\",\n      \"collector\": \"repeated-code-block\",\n      \"reason\": \"Requires architectural change — shared helper needs design review\"\n    }\n  ],\n  \"last_updated\": \"2025-01-02T04:15:00Z\"\n}\n```\n\nUse `stable-id` as the primary key for tracking individual findings across iterations.\n\n## Context Compaction Protocol\n\n**CRITICAL**: Before context limit is reached, MUST update:\n\n1. **tracking.json** with current progress\n2. **Todo list** with remaining work items\n3. **Memory** (if using Serena): Write to `hygiene_progress` memory\n\n### Handoff Message Template\n\n```yaml\nhygiene_handoff:\n  status: \"in_progress\"\n  iteration: 4\n  remaining_errors: 12\n  next_batch:\n    files: [list of files]\n    findings:\n      - stable-id: \"collector|file|signature|detail\"\n        scaffold: \"repair guidance from slopgate output\"\n  instructions: |\n    Continue hygiene orchestration from iteration 4.\n    Read .hygiene\u002Ftracking.json for full state.\n    Run \u002Fhygiene-orchestrator to resume.\n```\n\n## Iteration Loop\n\n```\nWHILE issues_remaining > 0:\n    1. Export fresh lint results (slopgate lint check --details)\n    2. Parse into JSON (parse_slopgate_lint.py)\n    3. Group into non-conflicting batches by stable-id\n    4. Dispatch agents in parallel\n    5. Wait for completion\n    6. Validate fixes (re-run slopgate lint check)\n    7. Update tracking.json\n    8. IF context_nearing_limit:\n           Write handoff state\n           EXIT with resume instructions\n    9. Increment iteration\n```\n\n## Available Commands\n\n| Command | Output | Description |\n|---------|--------|-------------|\n| `slopgate lint check` | stdout (human) | Repo-root lint, no path args |\n| `slopgate lint check --details` | stdout (human + repair guidance) | Detailed with prognosis\u002Fscaffold |\n| `parse_slopgate_lint.py` | `.hygiene\u002Fslopgate_lint.json` | Structured JSON from --details output |\n\nProject-specific tools (discover, don't assume):\n\n| Tool | Typical invocation |\n|------|-------------------|\n| ruff | `python3 -m ruff check .` |\n| basedpyright | `basedpyright --outputjson src\u002F` |\n| biome | `npx biome check .` |\n| tsc | `npx tsc --noEmit` |\n| clippy | `cargo clippy --all-targets` |\n| eslint | `npx eslint .` |\n\n## Skill Reminders\n\nAlways remind dispatched agents:\n\n1. **Use \u002Ftype-strictness skill** for type annotations\n2. **Use \u002Ftest-extender skill** when modifying tested code or adding coverage\n3. **Use \u002Fcode-hygiene-refactor skill** for structural issues (flat siblings, oversized modules, god classes)\n4. **Never use # type: ignore** — fix the underlying issue\n5. **Never use Any** unless absolutely unavoidable\n6. **Update all callers** when changing signatures\n7. **Run tests** after fixes: `pytest \u003Caffected_tests>`\n\n## Error Categories Reference\n\n### Slopgate collectors (common)\n- `long-method` — Function exceeds line threshold; extract helpers\n- `repeated-code-block` — Duplicated behavior; extract shared helper\u002Fservice\n- `untested-production-code` — Public symbols lack test references; add behavior tests\n- `flat-sibling-modules` — Files share prefix; convert to sub-package (see \u002Fcode-hygiene-refactor)\n- `oversized-module` — Module exceeds line threshold; split by responsibility\n- `god-class` — Class has too many methods; extract collaborators\n\n### Python (pyrefly\u002Fbasedpyright)\n- `unbound-name` — Variable may be uninitialized\n- `missing-attribute` — Method called on None\n- `bad-argument-type` — Type mismatch in function call\n- `untyped-import` — Missing type stubs\n- `not-iterable` — Async iteration issues\n\n### TypeScript (biome\u002Ftsc)\n- `noExplicitAny` — Replace Any with specific type\n- `noUnusedVariables` — Remove or use the variable\n- `useConst` — Prefer const over let\n\n### Rust (clippy)\n- `clippy::unwrap_used` — Handle errors properly\n- `clippy::expect_used` — Provide context or use ?\n- `dead_code` — Remove unused code\n\n## Resumption Protocol\n\nIf starting fresh after compaction:\n\n1. Read `.hygiene\u002Ftracking.json`\n2. Read `.hygiene\u002Fslopgate_lint.json`\n3. Continue from `tracking.json.iteration`\n4. Process `tracking.json.pending_items` by `stable-id`\n","# Hygiene Orchestrator\n\nCoordinate systematic elimination of linter warnings\u002Ferrors using parallelized agents, JSON-exported findings, and persistent progress tracking.\n\n## When to Use\n\nUse when the task is repo-wide, multi-file, or multi-rule Slopgate cleanup.\n\n- User asks to fix all warnings, clean up lints, pass the quality gate, or coordinate hygiene work.\n- `slopgate lint check --details` produces many findings that need grouping, tracking, and dispatch.\n- Multiple files or collectors are involved and progress needs a persistent `.hygiene\u002F` tracking artifact.\n- Use this as the coordinator; delegate local structural repairs to `slopgate-code-hygiene-refactor` and test gaps to `slopgate-test-extender`.\n\n## When Not to Use\n\nDo not use for a single hook denial or one touched file. Use `slopgate-code-hygiene-refactor` for local structure, `slopgate-code-smell-utility-locator` for helper\u002Fconstant ownership, and `slopgate-test-extender` for test-only findings.\n\nDo not use when the task is only to inspect current telemetry or explain a rule without applying a cleanup plan.\n\n## Critical Rules\n\n1. **NEVER run linters directly in terminal** — Use `slopgate lint check` (repo root, no path args) as the primary gate. Discover project-specific tools by inspecting `package.json`, `pyproject.toml`, `Cargo.toml`, etc.\n2. **Always export to JSON** — Lint outputs must be parsed into structured JSON for tracking and dispatch\n3. **Update tracking before context compaction** — Progress must survive context limits via `.hygiene\u002Ftracking.json`\n4. **Remind all agents about related skills** — Invoke `\u002Ftype-strictness` for type fixes, `\u002Fcode-hygiene-refactor` for structural issues, `\u002Ftest-extender` for coverage gaps\n\n## Workflow Overview\n\n```\n┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐\n│  1. Export      │───>│  2. Parse &      │───>│  3. Dispatch    │\n│  Lint Results   │    │  Group Issues    │    │  Parallel Agents│\n└─────────────────┘    └──────────────────┘    └─────────────────┘\n         ^                                              │\n         │              ┌──────────────────┐            │\n         └──────────────│  4. Validate &   │\u003C───────────┘\n                        │  Update Tracking │\n                        └──────────────────┘\n```\n\n## Phase 1: Export Lint Results\n\n### Primary: `slopgate lint check`\n\nRun from the repo root. No path argument is accepted.\n\n```bash\n# Basic run\nHOME=\u002Fhome\u002Ftrav \u002Fhome\u002Ftrav\u002F.local\u002Fbin\u002Fslopgate lint check\n\n# Detailed output with repair guidance\nHOME=\u002Fhome\u002Ftrav \u002Fhome\u002Ftrav\u002F.local\u002Fbin\u002Fslopgate lint check --details\n\n# Export to JSON for parsing (pipe stdout to a parser)\nHOME=\u002Fhome\u002Ftrav \u002Fhome\u002Ftrav\u002F.local\u002Fbin\u002Fslopgate lint check --details 2>&1 | \\\n  python3 \u002Fpath\u002Fto\u002Fskill\u002Fscripts\u002Fparse_slopgate_lint.py --output .hygiene\u002Fslopgate_lint.json\n```\n\nThe `--details` flag adds per-finding fields: `file`, `location`, `signature`, `detail`, `stable-id`, `prognosis`, `scaffold`, `metadata.*`, `agent-context`, `validation`, `verify`.\n\n### Secondary: project-specific lint tools\n\nIf the project uses additional linters beyond Slopgate, discover the correct invocation rather than assuming a Makefile:\n\n```bash\n# Look for common entrypoints\nls package.json 2>\u002Fdev\u002Fnull && npm run lint --silent 2>\u002Fdev\u002Fnull\nls pyproject.toml 2>\u002Fdev\u002Fnull && python3 -m ruff check . 2>\u002Fdev\u002Fnull\nls Cargo.toml 2>\u002Fdev\u002Fnull && cargo clippy --all-targets 2>\u002Fdev\u002Fnull\n```\n\nPipe any secondary lint output through a parser into `.hygiene\u002F` JSON or text. Do not assume `make` targets exist.\n\n## Phase 2: Parse and Group Issues\n\n### Parsing Slopgate Lint Output\n\nUse `scripts\u002Fparse_slopgate_lint.py` to parse `--details` output into structured JSON:\n\n```bash\npython \u002Fpath\u002Fto\u002Fskill\u002Fscripts\u002Fparse_slopgate_lint.py \\\n  --input \u003C(slopgate lint check --details 2>&1) \\\n  --output .hygiene\u002Fslopgate_lint.json\n```\n\nThe parser produces:\n\n```json\n{\n  \"header\": {\n    \"project\": \"\u002Fpath\u002Fto\u002Frepo\",\n    \"baseline\": \"\u002Fpath\u002Fto\u002Frepo\u002Fbaselines.json\"\n  },\n  \"summary\": {\n    \"collectors\": [\n      {\"name\": \"long-method\", \"total\": 3, \"new\": 2},\n      {\"name\": \"untested-production-code\", \"total\": 1, \"new\": 1}\n    ],\n    \"total_findings\": 4,\n    \"new_findings\": 3,\n    \"baseline_findings\": 1,\n    \"fixed_findings\": 0\n  },\n  \"findings\": [\n    {\n      \"status\": \"NEW\",\n      \"collector\": \"long-method\",\n      \"fields\": {\n        \"file\": \"src\u002Fmain.py\",\n        \"location\": \"src\u002Fmain.py:52\",\n        \"signature\": \"callable `f`\",\n        \"detail\": \"lines=52\",\n        \"stable-id\": \"long-method|src\u002Fmain.py|f|lines=52\",\n        \"prognosis\": \"function is doing multiple phases inline.\",\n        \"scaffold\": \"extract named helpers for parse\u002Fvalidate\u002Ftransform\u002Fpersist\u002Frender phases; keep data flow explicit.\"\n      }\n    }\n  ]\n}\n```\n\n### Grouping Strategy\n\nGroup issues into **non-conflicting batches** for parallel agent work:\n\n| Priority | Grouping Criteria | Rationale |\n|----------|-------------------|-----------|\n| 1 | By file (no overlaps) | Agents can't conflict on different files |\n| 2 | By collector \u002F error category | Similar fixes, consistent patterns |\n| 3 | By severity | Errors before warnings |\n| 4 | By dependency order | Fix imports\u002Ftypes before consumers |\n\n**Non-conflicting batch rules:**\n- Files in batch A share NO imports with files in batch B\n- Type definition files before files that use those types\n- Base classes before derived classes\n\nUse `stable-id` to deduplicate findings across iterations.\n\n## Phase 3: Dispatch Parallel Agents\n\n### Agent Configuration\n\nEach agent batch receives:\n1. **File list**: Non-overlapping with other batches\n2. **Issue manifest**: Specific findings with `stable-id`, `scaffold`, and `location`\n3. **Context reminder**: Relevant skills, project conventions\n\n### Dispatch Template\n\n```yaml\n# For each batch, spawn code-hygiene-enforcer agent:\nbatch_1:\n  files: [src\u002Fnoteflow\u002Fgrpc\u002F_mixins\u002Fannotation.py, src\u002Fnoteflow\u002Fgrpc\u002F_mixins\u002Fcalendar.py]\n  findings:\n    - stable-id: \"long-method|src\u002Fnoteflow\u002Fgrpc\u002F_mixins\u002Fannotation.py|parse|lines=65\"\n      scaffold: \"extract named helpers for parse\u002Fvalidate\u002Ftransform phases\"\n  agent: code-hygiene-enforcer\n  instructions: |\n    Fix the following issues. Remember: use \u002Ftype-strictness skill for all type fixes.\n    Never add # type: ignore. Update all dependent code.\n\nbatch_2:\n  files: [src\u002Fnoteflow\u002Fgrpc\u002F_mixins\u002Fproject\u002F_membership.py, src\u002Fnoteflow\u002Fgrpc\u002F_mixins\u002Fproject\u002F_mixin.py]\n  findings:\n    - stable-id: \"untested-production-code|src\u002Fnoteflow\u002Fgrpc\u002F_mixins\u002Fproject\u002F_membership.py|coverage-001\"\n      scaffold: \"add behavior tests for the unreferenced public symbols\"\n  agent: code-hygiene-enforcer\n  instructions: |\n    Fix None-safety issues. Add proper guards or update function signatures.\n    Use \u002Ftest-extender for test additions. Use \u002Ftype-strictness for type refinements.\n```\n\n### Parallel Execution\n\nUse Task tool to launch multiple agents simultaneously:\n\n```\nTask(subagent_type=\"code-hygiene-enforcer\", prompt=\"...\", run_in_background=true)\nTask(subagent_type=\"code-hygiene-enforcer\", prompt=\"...\", run_in_background=true)\n...\n```\n\nMonitor with `TaskOutput(task_id=..., block=true)`.\n\n## Phase 4: Validate and Update Tracking\n\n### Post-Agent Validation\n\nAfter each agent completes:\n\n1. **Re-run slopgate lint**:\n   ```bash\n   HOME=\u002Fhome\u002Ftrav \u002Fhome\u002Ftrav\u002F.local\u002Fbin\u002Fslopgate lint check --details 2>&1 | \\\n     python3 \u002Fpath\u002Fto\u002Fskill\u002Fscripts\u002Fparse_slopgate_lint.py --output .hygiene\u002Fslopgate_lint.json\n   ```\n\n2. **Verify no regressions** with the project's test command:\n   ```bash\n   # Discover the test runner; don't assume make\n   ls pytest.ini pyproject.toml tox.ini 2>\u002Fdev\u002Fnull && python3 -m pytest -q\n   ls package.json 2>\u002Fdev\u002Fnull && npm test --silent 2>\u002Fdev\u002Fnull\n   ls Cargo.toml 2>\u002Fdev\u002Fnull && cargo test --quiet 2>\u002Fdev\u002Fnull\n   ```\n\n3. **Check for new issues** introduced by fixes\n\n### Update Tracking File\n\nMaintain `.hygiene\u002Ftracking.json`:\n\n```json\n{\n  \"session_id\": \"2025-01-02T03:45:00Z\",\n  \"iteration\": 3,\n  \"repo\": \"\u002Fpath\u002Fto\u002Frepo\",\n  \"baseline\": \"\u002Fpath\u002Fto\u002Frepo\u002Fbaselines.json\",\n  \"initial_counts\": {\n    \"long-method\": 5,\n    \"untested-production-code\": 3,\n    \"repeated-code-block\": 12\n  },\n  \"current_counts\": {\n    \"long-method\": 1,\n    \"untested-production-code\": 0,\n    \"repeated-code-block\": 4\n  },\n  \"completed_items\": [\n    {\n      \"stable_id\": \"long-method|src\u002Ffoo.py|process|lines=68\",\n      \"file\": \"src\u002Ffoo.py\",\n      \"collector\": \"long-method\",\n      \"resolved_at\": \"2025-01-02T04:00:00Z\"\n    }\n  ],\n  \"pending_items\": [\n    {\n      \"stable_id\": \"long-method|src\u002Fbar.py|transform|lines=72\",\n      \"file\": \"src\u002Fbar.py\",\n      \"collector\": \"long-method\",\n      \"scaffold\": \"extract named helpers for transform\u002Fpersist phases\",\n      \"status\": \"open\"\n    }\n  ],\n  \"blocked_items\": [\n    {\n      \"stable_id\": \"repeated-code-block|src\u002Fqux.py|helper|lines 10-15\",\n      \"file\": \"src\u002Fqux.py\",\n      \"collector\": \"repeated-code-block\",\n      \"reason\": \"Requires architectural change — shared helper needs design review\"\n    }\n  ],\n  \"last_updated\": \"2025-01-02T04:15:00Z\"\n}\n```\n\nUse `stable-id` as the primary key for tracking individual findings across iterations.\n\n## Context Compaction Protocol\n\n**CRITICAL**: Before context limit is reached, MUST update:\n\n1. **tracking.json** with current progress\n2. **Todo list** with remaining work items\n3. **Memory** (if using Serena): Write to `hygiene_progress` memory\n\n### Handoff Message Template\n\n```yaml\nhygiene_handoff:\n  status: \"in_progress\"\n  iteration: 4\n  remaining_errors: 12\n  next_batch:\n    files: [list of files]\n    findings:\n      - stable-id: \"collector|file|signature|detail\"\n        scaffold: \"repair guidance from slopgate output\"\n  instructions: |\n    Continue hygiene orchestration from iteration 4.\n    Read .hygiene\u002Ftracking.json for full state.\n    Run \u002Fhygiene-orchestrator to resume.\n```\n\n## Iteration Loop\n\n```\nWHILE issues_remaining > 0:\n    1. Export fresh lint results (slopgate lint check --details)\n    2. Parse into JSON (parse_slopgate_lint.py)\n    3. Group into non-conflicting batches by stable-id\n    4. Dispatch agents in parallel\n    5. Wait for completion\n    6. Validate fixes (re-run slopgate lint check)\n    7. Update tracking.json\n    8. IF context_nearing_limit:\n           Write handoff state\n           EXIT with resume instructions\n    9. Increment iteration\n```\n\n## Available Commands\n\n| Command | Output | Description |\n|---------|--------|-------------|\n| `slopgate lint check` | stdout (human) | Repo-root lint, no path args |\n| `slopgate lint check --details` | stdout (human + repair guidance) | Detailed with prognosis\u002Fscaffold |\n| `parse_slopgate_lint.py` | `.hygiene\u002Fslopgate_lint.json` | Structured JSON from --details output |\n\nProject-specific tools (discover, don't assume):\n\n| Tool | Typical invocation |\n|------|-------------------|\n| ruff | `python3 -m ruff check .` |\n| basedpyright | `basedpyright --outputjson src\u002F` |\n| biome | `npx biome check .` |\n| tsc | `npx tsc --noEmit` |\n| clippy | `cargo clippy --all-targets` |\n| eslint | `npx eslint .` |\n\n## Skill Reminders\n\nAlways remind dispatched agents:\n\n1. **Use \u002Ftype-strictness skill** for type annotations\n2. **Use \u002Ftest-extender skill** when modifying tested code or adding coverage\n3. **Use \u002Fcode-hygiene-refactor skill** for structural issues (flat siblings, oversized modules, god classes)\n4. **Never use # type: ignore** — fix the underlying issue\n5. **Never use Any** unless absolutely unavoidable\n6. **Update all callers** when changing signatures\n7. **Run tests** after fixes: `pytest \u003Caffected_tests>`\n\n## Error Categories Reference\n\n### Slopgate collectors (common)\n- `long-method` — Function exceeds line threshold; extract helpers\n- `repeated-code-block` — Duplicated behavior; extract shared helper\u002Fservice\n- `untested-production-code` — Public symbols lack test references; add behavior tests\n- `flat-sibling-modules` — Files share prefix; convert to sub-package (see \u002Fcode-hygiene-refactor)\n- `oversized-module` — Module exceeds line threshold; split by responsibility\n- `god-class` — Class has too many methods; extract collaborators\n\n### Python (pyrefly\u002Fbasedpyright)\n- `unbound-name` — Variable may be uninitialized\n- `missing-attribute` — Method called on None\n- `bad-argument-type` — Type mismatch in function call\n- `untyped-import` — Missing type stubs\n- `not-iterable` — Async iteration issues\n\n### TypeScript (biome\u002Ftsc)\n- `noExplicitAny` — Replace Any with specific type\n- `noUnusedVariables` — Remove or use the variable\n- `useConst` — Prefer const over let\n\n### Rust (clippy)\n- `clippy::unwrap_used` — Handle errors properly\n- `clippy::expect_used` — Provide context or use ?\n- `dead_code` — Remove unused code\n\n## Resumption Protocol\n\nIf starting fresh after compaction:\n\n1. Read `.hygiene\u002Ftracking.json`\n2. Read `.hygiene\u002Fslopgate_lint.json`\n3. Continue from `tracking.json.iteration`\n4. Process `tracking.json.pending_items` by `stable-id`\n",{"name":5,"author":52,"license":15,"version":53,"metadata":54,"description":78,"compatibility":79},"Slopgate","1.0.0",{"hermes":55,"slopgate":64},{"tags":56,"related_skills":60},[57,58,31,59,27],"slopgate","lint","bulk-remediation",[61,62,63],"slopgate-code-hygiene-refactor","slopgate-test-extender","slopgate-code-smell-utility-locator",{"rule_ids":65,"activation":69},[66,67,68],"QUALITY-LINT-001","PY-CODE-017","PY-CODE-018",{"avoid":70,"primary":74},[71,72,73],"single local denial","one-file refactor","test-only coverage gap",[75,76,77],"repo-wide lint cleanup","multi-file hook remediation","slopgate lint tracking","Orchestrate systematic elimination of linter warnings and errors across Python, TypeScript, and Rust codebases. Use when asked to \"clean up lints\", \"fix all warnings\", \"run hygiene\", \"eliminate type errors\", \"orchestrate code quality fixes\", \"fix lint errors\", \"resolve quality gate failures\", \"pass CI checks\", \"reduce tech debt\", \"refactor to pass hooks\", or when a Slopgate hook denies with QUALITY-LINT-001, PY-CODE-017, PY-CODE-018, or any collector finding. This skill coordinates multiple code-hygiene-enforcer agents working in parallel on non-conflicting file groupings, tracks progress persistently via JSON exports, and loops until all issues are resolved. CRITICAL: Never run linters directly—always use `slopgate lint check` as the primary gate, discover project-specific tools from config files, and export findings to JSON for tracking.\n","claude-code, opencode, codex, hermes, slopgate","master","5fab8004af1390aa17b3447f2780766c8bf2482c",".codex\u002Fskills\u002Fslopgate-hygiene-orchestrator",0,"https:\u002F\u002Fgithub.com\u002Fvasceannie\u002Fslopgate","https:\u002F\u002Fgithub.com\u002Fvasceannie","thingswithstuff.io","2026-11-12 20:22:46",{"source":8,"skillName":5,"commands":89,"prompt":99,"zipAvailable":100},[90,93,96],{"tool":91,"command":92},"npx","npx skills add vasceannie\u002Fslopgate --skill slopgate-hygiene-orchestrator",{"tool":94,"command":95},"bunx","bunx skills add vasceannie\u002Fslopgate --skill slopgate-hygiene-orchestrator",{"tool":97,"command":98},"pnpm","pnpm dlx skills add vasceannie\u002Fslopgate --skill slopgate-hygiene-orchestrator","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fvasceannie\u002Fslopgate\u002Fblob\u002Fmaster\u002F.codex\u002Fskills\u002Fslopgate-hygiene-orchestrator\u002FSKILL.md",true,[102,108,114,118],{"path":103,"resourceType":104,"resourceTypeDesc":105,"sizeBytes":106,"sourceHtmlUrl":107},"references\u002Fgrouping_strategies.md","REFERENCE","参考文档",8975,"https:\u002F\u002Fgithub.com\u002Fvasceannie\u002Fslopgate\u002Fblob\u002Fmaster\u002F.codex\u002Fskills\u002Fslopgate-hygiene-orchestrator\u002Freferences\u002Fgrouping_strategies.md",{"path":109,"resourceType":110,"resourceTypeDesc":111,"sizeBytes":112,"sourceHtmlUrl":113},"scripts\u002Fparse_lints.py","SCRIPT","脚本",9663,"https:\u002F\u002Fgithub.com\u002Fvasceannie\u002Fslopgate\u002Fblob\u002Fmaster\u002F.codex\u002Fskills\u002Fslopgate-hygiene-orchestrator\u002Fscripts\u002Fparse_lints.py",{"path":115,"resourceType":110,"resourceTypeDesc":111,"sizeBytes":116,"sourceHtmlUrl":117},"scripts\u002Fparse_slopgate_lint.py",3595,"https:\u002F\u002Fgithub.com\u002Fvasceannie\u002Fslopgate\u002Fblob\u002Fmaster\u002F.codex\u002Fskills\u002Fslopgate-hygiene-orchestrator\u002Fscripts\u002Fparse_slopgate_lint.py",{"path":119,"resourceType":110,"resourceTypeDesc":111,"sizeBytes":120,"sourceHtmlUrl":121},"scripts\u002Fupdate_tracking.py",4409,"https:\u002F\u002Fgithub.com\u002Fvasceannie\u002Fslopgate\u002Fblob\u002Fmaster\u002F.codex\u002Fskills\u002Fslopgate-hygiene-orchestrator\u002Fscripts\u002Fupdate_tracking.py",[123,150,174,208,215,235],{"skillNo":124,"name":125,"nameZh":6,"description":126,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":127,"categories":128,"keywords":130,"publishedAt":47},"01M71951JDWCYMS8GDC2C7395D","type-strictness","Enforce strict type compliance by eliminating `Any` types and `# type: ignore` comments. Use when:\n(1) Editing code that contains `Any` as a type annotation\n(2) Code has `# type: ignore` or `# pyright: ignore` comments\n(3) User requests type fixes or type strictness enforcement\n(4) Importing from untyped third-party libraries\n(5) User asks to \"fix types\", \"remove Any\", or \"add proper typing\"\n(6) Pyrefly or mypy reports type errors that need resolution\n(7) Code review reveals weak typing patterns\nFollows hierarchical resolution: codebase inference → type stubs → library inspection → type guards → casting (last resort).","https:\u002F\u002Fgithub.com\u002Fvasceannie\u002Fslopgate\u002Fblob\u002Fmaster\u002Fbundle\u002Fshared\u002Fskills\u002Ftype-strictness\u002FSKILL.md",[129],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[131,132,133,134,135,136,45,137,138,139,140,141,142,143,144,145,146,147,148,149],"type","type strictness","typing","types","remove","code review","errors","inspection","when","code","review","reports","libraries","casting","pyrefly","mypy","pyright","library","patterns",{"skillNo":151,"name":62,"nameZh":6,"description":152,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":153,"categories":154,"keywords":159,"publishedAt":47},"01M7194XGBQXSE7Y5BZ4K5CSTK","Extend Python test suites with parametrization, fixture reuse, and quality enforcement. Use when asked to add tests, extend existing tests, improve test coverage, consolidate duplicate tests, fix test quality issues, or when Slopgate reports untested-production-code, missing test references, or coverage gaps. Triggers on requests like \"add tests for X\", \"extend these tests\", \"parametrize tests\", \"consolidate tests\", \"fix test quality\", \"improve test coverage\", \"write tests for this function\", \"test this module\", \"behavior tests\", \"integration tests\", \"missing tests\", \"coverage holes\", \"untested code\", or when a hook denies with test-related findings.","https:\u002F\u002Fgithub.com\u002Fvasceannie\u002Fslopgate\u002Fblob\u002Fmaster\u002Fbundle\u002Fshared\u002Fskills\u002Fslopgate-test-extender\u002FSKILL.md",[155,156],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":157,"categoryName":158,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000008","测试与质量",[160,161,162,163,164,45,165,166,167,168,39,169,139,140,170,171,142,172,173,28],"slopgate test extender","test","coverage","fixture","testing","issues","write tests","improve","only","loop","candidate","consolidate","references","opencode",{"skillNo":175,"name":176,"nameZh":6,"description":177,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":178,"categories":179,"keywords":193,"publishedAt":47},"01M7194RMVQS5YJJ4ZEFXX20VS","slopgate-intelligent-coding-patterns","Pattern-selection playbook for agents editing code with complex branching, stateful parsers\u002Fworkflows, duplicated skeletons, policy checks, or ordered transforms. Load before refactoring if\u002Felif dispatch chains, boolean-flag state machines, repeated validation predicates, parallel provider\u002Flanguage implementations, or regex\u002Fcontent transformation pipelines. Also load when asked to \"apply a design pattern\", \"which pattern should I use here\", \"refactor this switch statement\", \"replace if-elif chain\", \"state machine pattern\", \"strategy pattern\", \"template method\", \"pipeline pattern\", \"specification pattern\", \"dispatch table\", \"guard clause refactor\", \"reduce cyclomatic complexity\", or when Slopgate fires PY-CODE-014, PY-CODE-017, PY-CODE-018, QUALITY-LINT-001, or PY-QUALITY-010. Use with behavior-locking tests and avoid pattern theater for simple one-off code.","https:\u002F\u002Fgithub.com\u002Fvasceannie\u002Fslopgate\u002Fblob\u002Fmaster\u002Fbundle\u002Fshared\u002Fskills\u002Fslopgate-intelligent-coding-patterns\u002FSKILL.md",[180,181,184,185,190],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":182,"categoryName":183,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":186,"categoryName":187,"taxonomyType":188,"taxonomyTypeDesc":189},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",{"categoryNo":191,"categoryName":192,"taxonomyType":188,"taxonomyTypeDesc":189},"01JBSEEDCAT000000000000032","设计师",[194,195,149,196,197,198,199,200,201,202,203,204,205,168,39,206,207,139,38,140],"coding patterns","slopgate intelligent coding patterns","coding","stateful","complexity","branch","which","chain","parsers","pipeline","selection","design","utility","workflows",{"skillNo":209,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":210,"categories":211,"keywords":214,"publishedAt":47},"01M7194KTXBM85GB0W7JKFQD55","https:\u002F\u002Fgithub.com\u002Fvasceannie\u002Fslopgate\u002Fblob\u002Fmaster\u002Fbundle\u002Fshared\u002Fskills\u002Fslopgate-hygiene-orchestrator\u002FSKILL.md",[212,213],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},[29,27,28,46,45,44,43,42,41,40,39,38,37,36,35,34,33,32,31,30],{"skillNo":216,"name":63,"nameZh":6,"description":217,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":218,"categories":219,"keywords":222,"publishedAt":47},"01M7194G50FZYXXT8VNK360RPA","Autoactivate when code-smell hooks or reviews mention feature envy, thin wrappers, duplicate helpers, duplicate code,\nscattered helpers, builders\u002Ffactories\u002Fconfig\u002Fconstants\u002Fdataclass reuse, PY-CODE-012, PY-CODE-013, QUALITY-LINT-001,\nor repeated slopgate code-quality denials. Also load when asked to \"find existing helpers\", \"consolidate utilities\",\n\"search for duplicate code\", \"where is this already implemented\", \"reuse existing logic\", \"don't duplicate this\",\n\"find similar functions\", \"utility inventory\", \"code smell radar\", or before adding new helpers\u002Fwrappers so agents can\nfind existing shared utilities and consolidate instead of duplicating.","https:\u002F\u002Fgithub.com\u002Fvasceannie\u002Fslopgate\u002Fblob\u002Fmaster\u002Fbundle\u002Fshared\u002Fskills\u002Fslopgate-code-smell-utility-locator\u002FSKILL.md",[220,221],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":186,"categoryName":187,"taxonomyType":188,"taxonomyTypeDesc":189},[206,223,140,224,162,225,226,227,228,168,229,139,230,171,173,231,232,34,233,234],"slopgate code smell utility locator","shared","reviews","inventory","search","hooks","new","coordination","radar","code-quality","Utilities","dataclass",{"skillNo":236,"name":61,"nameZh":6,"description":237,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":238,"categories":239,"keywords":242,"publishedAt":47},"01M7194AWG1Q37F9756H4SFDH9","Recovery playbook for Slopgate and project quality failures. Load after hook\u002Flint denials such as PY-CODE-017 flat sibling modules, PY-CODE-018 oversized modules, QUALITY-LINT-001 post-edit quality backstops, PY-QUALITY-010 magic numbers \u002F repeated literals, PY-CODE-012\u002FPY-CODE-013 smell findings, type-suppression bans, duplicate helpers, or repeated hygiene retry loops. Also load when asked to \"refactor this module\", \"split this file\", \"extract a class\", \"reduce complexity\", \"fix god class\", \"flatten module hierarchy\", \"move code to a package\", \"extract helpers\", \"consolidate duplicates\", \"replace magic numbers with constants\", or when a hook blocks an edit with structural complaints. Focuses on preserving public APIs while refactoring toward packages, cohesive modules, typed seams, and focused tests.","https:\u002F\u002Fgithub.com\u002Fvasceannie\u002Fslopgate\u002Fblob\u002Fmaster\u002Fbundle\u002Fshared\u002Fskills\u002Fslopgate-code-hygiene-refactor\u002FSKILL.md",[240,241],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":186,"categoryName":187,"taxonomyType":188,"taxonomyTypeDesc":189},[243,244,140,245,27,246,198,247,248,46,249,226,250,45,168,206,139,38,230,171],"code hygiene","slopgate code hygiene refactor","refactor","modules","duplicates","retry","move","structural"]