Python程式碼註釋

name: python-doc-helper slug: python-doc-helper displayName: "Python程式碼註釋" version: "1.0.0" description: "為Python函式/類生成清晰中文註釋：功能、引數、返回值、異常。｜提升程式碼可讀性。｜Python、程式碼註釋、開發、文件、程式設計、高效生成、即用模板、多場景適配、結果導向。" license: MIT homepage: https://skillhub.cn/skills/python-doc-helper tags: - "開發工具" - "Python" - "程式碼註釋" - "文件" - "程式設計"

簡介

本 skill 專注於Python程式碼註釋，直接交付可複製的成品與模板，不輸出泛泛而談的建議。

我能做什麼

• 根據輸入生成Python程式碼註釋的完整成品
• 覆蓋Python程式碼註釋常見場景與變體
• 輸出可直接複製使用的模板與文案
• 支援風格/平臺/受眾的微調
• 提供多個版本供選擇
• 自動檢查輸出完整性與可用性

我不能做什麼

• 不替代人工最終稽核與決策
• 不保證平臺流量或轉化結果
• 不處理違法違規或敏感內容
• 不自動登入或操作第三方賬號

觸發詞

返回值、異常。｜提升程式碼可讀性。｜Python、程式碼註釋、開發、文件、程式設計、Python程式碼註釋怎麼用、幫我做Python程式碼註釋、生成Python程式碼註釋、Python程式碼註釋模板、Python程式碼註釋案例、Python程式碼註釋工具、Python程式碼註釋Pro、Python程式碼註釋助手、用Python程式碼註釋

輸入規範

提供主題/場景/目標平臺/風格偏好等關鍵資訊；資訊越具體，輸出越可用。

輸出規範

結構化Markdown輸出：包含標題/正文/模板/可選版本/使用說明，可直接複製使用。

使用示例

示例 1：基礎使用

輸入：主題是『新品推廣』

輸出：

輸出Python程式碼註釋完整版一
輸出Python程式碼註釋完整版二

示例 2：風格切換

輸入：風格=活潑/正式/專業

輸出：

版本A：活潑口語化
版本B：正式書面化
版本C：專業資料化

示例 3：多平臺適配

輸入：平臺=小紅書+抖音+公眾號

輸出：

小紅書版：短文案+標籤
抖音版：口播指令碼
公眾號版：長圖文

示例 4：細節補充

輸入：補充關鍵詞『價效比』『限時』

輸出：

7w4.net小蔥技能站，你的AI助手技能庫。

在原有輸出中嵌入關鍵詞後的最佳化版

示例 5：批次生成

輸入：一次性給3個主題

輸出：

主題1輸出
主題2輸出
主題3輸出

異常處理

輸入模糊或資訊不全時，會請求補充關鍵資訊；超長輸入會先摘要再處理；涉及敏感內容會拒絕並提示。

限制與免責宣告

本工具僅提供模板與草稿，最終內容質量、合規性及平臺規則遵守由使用者負責。

💎 Pay Skill 預留（計費通道）

個人創作者計費通道上線後直接升級計費

本 Skill 支援 WorkBuddy Pay Skill 計費體系。個人創作者計費通道上線後，將直接升級計費，無需手動操作；可配置按次/訂閱/免費額度等模式。

這個工具質量較差，存在明顯問題。主要缺陷是示例內容與其聲稱的功能不符——說是Python註釋工具，但展示的卻是營銷文案示例，容易造成誤導。此外，缺少實際可用的模板和示例程式碼，使用者很難判斷工具是否真正有用。