AgentSkillsCN

python-egg-info-hygiene

处理由可编辑安装（uv）生成的 src/*.egg-info 文件带来的嘈杂 Git 差异，并决定是提交这些更改，还是选择忽略。

SKILL.md
--- frontmatter
name: python-egg-info-hygiene
description: Handle noisy git diffs from src/*.egg-info generated by editable installs (uv) and decide whether to commit or ignore.
license: MIT
compatibility: opencode,claude
metadata:
  created_at: "2026-01-30T00:40:06.910Z"
  updated_at: "2026-01-30T00:40:06.910Z"
  version: "1"
<!-- BEGIN:compound:skill-managed -->

Purpose

Reduce churn from auto-generated src/*.egg-info changes (ex: PKG-INFO, requires.txt).

When To Use

  • •git status / diff shows only src/*.egg-info/** modifications.
  • •The churn appears after uv sync, uv pip install -e ., or packaging metadata updates.

Checklist

  • •Confirm scope: changes are limited to src/*.egg-info/**.
  • •Treat as generated by default:
    • •Do not commit unless the repo intentionally tracks *.egg-info.
    • •Call out that editable installs can rewrite these files.
  • •If a commit is requested anyway:
    • •Verify the repo convention (historical commits include src/*.egg-info/**).
    • •Ensure the underlying source of truth (ex: pyproject.toml) was actually updated.
    • •Prefer committing the source-of-truth change over committing generated metadata.
  • •If the user wants to clean the workspace (local-only):
    • •Recommend removing src/*.egg-info and re-running uv pip install -e . to regenerate.

Notes

  • •*.egg-info is typically build/install output; committing it often creates noisy diffs.
<!-- END:compound:skill-managed -->

Manual notes

This section is preserved when the skill is updated. Put human notes, caveats, and exceptions here.