SuperAPI AI 工具集

ub-quality

编程与开发

查看项目

更新于 10-28 16:10

技能介绍

ub-quality 是一个与主要实现、审查或工作流技能配合使用的代码质量技能,侧重在创建、修改、审查、重构或规范化代码与文档时提供共享的质量与可读性规则。

用途与使用时机 适用于新代码生成、代码编辑与重构、代码审查回复、仓库扫描与架构说明、可维护性反馈,以及改动区域内的文档、配置、注释与格式规范化;也适用于需要更清晰结构或对比格式的面向用户回复。该技能定位为伴随基线,不替代主要的实现或工作流技能,语法、运行时与框架正确性仍是首要约束。

主要能力

  • 内置基线即时生效:加载后立即应用 SKILL.md 中的内嵌基线。
  • 分隔符对齐契约:对每个被触及且符合条件的垂直分隔符块,分隔符须对齐到同一列,采用“键 : 值”的分隔符列对齐,而非“键: 值”的值列对齐;适用于代码、配置、注释、文档字符串、标记属性与文档块。内嵌 <style> 与 <script> 块按原生 CSS 与 JavaScript 格式化处理。仅语法破坏或经核实的工具/运行时限制可作为不对齐的理由。
  • 按触发加载参考:设计模式、格式对齐、文档结构重构、重要标签与文档生成、响应可读性、时效性与可移植性等参考文件按任务触发加载,不得因任务看似较小或本地风格不同而跳过。
  • 决策分析基线:对规划、设计、架构与实现方向等含选择的指导,默认给出 2 个以上可行方案,偏好 2-4 个精选选项,附简要优缺点并指明推荐路径;若只有一条实质路径,需明确说明原因而非编造选项。
  • 可读性基线:面向用户的回复先给答案或建议,使用信息性标题、短段落、项目符号与编号步骤,仅在真正多属性对比且能保持紧凑时使用表格;表格过宽或过密时改用更安全的替代结构。

使用方式(工作流) 检查任务范围与触及文件;立即应用内嵌基线;按触发加载并应用相关参考;对含选择的指导应用决策分析基线;对面向用户回复应用可读性基线并选择表格或替代结构;选择保留行为与约束的最简方案;仅在触及的逻辑块内应用格式、文档与结构规则;验证行为并说明有意保留的例外。同时应与最相关的语言/框架技能配合使用。

限制与约定 格式与对齐不作为可选清理;不得因邻近代码未对齐、风格更熟悉或块位于文档而非代码而跳过对齐;除非明确要求更广规范化,否则不规范化触及逻辑范围外的无关块。该技能中,对齐契约与触发参考工作流在加载后属于仓库策略;通过同级技能协调的许多语言/框架建议是强默认而非通用可移植要求;易变的环境配置配方先视为时效性复查候选,除非仓库明确升格为策略。完成前需检查所有触及的合格分隔符块,按最长左侧令牌规则对齐,确认未规范化无关块,并遵守特殊注释标签与 AGENT_TODO 处理策略。