Python 仓库需要在接入 CI 前建立一套综合质量基线时选用。
用于超越基础代码检查,强制执行高级 Python 代码质量门禁。触发条件包括:认知复杂度、
面向开发者的 9 个代码质量 Skill,覆盖静态分析与规则门禁、可维护性与技术债、发布就绪与回滚检查。页面说明如何固定仓库基线和例外流程,比较有效问题、误报、修复成本与规则覆盖,避免与单次 Diff 审查意图重叠。
代码质量 Skill 是帮助 Agent 按已知规则检查静态问题、可维护性、质量阈值和发布风险的任务技能。它与代码审查的侧重不同:审查页关心“这次改动有什么问题”,本页关心“仓库是否达到团队可持续交付的工程标准”。它们可以输出规则证据,但不应用一个通用分数代替团队的门禁决策。
| 应用场景 | 主要作用 |
|---|---|
| 静态分析与规则门禁 | 把 lint、复杂度、重复、依赖和架构边界写成仓库可执行规则,再决定哪些失败应阻断 CI。这一组负责维护长期基线,不评价某一条 PR 评论是否写得好。 |
| 可维护性与技术债 | 从代码气味、模块职责、依赖方向和变更历史判断维护成本,形成有位置、有优先级和有验证路径的技术债清单。这一组面向仓库健康,而不是一次 diff 的合入意见。 |
| 发布就绪与回滚门禁 | 在部署前检查发布前提、验证证据、回滚路径和上线后观察项,并把阈值、责任人和例外期限写清楚。这一组服务 go/no-go 治理,不替代代码审查。 |
本文整理 9 个代码质量 Skill。静态分析组负责把规则转成可执行门禁,技术债组评估长期维护成本,发布就绪组核对验证证据与回滚路径;三组都服务仓库基线和发布治理,不重复一次 diff 的审查意图。
DeepSkill 将代码质量中的静态规则、技术债治理和发布就绪任务整理成可直接安装的 Skill,你可以根据当前治理阶段灵活使用。本页推荐的 9 个 Skill 分别面向静态分析与规则门禁、可维护性与技术债、发布就绪与回滚;选择时固定同一仓库基线和例外流程,再比较有效问题、误报、修复成本和规则覆盖。
把 lint、复杂度、重复、依赖和架构边界写成仓库可执行规则,再决定哪些失败应阻断 CI。这一组负责维护长期基线,不评价某一条 PR 评论是否写得好。
从代码气味、模块职责、依赖方向和变更历史判断维护成本,形成有位置、有优先级和有验证路径的技术债清单。这一组面向仓库健康,而不是一次 diff 的合入意见。
在部署前检查发布前提、验证证据、回滚路径和上线后观察项,并把阈值、责任人和例外期限写清楚。这一组服务 go/no-go 治理,不替代代码审查。
DeepSkill 收录40万+ Skills,所有skill都经过真实的安全审查与风险验证。静态分析、复杂度预算、技术债诊断、架构边界和发布就绪都可以按任务单独查找。写明语言、仓库规模、现有规则、历史阈值、CI 环境和发布阶段,才能找到真正适合维护工程基线的候选。
在搜索框写明语言、仓库规模、现有 lint 与类型规则、历史复杂度阈值、CI 环境和发布阶段,并指出要解决的是规则缺口、技术债还是发布门禁。
比较候选检查的对象、需要的工具与权限、输出的规则证据和适用边界;静态规则、技术债诊断和发布就绪应分开选择。
复制一个安装口令,在同一仓库基线和规则集下试跑,记录有效问题、误报、运行时间与例外,再决定是否写入 CI。
如果希望 Agent 在任务中主动查找 Skill,可以把下面的安装指令直接发送给它。完成安装后,Agent 就能根据当前任务搜索并安装匹配的 Skill。该指令适用于 Codex、Claude Code、WorkBuddy 等主流 Agent。
根据 https://www.deepskill.market/deepskill.md 安装 DeepSkill。使用代码质量 Skill 前,先固定 lint、测试、复杂度、错误处理和文档等团队基线,并提供历史阈值与允许例外。要求每个阻断项都说明规则、位置、风险和修复方式;对误报使用有责任人、理由和失效时间的例外流程,不要直接删掉规则。
列出必须通过的 lint、类型、复杂度、依赖、测试和架构规则,并标明哪些只告警、哪些阻断。
给出规则配置、历史阈值、模块边界、CI 日志和已接受例外,不要只提供一段孤立 diff。
初次试跑只允许读取仓库和本地执行检查;修改配置、推送分支和发布必须单独确认。
记录有效问题、误报、重复项、运行时间和修复成本,拒绝没有规则来源的综合评分。
为阈值变化和发布例外设置责任人、原因、失效时间与恢复步骤,避免临时绕过变成永久策略。
只将多次试跑后稳定、可解释且有维护人的规则写入团队流水线。
代码质量 Skill 的价值,是把团队认可的工程标准变成可重复、可解释的证据。可以先用静态分析类 Skill 固定 lint、复杂度和架构规则,再用技术债类 Skill 整理长期维护风险,最后用发布就绪类 Skill 核对验证证据与回滚路径。这三类任务面向仓库基线和发布治理,不应退回到逐条评论某一次 diff。上线后持续记录有效问题、误报、运行时间、修复成本和例外数量,定期校准阈值;只有团队能够说明规则来源、维护责任和回滚方式的门禁,才适合进入持续交付流程。
去DeepSkill探索更多好用的skill按当前问题选择:规则落地用静态分析组,长期维护成本用技术债组,上线决策用发布就绪组。不要用同一个 Skill 同时承担三类责任。
代码审查聚焦一次改动的反馈;代码质量页维护仓库级规则、技术债和发布阈值,输入通常是规则集、仓库基线与 CI 证据。
取决于具体 Skill 和授予权限。首次使用建议只读分析与本地检查,任何配置修改、远程写入和发布都保留人工确认。
持续记录有效问题、误报、重复项、运行时间、修复成本和例外数量,只保留能对应明确规则与修复动作的阻断项。
可以分阶段组合,例如先跑静态规则,再诊断技术债,最后做发布就绪检查;但每个结论要有唯一规则来源和责任人。
使用带责任人、原因、补救项和失效时间的临时例外;发布后修正规则、重跑门禁并及时回收例外。