AgentSkillsCN

author-agents-md-uv-python

为基于 uv（ruff/mypy/pytest）驱动的 Python 仓库，创建/更新 AGENTS.md 文件，其中包含单测命令与编辑器规则的发现过程。

SKILL.md
--- frontmatter
name: author-agents-md-uv-python
description: Create/update AGENTS.md for a Python repo driven by uv (ruff/mypy/pytest), including single-test commands and editor rule discovery.
license: MIT
compatibility: opencode,claude
metadata:
  created_at: "2026-01-29T05:13:10.069Z"
  updated_at: "2026-01-29T05:13:10.069Z"
  version: "1"
<!-- BEGIN:compound:skill-managed -->

Purpose

Create or improve AGENTS.md for a Python repo that uses uv.

When To Use

  • •User asks to create/update AGENTS.md.
  • •Repo uses uv (e.g., uv.lock, CI uses setup-uv).

Procedure

  • •Read existing AGENTS.md and preserve any tool-managed fences (do not edit inside).
  • •Add hard rules section if applicable:
    • •Use uv only.
    • •No Poetry (poetry, poetry.lock).
    • •No Black if repo uses ruff format.
  • •Discover editor rules:
    • •.cursorrules, .cursor/rules/**, .github/copilot-instructions.md.
  • •Discover commands from pyproject.toml, .github/workflows/**, README.md, docs/**, .pre-commit-config.yaml.
  • •Write UV-first commands:
    • •Setup: uv sync --dev, then uv pip install -e ..
    • •Format: uv run ruff format ....
    • •Lint: uv run ruff check ... (+ --fix).
    • •Typecheck: uv run mypy ....
    • •Tests: include single file + single node id + markers.
    • •Integration: include docker-compose steps and any helper scripts.
    • •Docs: uv run sphinx-build ... if present.
  • •Keep the file concise (~150 lines) and copy/paste friendly.
<!-- END:compound:skill-managed -->

Manual notes

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