前言¶
在 Cursor、Claude Code 等环境里写 Python，常见两类重复劳动：一是把题目或题号变成带思路、复杂度说明的可运行题解；二是给已有脚本补中文注释和 docstring，方便作业提交或代码审查。通用对话模型能完成这些事，但输出格式、注释粒度往往每次不一致。下面介绍 SkillHub 上的社区 Skill python全能编程助手（坐标 @user_eceb0be6/python-all-helper），它通过一份 SKILL.md 约束 Agent 的行为，把「题解生成」和「代码注释」合并为可重复触发的双模式工作流。
这是什么¶
python全能编程助手 是 SkillHub 分类 dev-programming 下的社区技能（来源：community），当前页面标注版本为 1.0.0，发布者为 user_eceb0be6，标签 requires_api_key=false，即安装与使用不依赖额外 API Key。
技能包采用通用 SKILL.md 格式：安装后 Agent 读取该文件中的触发条件与输出结构。包内正文将自身定位为 SkillSub Pro，面向学生、算法学习者与开发者，强调题解模式与注释模式二合一，并声明会根据输入自动判断是「题目描述」还是「Python 代码」，无需手动切换模式。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_eceb0be6/python-all-helper
- API 坐标页：https://api.skillhub.cn/user_eceb0be6/python-all-helper
截至资料抓取时，SkillHub 侧统计为评分 100000、下载 15994（与页面展示一致；若你在站内看到其他数字，以 SkillHub 实时数据为准）。
核心功能¶
以下能力均来自已安装包中的 SKILL.md，只描述文档中写明的内容。
题解模式¶
输入：题目编号、题目描述或自然语言问题（例如 LeetCode 题号、「给定一个数组…」「实现某函数」等）。
输出（文档约定的结构）：解题思路、带详细注释的完整 Python 代码、时间/空间复杂度分析；可按用户要求提供多解法（如暴力与优化对比）。
触发条件（满足任一即可）：输入含题号或「LeetCode / #数字 / 题目 N」；含典型题干表述（「给定」「实现」「求最大」等）；或明确要求「题解」「解题」「写代码」「代码实现」。
注释模式¶
输入：用户粘贴的 Python 代码或代码块。
输出：在保留逻辑的前提下补充中文注释，包括函数 docstring、参数与返回值说明、关键步骤说明；文档要求遵循 PEP 257 等注释规范，并提到可请求「Google 风格」或更偏初学者的详注。
触发条件：输入含 def、class、import 等 Python 语法特征；含 ```python 等代码标记；或明确要求「加注释」「解释代码」。
文档中提到的扩展资源（需核对包内容）¶
SKILL.md 还描述了算法模板库 references/common_algorithms.md 与校验脚本 scripts/validate_code.py。经 skillhub install 拉取的 v1.0.0 包内目前仅包含 SKILL.md，未附带上述路径下的文件。若你依赖本地校验或模板，需要自行补充，或向 SkillHub 发布者反馈包内容与文档不一致的问题。
安装与启用¶
1、安装 SkillHub CLI¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方安装说明执行（仅 CLI）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装技能到当前 Agent 的 skills 目录¶
SkillHub 要求安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
本技能在索引中的安装方式为（含 namespace）：
skillhub install python-all-helper --namespace user_eceb0be6 --dir <你的 skills 目录>
常见客户端路径（来自 SkillHub 安装文档，按你实际使用的工具选择其一）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
也可将下面提示词交给支持 Skill 的 AI，让其按官方流程安装（与 SkillHub 页面一致）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_eceb0be6/python-all-helper`。
安装完成后，按你所用客户端的要求重启或刷新 Agent，使新 Skill 被加载。
说明：SKILL.md 正文里另写有 skillhub install skillsub-pro 的安装示例，与 SkillHub 上该条目的 slug python-all-helper 不一致；以页面坐标与 skillhub search python-all-helper 给出的 namespace user_eceb0be6 安装命令为准。
典型用法¶
启用技能后，用自然语言或代码块触发即可，无需额外配置文件。
题解示例¶
向 Agent 发送题号或题干，例如：
LeetCode 1 两数之和
按 SKILL.md 约定，Agent 应组织为：解题思路 → 完整可运行代码（含注释）→ 复杂度分析（如 O(n) 时间、O(n) 空间）。
也可在题干中约束解法，例如：
用动态规划解这道题，并给出暴力法和优化法两种写法
注释示例¶
粘贴待注释代码，例如：
def bubble_sort(arr):
n = len(arr)
for i in range(n):
for j in range(0, n-i-1):
if arr[j] > arr[j+1]:
arr[j], arr[j+1] = arr[j+1], arr[j]
return arr
并说明需求：
为上面代码加详细中文注释，我是初学者
Agent 应进入注释模式，补全 docstring 与逐步逻辑说明。
Windows 与中文输出¶
SKILL.md 建议在 Windows 上若遇 UnicodeEncodeError，可设置 PYTHONUTF8=1，或在脚本中重定向 stdout 为 UTF-8。这与技能本身无 API 依赖，仅影响本地运行生成代码时的终端编码。
适用场景与注意¶
适合谁
- 需要稳定输出结构的刷题、作业与算法自学（题解 + 复杂度）。
- 需要快速为遗留脚本补中文注释、便于评审或教学演示的场景。
限制与坑
- 能力边界：技能通过提示词与结构约束 Agent，不替代本地 Python 解释器执行与单元测试；生成代码仍应在你的环境中运行验证。
- 包内容与文档：当前下载包仅含
SKILL.md，文档提到的scripts/、references/未随包提供，勿假设安装后即可运行validate_code.py或打开模板库。 - 版本信息：SkillHub 页面为 1.0.0，而
SKILL.md内「版本历史」写到 Pro v2.1；以商店版本号为准理解发布状态，正文细节以包内SKILL.md为准。 - 安装命令：务必带
--namespace user_eceb0be6且指定正确的--dir；裸 slug 下载在部分环境下可能返回 404。 - 无需 API Key：
requires_api_key=false表示技能本身不配置第三方密钥；你本地项目若调用外部服务，仍按项目自身鉴权处理。
结尾¶
python全能编程助手 把 Python 题解生成与代码注释收进同一份 SkillHub 社区 Skill，用触发词与输出结构减少反复说明格式的成本。若你主要在 Cursor 等 Agent 环境里做算法练习或补注释，可按上文命令安装到对应 skills 目录后直接使用。
官方地址：https://www.skillhub.cn/skills/user_eceb0be6/python-all-helper
