mcpField
P
python3-core

python3-core

github.com/jamie-bitflight开发36 次安装
代码仓库

关于 python3-core

python3-core 是用于 Python 工程任务的路由技能，会根据任务领域指向开发规范和专门技能，并提供参考资料与项目模板。

主要功能

  1. 01将任务路由到专门技能
  2. 02按 Python 版本选择类型提示
  3. 03提供工具与 Python 特性参考
  4. 04提供项目资源模板
  5. 05提供审计、评审与调试入口

适用场景

  1. 01为 Python 功能任务选择指导
  2. 02查找相关测试或框架技能
  3. 03使用模板进行打包与项目配置

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jamie-bitflight/claude_skills --skill python3-core

安装后在 Claude Code 中输入/python3-core确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

assets/
.editorconfig
.markdownlint.json
example.pre-commit-config.yaml
hatch_build.py
version.py
references/
modern-modules.md
PEP723.md
python-development-orchestration.md
python311-features.md
python312-features.md
python313-features.md
python314-features.md
references/modern-modules/
arrow.md
attrs.md
bidict.md
blinker.md
boltons.md
box.md
copier.md
datasette.md
fabric.md
GitPython.md
httpx.md
paho-mqtt.md
prefect.md
python-diskcache.md
python-dotenv.md
robotframework.md
shiv.md
uvloop.md

详细介绍

Python 工程路由

首先加载 python-engineering:standards-for-python-development。其中包含此插件执行的所有规则——类型标注和 Any 边界策略、架构与 SOLID、错误处理、安全性、性能、标识符命名、脚本依赖项、Rich/Typer 输出、测试和工具默认设置。此技能会将任务路由到适用的专业技能。

类型路径

python3-typing 根据项目的 requires-python 下限版本和已安装的依赖项选择类型路径。references/typing-matrix.md 展示各路径的导入项和边界形式；references/python311-features.md 至 references/python314-features.md 列出各版本新增的功能。

领域路由

仅当任务明确符合某个技能时才加载该技能。

任务加载
测试驱动开发、红-绿-重构、先写测试再实现python3-tdd
设计测试套件——覆盖率策略、测试金字塔、fixture 层级、变异测试计划python3-test-design
判断失败的测试是真正的 bug 还是测试缺陷analyze-test-failures
重新调整对测试失败的调查方法——双假设协议、危险信号test-failure-mindset
审查整个测试套件——覆盖率、隔离性、mock 用法、命名、完整性comprehensive-test-review
Typer/Rich CLI 工具、进度条、终端输出python3-cli
FastAPI、Starlette、Django、Flaskpython3-web
pandas、numpy、scipy、jupyter、数据管道python3-data
async/await、asyncio、并发 I/O、任务调度async-python-patterns
为现有项目添加功能——探索、MoSCoW、TDD、集成、验证python3-add-feature
编写包含阶段和验收标准的结构化功能任务文件create-feature-task
包元数据和构建目标——pyproject.toml、构建后端、入口点python3-packaging
发布到 PyPI 或准备发布版本——CI 工作流、可信发布、TestPyPIpython3-publish-release-pipeline
uv、Hatchling、ty、pre-commit、TOML 编辑python3-tools
使用 MkDocs 或 Material 主题的文档站点mkdocs
已确认的限制阻碍依赖项安装——隔离网络环境、无 uv、无互联网python3-stdlib-only
对 PR、差异、已暂存/未暂存的更改、文件或目录进行全面的 Python 质量/现代化审查python-quality-audit
任务分类过于宽泛，无法从此表中选择技能specialist-skill-routing

手动入口：/python-engineering:python-quality-audit（分派式质量/现代化审查）、/python-engineering:review（范围明确的常规代码审查）、/python-engineering:cleanup （渐进式质量改进）、/python-engineering:lint（确定性检查）、 /python-engineering:debug（结构化调试）。

参考资料

文件内容
references/PEP723.md内联脚本元数据——块语法、shebang 形式、将脚本拆分到多个文件
references/typing-matrix.md各 Python 版本和可用依赖项对应的类型路径
references/python311-features.md … python314-features.md各 Python 版本新增的功能
references/modern-modules.md按用例整理的经审核 Python 3.11+ 模块
references/tool-library-registry.md工具、库和框架注册表，以及 pyproject.toml 模板变量
references/python-development-orchestration.md通过专业 Agent 协调 Python 任务
references/user-project-conventions.md从生产项目中提取的约定

资源

模板位于 ${CLAUDE_PLUGIN_ROOT}/skills/python3-core/assets/：

  • version.py — 双模式版本管理
  • hatch_build.py — 构建钩子模板
  • example.pre-commit-config.yaml — 标准 Git 钩子
  • .editorconfig — 编辑器格式设置

评论

支持 Markdown