[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6PVB46B1RX4PV1JDFRD5YWK":3,"skill-same:01M6PVB46B1RX4PV1JDFRD5YWK":62},{"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":18,"publishedAt":28,"linkOnly":29,"markdownContent":30,"markdownBody":31,"frontMatter":32,"refName":36,"commitSha":37,"skillDirectory":38,"forksCount":35,"repositoryHtmlUrl":39,"repositoryHomepageUrl":6,"ownerHtmlUrl":40,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":41,"install":42,"resources":55},"01M6PVB46B1RX4PV1JDFRD5YWK","worktree-venv",null,"Provisions a Python venv inside every freshly created worktree — infrastructure only, no agent-side decision logic","muratovv\u002Fai-hats","muratovv","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F7502801?v=4","01M6JGCBN4KEJX012GPJVSH04T","Fedor Muratov","01M6JGCBSNMN7CW3RGTPPE0MN2",3,"MIT","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fai-hats-dev\u002Fskills\u002Fworktree-venv\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27],"worktree","venv","worktree venv","python","infrastructure","decision","only","logic","python venv","2026-11-10 10:12:30",false,"---\nname: worktree-venv\ndescription: >-\n  Provisions a Python venv inside every freshly created worktree —\n  infrastructure only, no agent-side decision logic\nai_hats:\n  schema_version: 1\n  type: skill\n  # hook-carrier skill. The lifecycle bundle spawns this script in\n  # place from the skill dir after `git worktree add` (a migration retired the\n  # materialized wt-hooks tree; `migrations.py` sweeps what it left behind).\nlicense: MIT\n---\n\n# worktree-venv\n\n`hooks\u002Fprovision-venv.sh` runs after `git worktree add` and mints a `.venv` in\nthe new worktree: `uv venv`, then one editable `uv pip install` over the root\nproject and every `packages\u002F**\u002Fpyproject.toml`.\n\nWithout it the worktree's `sys.executable` is the main checkout's, whose\neditable install points at main — so the e2e tier (which strips `PYTHONPATH` by\ndesign) tests the wrong source and the guard blocks the\nfirst commit. The paired half is the `git-mastery` smoke hook preferring\n`\u003Cgit-toplevel>\u002F.venv\u002Fbin\u002Fpytest`; neither half works alone.\n\n## Conventions\n\n- **Warn-continue** (ADR-0012 D3\u002FD7). Every declining path exits 0: no root\n  `pyproject.toml`, `.venv\u002Fbin\u002Fpython` already present (idempotent), no `uv` on\n  PATH, or a failed install. Each leaves a worktree without `.venv` — the\n  status quo before this hook, never worse.\n- **Bounded** by the 45s `wt_in` budget; a timeout is a WARN, not a failed\n  create. Cost when it runs: ~1–2s on a warm uv cache.\n- **Unpinned by necessity** — the repo gitignores `uv.lock`, so the install\n  resolves fresh and a worktree venv may carry newer dev tools than an older\n  main venv.\n\n## References\n\n- Paired hook: `packages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fcore\u002Fskills\u002Fgit-mastery\u002Fgit_hooks\u002Fpre-commit-smoke.sh`\n- Hook contract: `docs\u002Fhow-to-extend.md#worktree-lifecycle-hooks`\n","# worktree-venv\n\n`hooks\u002Fprovision-venv.sh` runs after `git worktree add` and mints a `.venv` in\nthe new worktree: `uv venv`, then one editable `uv pip install` over the root\nproject and every `packages\u002F**\u002Fpyproject.toml`.\n\nWithout it the worktree's `sys.executable` is the main checkout's, whose\neditable install points at main — so the e2e tier (which strips `PYTHONPATH` by\ndesign) tests the wrong source and the guard blocks the\nfirst commit. The paired half is the `git-mastery` smoke hook preferring\n`\u003Cgit-toplevel>\u002F.venv\u002Fbin\u002Fpytest`; neither half works alone.\n\n## Conventions\n\n- **Warn-continue** (ADR-0012 D3\u002FD7). Every declining path exits 0: no root\n  `pyproject.toml`, `.venv\u002Fbin\u002Fpython` already present (idempotent), no `uv` on\n  PATH, or a failed install. Each leaves a worktree without `.venv` — the\n  status quo before this hook, never worse.\n- **Bounded** by the 45s `wt_in` budget; a timeout is a WARN, not a failed\n  create. Cost when it runs: ~1–2s on a warm uv cache.\n- **Unpinned by necessity** — the repo gitignores `uv.lock`, so the install\n  resolves fresh and a worktree venv may carry newer dev tools than an older\n  main venv.\n\n## References\n\n- Paired hook: `packages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fcore\u002Fskills\u002Fgit-mastery\u002Fgit_hooks\u002Fpre-commit-smoke.sh`\n- Hook contract: `docs\u002Fhow-to-extend.md#worktree-lifecycle-hooks`\n",{"name":5,"ai_hats":33,"license":15,"description":7},{"type":34,"schema_version":35},"skill",1,"master","f922a7f627276366873d546942d9ad899a86f71a","packages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fai-hats-dev\u002Fskills\u002Fworktree-venv","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats","https:\u002F\u002Fgithub.com\u002Fmuratovv","2026-11-05 20:59:10",{"source":8,"skillName":5,"commands":43,"prompt":53,"zipAvailable":54},[44,47,50],{"tool":45,"command":46},"npx","npx skills add muratovv\u002Fai-hats --skill worktree-venv",{"tool":48,"command":49},"bunx","bunx skills add muratovv\u002Fai-hats --skill worktree-venv",{"tool":51,"command":52},"pnpm","pnpm dlx skills add muratovv\u002Fai-hats --skill worktree-venv","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fai-hats-dev\u002Fskills\u002Fworktree-venv\u002FSKILL.md",true,[56],{"path":57,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":60,"sourceHtmlUrl":61},"hooks\u002Fprovision-venv.sh","SCRIPT","脚本",4599,"https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fai-hats-dev\u002Fskills\u002Fworktree-venv\u002Fhooks\u002Fprovision-venv.sh",[63,90,115,138,162,175],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":28},"01M6PVFB1SM738R2SRSRSF7CY6","tool-evaluation-protocol","Time-bounded protocol for evaluating new tools, libraries, or methodologies before adoption. Use when evaluating a candidate dependency for the project, researching a methodology (e.g. ML\u002FLLM frameworks, testing approaches), or following up on a hype-driven recommendation.","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fusage\u002Fskills\u002Ftool-evaluation-protocol\u002FSKILL.md",[],[70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89],"protocol","Evaluation","tool","tool evaluation protocol","testing","ml","libraries","adoption","methodology","Tools","use","dependency","up","frameworks","time","project","recommendation","for","bounded","candidate",{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":28},"01M6PVF7HATBEX1G7N50E2QT57","systematic-debugging","4-phase bug-fix protocol (evidence, pattern, hypothesis, verify). Use when investigating any error, failure, or unexpected behavior, handling bug reports from users or monitoring, or diagnosing test failures with non-obvious causes.","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fusage\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[97,98,99,100,70,101,102,103,104,105,80,106,107,108,109,110,111,112,113,114],"systematic debugging","debugging","systematic","test","monitoring","hypothesis","verify","behavior","fix","evidence","bug","reports","pattern","users","error","with","bug-fix","phase",{"skillNo":116,"name":117,"nameZh":6,"description":118,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":119,"categories":120,"keywords":126,"publishedAt":28},"01M6PVF3MTQN3RPF73AN34856J","skill-template","Canonical template and validation guide for ai-hats skills. Use when creating a new skill, reviewing an existing one for structural compliance, or deciding which pattern fits a new behavior.","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fusage\u002Fskills\u002Fskill-template\u002FSKILL.md",[121],{"categoryNo":122,"categoryName":123,"taxonomyType":124,"taxonomyTypeDesc":125},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[127,128,129,130,131,104,132,80,133,109,134,135,136,87,137],"template","skill template","validation","compliance","hats","guide","new skill","structural","canonical","which","Existing",{"skillNo":139,"name":140,"nameZh":6,"description":141,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":142,"categories":143,"keywords":145,"publishedAt":28},"01M6PVF06SCV28QARM5MQPANC9","skill-optimization","Audit and refactor library components to eliminate redundancy and staleness. Use during periodic library maintenance, after adding multiple new skills or rules, when a role's token budget is too high, or after retrospectives identify component issues.","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fusage\u002Fskills\u002Fskill-optimization\u002FSKILL.md",[144],{"categoryNo":122,"categoryName":123,"taxonomyType":124,"taxonomyTypeDesc":125},[146,147,148,149,150,151,152,153,154,155,80,156,157,158,159,160,161],"Optimization","skill optimization","components","component","issues","library","audit","refactor","Budget","Rules","periodic","maintenance","token","token budget","role","high",{"skillNo":163,"name":164,"nameZh":6,"description":165,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":166,"categories":167,"keywords":168,"publishedAt":28},"01M6PVEXM9717016T9MW82HDCT","silent-fallback-gate","PreToolUse hook — refuses an Edit or Write that adds an inert broad except. Use when a Python edit was blocked for a silent fallback.","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fusage\u002Fskills\u002Fsilent-fallback-gate\u002FSKILL.md",[],[169,170,171,22,172,173,80,174,87],"gate","fallback","silent fallback gate","write","edit","hook",{"skillNo":176,"name":177,"nameZh":6,"description":178,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":179,"categories":180,"keywords":182,"publishedAt":28},"01M6PVESM49C5NT7SB7N3F76VS","retro-to-framework","Convert an observation about agent behavior — from a retrospective or from a single incident — into a framework-level change (hook, rule, skill, skill update). Use after a retrospective identifies problems that are not project-specific, after an incident where an agent misapplied a component it had read, when CLAUDE.md band-aids accumulate (more than 3 per-project rules that could be generic), or when the same problem recurs across multiple projects.","https:\u002F\u002Fgithub.com\u002Fmuratovv\u002Fai-hats\u002Fblob\u002Fmaster\u002Fpackages\u002Fai-hats-library\u002Fsrc\u002Fai_hats_library\u002Fexperimental\u002Fusage\u002Fskills\u002Fretro-to-framework\u002FSKILL.md",[181],{"categoryNo":122,"categoryName":123,"taxonomyType":124,"taxonomyTypeDesc":125},[183,184,185,186,149,187,188,189,155,104,80,190,191,85,192,193,194,195,196,197],"framework","retro","retro to framework","change","retrospective","projects","convert","incident","across","problem","about","more","skill update","single","generic"]