Claude Code 写 Python 代码乱成一团？这个开源 Skill 给你立规矩

用了快两年 Claude Code，我发现写 Python 代码最常见的问题不是语法，而是「不知道该按什么风格写」

同一个项目，AI 第一轮生成一套风格，第二轮又是另一套风格——类型注解忽有忽没有，错误处理各写各的，测试用例的命名更是随缘。

今天介绍一个配置体系，刚好解决这个问题：cc-use-exp 里的 Python 开发规范 Skill（GitHub ★1,035）。

它做了什么

简单说，就是给 AI 编程助手立了一整套 Python 开发的「家规」。

这个 Skill 来自 doccker/cc-use-exp 仓库，收录在 SkillsMP，附带了中文版说明。核心内容覆盖四个高频场景：

类型注解：规则很明确——公开接口优先补类型信息，数据模型的边界要清晰。这条看起来简单，但 AI 经常在内部函数上偷懒不写类型，导致后续接手的人只能靠猜。有这条规范在，Claude Code 会主动补全。

测试规范：要求测试优先覆盖受影响行为和边界输入。这不是让你写全量测试，而是每次改代码时，AI 会先识别哪些行为可能被影响，然后优先覆盖这些路径。比「帮我写几个测试」这种模糊指令有效得多。

工具链约束：格式化用 black、导入排序用 isort、类型检查用 mypy 或 pyright、Linter 用 ruff。规则里明确写明了什么场景用什么工具，AI 不会在「要不要加类型注解」这类问题上反复横跳。

错误处理：覆盖异常设计、raise ... from ... 写法、领域异常分层。规范里特别强调「窄化捕获」（只捕获明确知道如何恢复的异常），这个原则能有效防止 AI 生成那种 except Exception: pass 的摆烂代码。

用法

# 通过 SkillsMP 安装（推荐）
npx skills add https://github.com/doccker/cc-use-exp --skill python-dev

# 或通过 Claude Code 插件市场
/plugin marketplace add doccker/cc-use-exp
/plugin install cc-use-exp@cc-use-exp

安装后，只要你的项目是 Python 代码，Claude Code 会自动加载这个 Skill，无需手动触发。它是按需激活的——AI 会判断当前上下文是否涉及 Python 开发，然后自动应用规范。

实际效果

我拿它跑了两个真实项目：一个 Flask 小 API、一个数据处理脚本。

最明显的变化是类型一致性。之前 AI 经常在同一个文件里混用 Optional[str] 和 str | None，或者在某个函数返回值上忘记标注类型。现在有了规范约束，每次生成都会主动补全类型注解，并且格式统一。

其次是测试覆盖率。之前跑 pytest，覆盖率经常只有 40% 多——不是因为没写测试，而是写的都是开心的 happy path。现在 AI 会先分析这次修改影响了哪些分支，然后优先补边界用例，覆盖率拉到 70%+ 不是什么难事。

适合谁用

这个 Skill 适合团队协作场景——尤其是多人用同一个 Claude Code 实例，或者项目代码需要长期维护的情况。它解决的不是「AI 写不出代码」的问题，而是「AI 写的代码风格飘忽、难以维护」的问题。

个人开发者如果在意代码规范，这个 Skill 也很有价值。把它当成团队 Code Review 的前置关卡——每次提交前，Claude Code 已经按规范检查过一遍了。

安装注意

这个仓库 2026 年已经停止维护，但 Skill 本身仍然可用。所有新能力迁移到了新项目 dev-agent-kit/recipes（需要付费小群才能获取最新内容）。对于这次推荐的 python-dev Skill，原始仓库版本完全够用，不需要跟进新项目。

GitHub 链接：doccker/cc-use-exp

GitHub: https://github.com/doccker/cc-use-exp