mcpField
B
building-python-communities

building-python-communities

github.com/wdm0006开发10993 次安装2 天前更新
代码仓库

关于 building-python-communities

为 Python 库维护者提供社区管理指南，涵盖贡献流程、治理和 GitHub 协作模板。

主要功能

  1. 01贡献与行为准则模板
  2. 02缺陷和功能请求模板
  3. 03拉取请求模板与检查项
  4. 04GitHub Actions 欢迎自动化
  5. 05标签与治理指南

适用场景

  1. 01为 Python 库搭建贡献流程
  2. 02整理问题和拉取请求模板
  3. 03规划新贡献者参与方式

安装

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

$npx skills add https://github.com/wdm0006/python-skills --skill building-python-communities

安装后在 Claude Code 中输入/building-python-communities确认已加载。

附带文件GOVERNANCE.mdTEMPLATES.md

详细介绍

Python 库社区管理

必备文件

CONTRIBUTING.md
# Contributing

## Development Setup

git clone https://github.com/user/package.git
cd package
uv sync --extra dev
pre-commit install
pytest

## Making Changes

1. Create a branch: `git checkout -b feature/name`
2. Make changes, add tests
3. Run: `make test && make lint`
4. Commit and open a PR

## Commit Messages

- `Add:` new feature
- `Fix:` bug fix
- `Update:` enhancement
- `Docs:` documentation
CODE_OF_CONDUCT.md

使用 Contributor Covenant——开源项目的行业标准。

Issue 模板

.github/ISSUE_TEMPLATE/bug_report.md：

---
name: Bug Report
labels: 'bug'
---
## Description
## To Reproduce
## Expected vs Actual Behavior
## Environment (OS, Python version, package version)
## Minimal Reproducible Example

.github/ISSUE_TEMPLATE/feature_request.md：

---
name: Feature Request
labels: 'enhancement'
---
## Problem Statement
## Proposed Solution
## Example Usage

PR 模板

.github/PULL_REQUEST_TEMPLATE.md：

## Description
## Related Issue (Fixes #)
## Checklist
- [ ] Tests added
- [ ] Documentation updated
- [ ] CHANGELOG entry added

GitHub Actions 自动化

# .github/workflows/welcome.yml
on:
  pull_request_target:
    types: [opened]
jobs:
  welcome:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/first-interaction@v1
        with:
          pr-message: "Thanks for your first PR! 🎉"

标签

  • good first issue - 适合新手
  • help wanted - 需要额外关注
  • bug、enhancement、documentation

详细模板请参阅：

检查清单

Initial Setup:
- [ ] CONTRIBUTING.md
- [ ] CODE_OF_CONDUCT.md
- [ ] Issue templates
- [ ] PR template
- [ ] Labels defined

Ongoing:
- [ ] Respond to issues within 48h
- [ ] Review PRs within 1 week
- [ ] Maintain good first issues
- [ ] Recognize contributors

了解更多

本技能基于 Will McGinnis 撰写的 《高质量 Python 库开发指南》中的维护部分。以下文章提供了更深入的介绍：

评论

支持 Markdown