返回资源列表

Real Python · Philipp Acsany

How to Use Claude Code Skills for Better Python Docstrings

How to Use Claude Code Skills for Better Python Docstrings是Real Python的免费实践教程（en）。前置条件：需要会写 Python 函数、类与 docstring，熟悉终端基本命令和 Markdown 编辑；网页称若你是 Claude Code 新手，可先看 How to Use Claude Code to Write and Debug Python。

学习者能在项目中创建一个名为 docstring-doctor 的 Claude Code skill，让 Claude 按固定的 Google 风格规则为 Python 代码给出 docstring 建议。

打开官方课程
难度
见前置条件
类型
博客与教程 · 实践教程
语言
en
规模
1 个课节
内容费用
免费
动手
需要动手环境

学完你能

  • 说清 Claude Code skill 的目录结构与 SKILL.md 的 frontmatter（name、description）作用
  • 在项目 .claude/skills/ 下创建名为 docstring-doctor 的 skill，并让它的 name 与文件夹名一致
  • 编写符合 Google 风格（Args/Returns/Raises）的 Python docstring 规则并写进 SKILL.md
  • 在会话开始前先记录 Claude 的默认输出，作为 skill 生效后的对比基线
  • 让同一提示在加载 skill 后按固定结构输出 docstring，包括说明 restock() 抛出的 ValueError

适合你吗

适合

适合已会用 Python 写函数与 docstring、想把 AI 编码助手的行为固化为可复用规则的中级开发者。文章从零构建一个 skill，步骤具体，可跟随操作。

暂不适合

不适合想系统学习 Python 基础语法的人；教程把内容标注为 intermediate 级别。

需要先会

需要会写 Python 函数、类与 docstring，熟悉终端基本命令和 Markdown 编辑；网页称若你是 Claude Code 新手，可先看 How to Use Claude Code to Write and Debug Python。

课程特点

内容侧重
侧重实践应用
练习与项目
按教程正文继续练习：重开会话后反复用同一提示对比输出，并阅读 Step 2、Step 3 的正文做后续扩展。
学习时长
1 个课节原站未给出统一学习时长；实际用时取决于已有基础。
内容费用
免费节选可直接读到前置条件、示例模块与第 1 步正文、代码和文件内容，未见正文付费墙；导航栏 “Unlock All Content” 属站点会员入口，不计入本资源费用。

内容覆盖

  • Prerequisites
  • Step 1: Create Claude Code Skills Inside Your Project
  • Step 2: Add Reference Files With Progressive Disclosure
  • Step 3: Add a Python Helper and Make the Skill Personal
  • Next Steps and Troubleshooting
  • Frequently Asked Questions

常见问题

免费吗？

免费：节选可直接读到前置条件、示例模块与第 1 步正文、代码和文件内容，未见正文付费墙；导航栏 “Unlock All Content” 属站点会员入口，不计入本资源费用。实践无额外费用：网页写明辅助脚本只使用标准库，无需安装任何东西；练习使用免费的 Python 3.12+ 即可。

需要什么基础？

需要会写 Python 函数、类与 docstring，熟悉终端基本命令和 Markdown 编辑；网页称若你是 Claude Code 新手，可先看 How to Use Claude Code to Write and Debug Python。软件、账号与硬件：已安装并登录 Claude Code（示例在 Claude Code 2.1.273 下核对）；Python 3.12 或更高版本（示例在 Python 3.14.6 下核对）；Linux/WSL 的 Bash 或 macOS 的 zsh/Bash；若 python3 不是启动 Python 的命令，用你自己的命令替代。

有中文吗？

本站记录的语言是en；是否有中文字幕或译本本站未核实，请以原站为准。

怎么开始？

从原始资源入口开始：https://realpython.com/claude-code-skills/。本页“学前准备”列出环境与工具，“学习指南”给出开课提示词，可以在自己的电脑上按步骤开始。

来源与使用须知

原始资源
Real Python
收录时间
本站首次收录 2026-10-22
指南参考
课程主页

版权与转载

  • 课程材料未标明许可：仅供个人学习，转载、修改或商用前请先联系原作者。
  • 本站只提供原始链接和学习指南，不转载、不镜像课程材料；引用时请注明原作者与出处。