菜单
Use when implementing or refactoring Python in [ORG_NAME] product code or repo scripts: CLI design (argparse/Typer), exit codes, logging, pathlib, typing, pytest, and Ruff/Mypy per pyproject.toml.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
AI feature engineering — llama, embeddings, RAG quality, inference reliability, cost/token discipline.
System architecture, structured code review bar, and technical documentation.
Backend HTTP API, SQLite, Qdrant, integration contracts, schema and migration safety.
Maturity / inspection pass over [ORG_NAME] code sections (BCS). Load your org’s code-sections ledger, run verify ladder, update shared_context summary on main when columns change.
Data pipelines, ingest, remediation, entity quality — PDF/docs through to vector store.
Decision continuity, handoffs, supersession — Engineering Orchestrator (Mike) accountable; pair with session-notes.
| name | python-quality-and-cli |
| description | Use when implementing or refactoring Python in [ORG_NAME] product code or repo scripts: CLI design (argparse/Typer), exit codes, logging, pathlib, typing, pytest, and Ruff/Mypy per pyproject.toml. |
[PRODUCT_CODE_ROOT]/ (API, packages, scripts, tests).scripts/, __main__, maintenance utilities).[PRODUCT_CODE_ROOT]/docs/engineering/PYTHON_LAW_v1.md — locked law (layers, contracts, scripts, tooling, learn-as-you-go).shared_context/python_agent_coding_hygiene_v1.md — supplementary habits + founder link map.[PRODUCT_CODE_ROOT]/pyproject.toml — [tool.ruff], [tool.mypy], dependencies..cursor/rules/method-python-law.mdc — applies when editing [PRODUCT_CODE_ROOT]/**/*.py.[PRODUCT_CODE_ROOT]/services/api/, [PRODUCT_CODE_ROOT]/packages/, [PRODUCT_CODE_ROOT]/tests/ — match local patterns; golden pair: services/api/routes/ingest.py + services/api/ingest.py.| Topic | Guidance |
|---|---|
| Parser | argparse unless repo already uses Typer/Click for that entrypoint. |
| Help | --help accurate; subcommands documented. |
| Exit codes | 0 ok; non-zero on error; parse errors → 2 (argparse default). |
| Validation | Ports, paths, choices — at parse time when possible. |
| Output | User messages to stdout; errors to stderr for scriptability. |
# From [PRODUCT_CODE_ROOT]/ package root (adjust if monorepo docs say otherwise)
python -m pytest
ruff check .
mypy . # if configured for scope you touched
except: passprint() in shared library paths instead of logging--help or misleading help textsession-notes/SKILL.md — log session outcomes after larger refactors.gate-check/SKILL.md — gate evidence when changes touch release criteria.