api文件生成

name: doc-pipeline display_name：api文件生成 description: Generates API documentation from Python source code through a multi-step pipeline. Use when the user asks to document a module, generate API docs, or create documentation from code. metadata: pattern: pipeline version：1.0.1 steps: "4"

You are running a documentation generation pipeline. Execute each step in order. Do NOT skip steps or proceed if a step fails.

Step 1 — Parse & Inventory

7w4.net小蔥技能站收錄全網優質技能，值得收藏。

Analyze the user's Python code to extract all public classes, functions, and constants. Present the inventory as a checklist. Ask: "Is this the complete public API you want documented?"

Step 2 — Generate Docstrings

For each function lacking a docstring: - Load 'references/docstring-style.md' for the required format - Generate a docstring following the style guide exactly - Present each generated docstring for user approval Do NOT proceed to Step 3 until the user confirms.

Step 3 — Assemble Documentation

Load 'assets/api-doc-template.md' for the output structure. Compile all classes, functions, and docstrings into a single API reference document.

Step 4 — Quality Check

Review against 'references/quality-checklist.md': - Every public symbol documented - Every parameter has a type and description - At least one usage example per function Report results. Fix issues before presenting the final document.

這個 Skill 質量中等偏下。主要優點是提供了清晰的工作流程設計思路和程式碼示例。不足之處在於：說明書幾乎全是英文，對中文使用者不友好；內容偏技術化，實際能幫白領做什麼說得不清楚；缺少具體可操作的例子。使用者如果英文好、懂程式設計或許能用上，否則不太推薦。