⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

piglet Python代码审查指南：遵循《Python工匠》模式的代码质量提升工具

piglet by psiace/skills

50 周安装量

162 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/psiace/skills --skill piglet

Python Web框架代码规范编程最佳实践

🇨🇳中文介绍

piglet

使用《Python 工匠》中的模式编写和审查 Python 代码的简明指南。

目的与触发条件

用于 Python (.py) 代码的创建、重构或代码审查。
当代码质量问题涉及命名、控制流、数据处理、错误处理、循环、装饰器、导入、文件 I/O、边界情况或海象运算符时使用。
优先考虑清晰性和可维护性。仅在性能成为实际限制时才进行优化。
如果 $friendly-python 可用，建议将其与此技能配对使用，以获得更广泛的 Python 风格和审查清单。

决策顺序

正确性和明确的行为
可读性和可维护性
扩展成本和变更隔离
性能和微优化

工作流程

在下表中确定主题。
应用指南并与“不良示例”和“良好示例”进行比较。
如果 $friendly-python 可用，建议将此技能与其一起使用。
重新检查新的边界情况和可读性退化。

主题

主题	指南	参考
变量与命名	描述性命名，避免隐式魔法值，保持变量作用域紧密	references/variables-and-naming.md
分支与条件	避免深层嵌套，封装复杂条件	references/if-else-and-branches.md

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

🇺🇸English

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

Correctness and explicit behavior
Readability and maintainability
Extension cost and change isolation
Performance and micro-optimizations

Workflow

Identify the topic in the table below.
Apply the guidance and compare against Bad and Good examples.
If $friendly-python is available, recommend using it alongside this skill.
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.

Weekly Installs

Repository

psiace/skills

GitHub Stars

162

First Seen

Feb 5, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

codex45

opencode44

github-copilot42

kimi-cli41

gemini-cli41

amp41

piglet Python代码审查指南：遵循《Python工匠》模式的代码质量提升工具

🇨🇳中文介绍

piglet

目的与触发条件

决策顺序

工作流程

主题

相关 Skills

参考资料

🇺🇸English

piglet

Purpose and Triggers

Decision Order

Workflow

Topics

References

最新 Skills