Agent skill
python-dev
Python 开发规范，包含 PEP 8 风格、类型注解、异步编程、性能优化等。当操作 .py, pyproject.toml, requirements.txt 文件时自动激活。
Install this agent skill to your Project
npx add-skill https://github.com/doccker/cc-use-exp/tree/main/.gemini/skills/python-dev
SKILL.md
Python 开发规范
参考来源: PEP 8、Google Python Style Guide
🛠️ 工具链与格式化
- Black 为强制格式化标准。
- Ruff 为首选代码静态检查工具（其速度极快且涵盖广泛规则）。
- MyPy / Pyright 用于强制类型检查。
命名约定
| 类型 | 规则 | 示例 |
|---|---|---|
| 模块/包 | 小写下划线 | user_service.py |
| 类名 | 大驼峰 | UserService |
| 函数/变量 | 小写下划线 | get_user_by_id |
| 私有方法 | 单下划线前缀 | _internal_logic |
🐍 Pythonic 特色
- 类型注解 (Type Hinting)：所有公开接口必须定义类型。Python 3.10+ 优先使用
|表示联合类型（Union）。 - 生成器 (Yield)：大数据处理必须使用生成器以降低内存消耗。
- 上下文管理器：文件/连接/锁定操作必须使用
with语句。
异步编程原则
- 并发获取多个 I/O 密集任务时，使用
asyncio.gather(*tasks)。 - 必须为并发量大的异步任务设置信号量
asyncio.Semaphore(limit)。 - 耗时的 CPU 密集任务必须使用
multiprocessing剥离，防止阻塞 Event Loop。
异常处理
# ✅ 捕获具体异常并记录堆栈
try:
user = repository.find(id)
except DatabaseError as e:
logger.error("Failed to find user %s", id, exc_info=True)
raise ServiceError(f"DB error: {e}") from e
📋 本回复遵循：
python-dev- [章节]
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
doccker/cc-use-exp
ops-safety
运维安全规范。当用户执行系统级命令（sysctl、iptables、systemctl、Docker 配置、数据库 DDL） 或进行服务器运维操作时触发。 包含命令风险说明模板、回滚方案要求、问题排查原则、Docker/Cloudflare/数据库场景规则等。
doccker/cc-use-exp
ruanzhu
当用户执行 /ruanzhu 命令或请求生成软著源代码文档时触发。提供软著源代码 DOCX 生成规范。 覆盖项目信息检测、语言扫描规则、页数控制、DOCX 格式规范等。
doccker/cc-use-exp
ui-ux-pro-max
专业级 UI/UX 设计规范，需要高质量界面设计时手动触发或描述"设计感/专业UI"时自动触发。 覆盖视觉层次、配色体系、排版节奏、交互微动效、响应式适配等。 日常前端开发由 frontend-dev skill 覆盖。
doccker/cc-use-exp
bash-style
Bash 编写规范。当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件， 或在 Markdown 中编写 bash/shell 代码块时触发。 包含注释规范、文件写入方式、Heredoc 引号规则、权限路径、脚本规范等。
doccker/cc-use-exp
redis-safety
Redis 安全与性能规范。当用户操作 Redis 相关代码（go-redis、Jedis、redis-py、ioredis）时触发。 包含禁止 KEYS 命令、SCAN 替代、大 key 控制、Pipeline 批量、TTL 规范等。
doccker/cc-use-exp
python-dev
Python 开发规范。当用户操作 .py、pyproject.toml、requirements.txt、setup.py 文件， 或涉及 FastAPI、Django、Flask、pytest、asyncio 开发时触发。 包含 PEP 8 风格、类型注解、异常处理、测试规范、异步编程、性能优化等。
Didn't find tool you were looking for?