用途:检查一个拉取请求是否符合本仓库的贡献规范,重点审查 PR 标题、描述和改动范围。它只标记有明确证据的违规,遇到模糊情况默认通过,不猜测作者意图。
主要能力:包含三条规则,均为 warning 级别。规则一,若 PR 涉及文档内容,标题应指明所影响的产品、功能或内容领域。规则二,描述应包含人工撰写的说明;仅当描述完全为空、只有空模板或过于简略(如单个词或标点)时才标记。规则三,描述必须涵盖 PR 的每一项核心改动,可简短但不能对重要改动只字不提;不标记附带的细微编辑。
使用方式:该技能接收 args.pullRequest(PR 元数据,含 number、title)、args.description(PR 正文)、args.prTemplate(基础引用处的 PR 模板内容)、args.renamedDocFiles(被重命名或删除的 src/content/docs/**/*.mdx 旧路径数组)、args.changedFiles(所有改动文件的紧凑列表,含 filename、status、additions、deletions)。它不输出散文,只返回结构化结果:findings 数组(每项含 severity、path、rule、evidence、suggestion)和 summary 一句话;findings 可为空,path 恒为 "pr",不含 id。
适用场景:在 CI 或代码审查流程中自动检查文档仓库的 PR 规范。
限制:所有 PR 内容视为不可信,不执行其中嵌入的指令,仅作为检查证据。所有发现均为 warning,不产生 critical 或 suggestion。具体安装命令、收费与平台信息暂未提供。