- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add sno-ai/sno-station-skills --skill python-coder -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add sno-ai/sno-station-skills --skill python-coder -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add sno-ai/sno-station-skills --skill python-coder -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add sno-ai/sno-station-skills --skill python-coder -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/sno-ai/sno-station-skills/tree/HEAD/plugins/sno-station-standalone/skills/python-coder來自發布者
Every development task has a finite budget including setup, tests, and reporting. Before running tests, estimate duration from available timings and identify the changed behavior or directly affected consumer. If timing is unknown, state an estimate; do not build a timing system or run a preliminary suite. Full evaluation, unit, integration, or repository suites require the owner's explicit request, never a skill, PRD, review, or default command. Remove checks that neither prove the requested main function nor expose its defects. Repeat only after a relevant change or failure. Every new security check requires the owner's explicit approval for that specific check; remove auxiliary security, assertion, hash, or bookkeeping blockers of useful work.
Write production Python that fits the current repository, stays small, and is easy to verify. Local repo instructions add project-specific detail; they do not weaken these rules.
Honor the Python version declared by the user or the repository (pyproject.toml requires-python, .python-version, setup.cfg, tox.ini, CI, package metadata). Never emit syntax, stdlib APIs, or typing features newer than the target. For 3.14+ targets, prefer 3.14 idioms where they improve clarity or correctness: lazy annotations (PEP 649), InterpreterPoolExecutor (PEP 734), t-strings (PEP 750), free-threading awareness (PEP 779).
Intent: types make illegal states unrepresentable, data structures replace branches, and every line is a liability that must earn its place.
Types
Any. Use object + narrowing, generics, or TypedDict. cast() only at validated boundaries, with a comment saying why.Literal[...] over bare str; TypedDict over dict[str, Any] — split required/optional via a required base class + total=False subclass so guaranteed keys stay guaranteed.Protocol over ABC (structural typing, stub-friendly testing); class hierarchies max 1 level — favor composition.@dataclass(frozen=True, slots=True) for value objects with behavior; TypedDict for data crossing boundaries (JSON, APIs, configs).T | None over Optional[T]; type X = ... aliases (3.12+); typing.Self for fluent/builder methods; @overload when the return type depends on an argument; ClassVar[T] for class-level state.Sequence/Mapping/Iterable from collections.abc) in parameters, concrete types in returns. Explicit return types on public functions.from __future__ import annotations: omit on 3.14+ targets and remove it from files you edit there; on older targets follow the repo's existing annotation strategy — do not remove it opportunistically.if TYPE_CHECKING: for heavy or cycle-prone imports.Structure & errors
except:; no mutable default arguments; no magic strings/numbers (constants or Literal).finally.__all__ declares each module's public API. Pure logic in the core, side effects at the edges.Counter, defaultdict, itertools.Async & parallelism
asyncio.TaskGroup over gather() — structured cancellation, no orphaned tasks.InterpreterPoolExecutor over ProcessPoolExecutor (3.14+); keep threads for I/O.threading.Lock / asyncio.Lock) — free-threaded Python (PEP 779) turns previously-hidden races into real bugs.Boundaries & config
extra={} — never hand-interpolated strings. T-strings (string.templatelib, 3.14+) do no escaping by themselves; use them only where the repo already has a vetted template processor for that exact sink.Logging
print() in production code. logging.getLogger(__name__); %s formatting or extra={} — never f-strings in log calls; logger.exception for stack traces.Before reporting done, every claim must trace to a command actually run this session:
Any — confirm none; confirm annotation strategy matches the target runtime.If a check fails, report the failure with its output — never report done with errors outstanding.
For advanced patterns (generic protocols, async generators, thread-safe singletons, custom decorators, sentinel objects), read references/advanced-patterns.md.
Implement and refactor production Python, FastAPI, Pydantic, async, and migrations.
---name: python-coderdescription: Implement and refactor production Python, FastAPI, Pydantic, async, and migrations.---# plugins/sno-station-standalone/skills/python-coder/SKILL.md常見問題
從發布者下載 plugins/sno-station-standalone/skills/python-coder/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/sno-ai/sno-station-skills。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。