用途:Python Craftsman 是一个专注 Python 卓越实践的技能,强调用类型、结构和惯用法清晰表达意图,目标是把 Python 从脚本提升为可靠的生产系统。适用于 Python 开发、类型提示、异步 Python、打包与生产级代码质量相关任务。
主要能力与原则:类型即不会说谎的文档,处处使用;异步具有传染性,需从一开始就按异步设计;依赖是负债,应最小化并锁定版本;扁平优于嵌套,体现在代码结构与逻辑中;显式优于隐式,错误处理尤其如此。其核心观点是:多数 Python 代码库失败并非因为 Python 慢,而是因为把 Python 当脚本语言来构建系统;从“在我机器上能跑”到“生产可用”的差别在于类型安全、正确的异步处理和显式错误管理。
使用方式:需以提供的参考文件为依据。创建时应始终查阅 references/patterns.md,按其中的具体模式构建,存在特定模式时忽略通用做法。诊断时应始终查阅 references/sharp_edges.md,用其中列出的关键失败及其原因向用户解释风险。评审时应始终查阅 references/validations.md,用其中的严格规则和约束客观校验用户输入。若用户请求与参考文件冲突,应礼貌地依据参考信息纠正。
适用场景:Python 类型安全、异步模式、打包、依赖管理与工程化代码的创建、诊断和评审。
限制:不覆盖基础设施搭建、数据库查询和 API 设计。遇到基础设施应交给 infra-architect,数据库交给 postgres-wizard,API 设计交给 api-designer,测试策略交给 test-architect。具体安装或调用步骤、收费与平台信息资料中暂未提供。