Python工程实践
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/kunlun-python-best-practices。
技能介绍
你卡在哪些环节
做 Python 项目时,常见困境不是「不会写代码」,而是缺少可复用的工程动作:PR 来了不知道按什么维度评、方案文档要么堆功能不讲取舍、线上报错习惯性猜根因、选框架只凭偏好没有对比表、接口联调靠口头约定。
技能怎么帮你落地
本技能围绕 Python 工程实践 提供六类结构化交付,听到对应意图即可进入:
- 代码评审:输入 diff/PR,产出检查清单与 阻断 / 建议 / 可选 分级意见,工作流强调先意图与正确性,再安全与可维护性。
- 技术方案设计:输入需求与约束,填充背景、目标、选型、风险等方案模板,并要求说清「为什么选 A 不选 B」。
- 调试排错:输入报错与上下文,给出定位树、最小复现步骤与修复验证路径(稳定复现 → 隔离变量 → 看日志/链路/指标 → 假设验证)。
- 架构权衡:按场景与规模输出选型表(利弊、适用条件、成本)。
- API 设计:按资源与操作整理 RESTful 规范、字段契约与可机器识别的错误码。
- 工程规范:按语言/框架给出清单与反模式,可对照五维质量量表(正确性、可读性、测试、安全、性能)。
多诉求可组合使用;输出以模板与清单为主,便于你直接微调后放进文档或 PR 评论。
边界与注意
不提供专业资质判断,不接入付费或外部 API,也不处理真实密钥与凭证(仅脱敏示例)。评审与方案结论为辅助参考,合并与上线决策仍由负责人承担;不鼓励绕过安全机制或未授权访问。
使用场景
- 合并前收到 Python 服务的 PR,需要按正确性、安全与测试覆盖给出分级评审条目
- 生产环境 Python 进程报错,需要最小复现场景与日志/链路证据链再动代码
- 团队要在 Flask 与 FastAPI 之间选型,需要利弊、适用规模与长期成本的对比表
- 新模块要对外提供 REST 接口,需要统一字段命名、错误码与向后兼容的契约草稿
适合人员
- 负责主干合并的后端工程师,要对 diff 做阻断级与建议级分类并写明理由
- 写立项或重构说明的技术负责人,需要含选型对比与回滚方案的结构化方案
- 处理线上告警的 SRE/DevOps,希望用复现→隔离→证据的标准流程替代盲改
- 前后端联调的全栈开发者,需要把资源、操作与错误码写成可执行的 API 契约