当设计或修改 REST API 响应结构、处理 API 返回值，或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义，以及生成产物时关键字段缺失但静默成功的问题。
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026
FreePublished on GitHub
python-dev
Python 开发规范，包含 PEP 8 风格、类型注解、异步编程、性能优化等。当操作 .py, pyproject.toml, requirements.txt 文件时自动激活。
The English summary is being prepared. Showing the original description.
See how to installFiles included (1)
- SKILL.md1.7 KB
SKILL.md (original)
Review the instructions the agent will receive before you install.
<instructions>
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
</instructions>📋 本回复遵循：
python-dev- [章节]
Reviews
No reviews yet. Tell others what you thought.
Comments
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
More skills from this repository
当设计或修改 REST API 响应结构、处理 API 返回值时触发。防止 API 设计缺陷导致的字段错位、类型歧义等问题。
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026
api-proxy-safety
Free网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范，防止纯子串匹配误判正常响应内容中的技术术语（如 Cloudflare、502、error）
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026
当 API/任务可能执行超过 10 秒（批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合）时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026
bash-style
FreeBash 脚本与系统命令规范。禁止行尾注释，强制使用 tee/heredoc 写入，提升命令执行的可维护性。
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026
bash-style
Free当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件，或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。
The English summary is being prepared. Showing the original description.
doccker/cc-use-exp1.1KUpdated Aug 26, 2026