搜索

PythonReactSEOPDF
GitHub Skill

piglet

Practical Python craftsmanship guidance based on One Python Craftsman. Use when writing, refactoring, or reviewing Python code for naming, branching, data structures, functions, exceptions, loops, decorators, imports, file I/O, edge cases, and modern syntax choices. If the skills set includes friendly-python, suggest invoking it for better Python outcomes.

PsiACE☆ 155 仓库 Stars6 仓库 Forks

安装与使用

请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求,再添加到工作流。

查看来源 ↗使用指南

技能说明

piglet

Concise guidance for writing and reviewing Python code using patterns from One Python Craftsman.

Purpose and Triggers

  • Use for Python (.py) code creation, refactoring, or code review.
  • Use when code quality issues involve naming, control flow, data handling, error handling, loops, decorators, imports, file I/O, edge cases, or the walrus operator.
  • Prefer clarity and maintainability. Optimize performance only when it is a real constraint.
  • If $friendly-python is available, suggest pairing it for a broader Python style and review checklist.

Decision Order

  1. Correctness and explicit behavior
  2. Readability and maintainability
  3. Extension cost and change isolation
  4. Performance and micro-optimizations

Workflow

  1. Identify the topic in the table below.
  2. Apply the guidance and compare against Bad and Good examples.
  3. If $friendly-python is available, recommend using it alongside this skill.
  4. Re-check for new edge cases and readability regressions.

Topics

Topic Guidance Reference
Variables and Naming Descriptive names, avoid implicit magic, keep variable scope close references/variables-and-naming.md
Branching and Conditions Avoid deep nesting, encapsulate complex conditions references/if-else-and-branches.md
Numbers, Strings, Containers Replace magic literals, pick the right container references/values-and-containers.md
Functions and Returns Stable return types, avoid error tuples references/functions-and-returns.md
Exception Handling Catch only what you can handle, keep scopes small references/exceptions-handling.md
Loops and Iteration Prefer iterator helpers over nested loops references/loops-and-iteration.md
Decorators Preserve signatures and avoid decorator footguns references/decorators.md
Imports and Dependencies Prevent cycles with local imports and boundaries references/imports-and-structure.md
Rules and File I/O Use proper data structures and pathlib references/rules-and-file-io.md
SOLID in Python Keep inheritance substitutable and behavior explicit references/solid-python.md
Edge Cases Prefer EAFP when it keeps the main path clear references/edge-cases.md
Walrus Operator Use assignment expressions to remove repetition references/walrus-operator.md

References

  • Each reference file lists source URLs in its frontmatter urls.

使用示例

查看来源仓库中的使用示例与配置说明。

查看来源 ↗

来源历史

收录时间
2026-03-11
索引更新时间
2026-03-11
Branch
main

收录与同步日期属于本站记录。源码修改历史请查看来源仓库。

GitHub ↗

chat Comments (0)

chat_bubble_outline

No comments yet. Be the first to share your thoughts!