Python全能编程助手

核心问题：Python 学习与协作中的理解成本

对于算法学习者和开发者，有两个高成本任务反复出现：

1. 从题目到可运行代码：面对一个算法问题（如 LeetCode），需要经历“理解题意→设计思路→编写代码→验证复杂度”的完整循环。这个过程耗时且容易陷入思维定式，缺乏对解法优劣的直观对比。
2. 从代码到可维护文档：接手一段现有 Python 代码（无论是他人代码、遗留系统还是自己的片段），首要任务是快速理解其逻辑、参数与返回值，才能进行调试或修改。手动添加注释枯燥，且难以保证注释的规范性与全面性。

这两种场景本质上是 信息解读与结构化表达的消耗。python全能编程助手（SkillSub Pro）旨在通过一个统一的入口，自动完成这两种结构化输出的生成工作。

技能如何工作：双模式智能处理

该技能的核心是 智能输入识别与双引擎输出。你无需选择模式，只需提供原始输入。

1. 题解模式引擎

触发：输入包含问题描述、题目编号（如 LeetCode 1）或关键词（如“解题”、“实现”）。

工作流与输出结构：

• 解析与思路生成：分析题目约束与目标，选择最优或多种解法（如 哈希表 vs 双指针），并生成清晰的分步解题思路。
• 完整代码生成：生成 可直接运行 的 Python 代码。代码内部已包含详细注释，解释每一行或关键块的作用。
• 配套分析：输出标准的时间复杂度与空间复杂度分析（如 时间复杂度 O(n)）。

示例：输入 LeetCode 1 两数之和，输出将包含一个带完整注释的 two_sum 函数实现、使用哈希表的思路阐述及复杂度分析。

2. 代码注释引擎

触发：输入包含明确的 Python 代码块（如 def、class 语句）。

工作流与输出结构：

• 代码解析：识别代码中的函数、类、参数、控制流等结构。
• 规范注释生成：按照 PEP 257 规范，为代码添加详尽的中文注释。注释覆盖：

函数/类级的 docstring（功能摘要、参数、返回值）。
关键逻辑行的行内注释，解释算法步骤或变量作用。

• 输出完整文件：返回添加了注释后的 完整代码，可直接复制使用。

示例：输入一段快速排序代码，技能会为其添加注释，解释分治思想、pivot 选择、分区循环（while 循环）的每一步操作。

适用边界与重要注意点

这是一个 高度垂直的工具，明确其边界能更高效地使用：

• 专注 Python 生态：技能设计与示例均围绕 Python 语言。输入其他语言的代码或题目，可能无法获得预期结果。
• 算法与脚本为主：最适合用于 算法题解、数据处理脚本、工具函数 等中小规模代码。对于涉及复杂状态管理、多模块交互的大型工程代码，生成的注释可能无法完全捕捉其架构意图。
• 注释为中文：生成的题解思路、代码注释均为中文。如果团队工作语言为英文，需考虑二次翻译的成本。
• 非代码验证工具：生成的代码可运行，但不保证对所有边缘测试用例都最优。复杂度分析是理论值。请始终对核心逻辑进行单元测试。
• 输入质量决定输出质量：提供清晰、无歧义的题目描述或结构良好的代码，能获得更精准的结果。过于模糊或粘合的代码可能影响注释的准确性。