当设计或修改 REST API 响应结构、处理 API 返回值时触发。防止 API 设计缺陷导致的字段错位、类型歧义等问题。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
doccker/cc-use-exp1.1천2026년 8월 26일 업데이트
무료GitHub에 공개
python-dev
Python 开发规范，包含 PEP 8 风格、类型注解、异步编程、性能优化等。当操作 .py, pyproject.toml, requirements.txt 文件时自动激活。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
설치 방법 보기포함된 파일(1)
- SKILL.md1.7 KB
SKILL.md(원문)
설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
<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- [章节]
리뷰
아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
댓글
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
같은 저장소의 스킬
当设计或修改 REST API 响应结构、处理 API 返回值，或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义，以及生成产物时关键字段缺失但静默成功的问题。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
doccker/cc-use-exp1.1천2026년 8월 26일 업데이트
网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范，防止纯子串匹配误判正常响应内容中的技术术语（如 Cloudflare、502、error）
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
doccker/cc-use-exp1.1천2026년 8월 26일 업데이트
当 API/任务可能执行超过 10 秒（批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合）时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
doccker/cc-use-exp1.1천2026년 8월 26일 업데이트
当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件，或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
doccker/cc-use-exp1.1천2026년 8월 26일 업데이트
Bash 脚本与系统命令规范。禁止行尾注释，强制使用 tee/heredoc 写入，提升命令执行的可维护性。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
doccker/cc-use-exp1.1천2026년 8월 26일 업데이트