菜单
Python conventions for this user — underscore-prefix everything that is not public API, plus uv inline script metadata and typer for CLIs. Load before writing or editing any .py file.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/povilasb/unix-configs --skill python命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
| name | python |
| description | Python conventions for this user — underscore-prefix everything that is not public API, plus uv inline script metadata and typer for CLIs. Load before writing or editing any .py file. |
import typing as t for succinct code.Anything not part of a module's public API is _-prefixed: functions, classes,
module-level helpers, constants that callers have no business reading. PEP 8's
rule, applied strictly — "nothing outside imports this" is not enough, the name
has to say so.
For a script, the public API is usually just main. Everything it calls is
private:
def _read_keys(path: pathlib.Path) -> list[str]: ...
def _render(source: pathlib.Path, dest: pathlib.Path) -> None: ...
def _fail(message: str) -> None: ...
def main() -> None:
...
Not:
def read_keys(path): ... # reads like an exported helper
def render(source, dest): ...
For a library module, the public API is what the package intends callers to
use; helpers behind it are still _-prefixed.
Applies to classes (class _Tunnel:) too.
And constants:
_MYSQL_PORT = 3306
Do not rename existing public names in code you did not write as a drive-by. Follow the rule for what you add; if the surrounding file predates it and would benefit, say so and let the user decide.
Standalone scripts declare their dependencies inline (PEP 723) and run under
uv — no requirements.txt, no venv to activate:
#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.12"
# dependencies = ["typer", "pymysql>=1.1"]
# ///
Invoke as uv run scripts/thing.py.
Not argparse, for anything new. Arguments and options are typed with
Annotated, and errors exit through typer rather than sys.exit:
def main(
env: Annotated[str, typer.Argument(help='environment name, e.g. "live"')],
source: Annotated[str, typer.Option("--from", help="template env")] = "dev",
force: Annotated[bool, typer.Option("--force")] = False,
) -> None:
...
if __name__ == "__main__":
typer.run(main)
def _fail(message: str) -> None:
typer.secho(message, fg=typer.colors.RED, err=True)
raise typer.Exit(1)