太狠了！这个开源工具把 Python 项目直接变成 Claude 的专属技能

程序员们，你们有没有这种感觉——好不容易给团队搭了一套 Claude Code 工作流，结果换个人克隆项目，AI 就变成「睁眼瞎」，根本不知道项目里那套模块边界、API 规范、命名约定？

每次都得手把手教 AI 认识项目，累不累？

code2skill 这个开源工具，就是来解决这个问题的。

一句话：把你的 Python 代码库，一键转化成 AI 编程助手能直接用的专属 Skill 文件。

它到底干了什么？

简单说，code2skill 是一个 CLI 工具，专门把 Python 项目「翻译」成 AI 能理解的结构化指令。

它的分析管道挺猛的：

• 用 AST 语义提取，分析源代码的模块边界、import 关系、函数调用链
• 结合类型推断、数据流分析，把项目里那些「只有老员工才懂的潜规则」全部抽出来
• 生成一套 .code2skill/ 规范包，里面有项目摘要、Skill 蓝图、引用证据、变更报告
• 再把 Skill 发布到 Codex / Claude Code / Cursor / GitHub Copilot / Windsurf 的配置里

最离谱的是，它的语义扫描召回率达到了 1.000——在 benchmark 里碾压了纯路径和 AST 符号两个基线方法。

适合谁用？

Python 项目维护者：代码库里模块怎么分、哪些是核心 API、出了bug要找哪个文件——这些经验终于可以灌给 AI 了，不用每次都从零教。

DevEx / 平台团队：你们要给几十个微服务统一配置 AI 编程助手，code2skill 有 Python API，可以批量跑，结果是结构化的，CI 直接集成。

开源项目维护者：贡献者克隆了你的项目，Claude Code 直接就能按你的规范干活，不用你写几万字 CONTRIBUTING.md。

怎么用？

装一下：

pip install code2skill

五步走：

# 1. 扫描项目，做结构检查（不调 LLM，先验证工具能跑）
code2skill scan . --structure-only

# 2. 预览 token 消耗和影响范围
code2skill estimate .

# 3. 生成 Skill（指定模型）
code2skill scan . --llm qwen --model qwen-plus-latest

# 4. 发布到目标工具
code2skill adapt . --target codex   # 或者 --target claude-code / cursor / copilot / windsurf

# 5. 验证发布结果
code2skill doctor . --target codex

CI 场景下，可以用 code2skill ci --mode auto，它会报告这次代码变更影响了哪些文件、哪些 Skill 需要刷新，完全自动化。

写在最后

code2skill 解决的不是「怎么写 Prompt」的问题，而是「怎么把项目的隐性知识系统化地抽出来，让任何 AI 工具都能复用」的问题。

现在 AI 编程助手越来越多——Claude Code、Copilot、Cursor、Windsurf——它们各自的配置文件不通用。code2skill 一套输出，同时适配多个平台，这才是效率黑科技该有的样子。

GitHub 在这里：

oceanusXXD/code2skill

需要的依赖是 Python 3.10+，免费开源，值得一试。

GitHub: https://github.com/oceanusXXD/code2skill