SuperAPI AI 工具集

scaffold-python-backend-quality-gates

部署与运维

查看项目

更新于 10-15 17:24

技能介绍

用途:当用户要为 Python 后端仓库或后端子包设计或搭建硬质量门禁时使用本技能,编写脚手架方案。范围限定在 Python 后端服务,不覆盖移动客户端或 Web 前端。\n\n主要能力: 第一层检查工具——识别可执行的 Python 后端检查,包括格式化工具、静态检查工具、类型检查器、导入边界检查器、单元测试与集成测试、环境校验、部署校验、后台任务进程或任务队列检查,以及自定义 gate 脚本。\n第二层检查规则——把每个工具映射到它执行的规则,如代码风格、类型、架构边界、默认无网络测试、测试夹具策略、环境变量要求、部署不变量或后台任务进程契约。\n第三层调用时机——决定检查在哪里运行:本地 hook 提供快速反馈,拉取请求工作流作为权威,required status check 阻塞合并,部署工作流承载发布前门禁,GitHub ruleset 约束审查要求。\n\n使用方式:先检查目标仓库的 AGENTS.md、Python 包管理文件、pyproject.toml、测试配置、导入边界工具、部署检查、GitHub 工作流、hook 脚本和已有门禁编排入口,再按三层结构形成方案。如需扩展规则或确认最新规则名,先查 references/concrete-rules.md 的官方文档入口,不要只凭记忆补规则。用 ../references/gate-levels-and-template.md 的分级表给出推荐档位与取舍,不替用户决定档位。停在 confirmation-before-write 闸门,展示准备创建或修改的精确文件和远端设置,请求用户明确批准。批准后落地最窄但有用的脚手架,运行新的本地入口,并报告仍需手工处理的 GitHub 设置。\n\n必读材料:../references/three-layer-model.md、../references/landing-safety.md、../references/github-review-and-rulesets.md、../references/invocation-examples.md、../references/gate-levels-and-template.md、references/platform-quality-gates.md、references/concrete-rules.md。路径以本技能 SKILL.md 所在目录为锚点,加载后按相对路径渐进式读取。\n\n输出形态:简洁的脚手架方案,含计划创建或修改的文件、第一层工具表、第二层规则表、第三层调用时机表、confirmation-before-write 提示,以及实现后的验证命令。\n\n限制:仅面向 Python 后端;不覆盖移动客户端与 Web 前端。具体收费、价格、平台等信息暂未提供。