已开启
更新 AGENTS.md：追加 PR 合规检视路由规则 #36
gcjoke创建于 13 天前
更新 AGENTS.md：追加 PR 合规检视路由规则 #36
已开启
共 1 个文件变更+30-0
| @@ -1,3 +1,7 @@ | |||
| 1 | +> 本文件包含两个相互独立的检视入口,触发条件不同,命中任一即执行、互不排斥: | ||
| 2 | +> - **日志规则检视**:代码静态扫描任务(基于 code-inspection 规则清单); | ||
| 3 | +> - **PR 合规检视**:合入流水线 PR 检视任务,路由规则见本节,是 PR 检视路由的唯一入口。 | ||
| 4 | + | ||
| 1 | # 日志规则检视 | 5 | # 日志规则检视 |
| 2 | ## 通用代码排查技能，支持基于规则清单的代码静态分析 | 6 | ## 通用代码排查技能，支持基于规则清单的代码静态分析 |
| 3 | 使用步骤： | 7 | 使用步骤： |
| @@ -6,3 +10,29 @@ | |||
| 6 | 3. 默认无任何需要忽略扫描的文件 | 10 | 3. 默认无任何需要忽略扫描的文件 |
| 7 | 4. 输出的报告需要严格按照技能规定的格式 | 11 | 4. 输出的报告需要严格按照技能规定的格式 |
| 8 | 5. 读取报告并按照报告里描述的问题在对应的行号提出检视意见 | 12 | 5. 读取报告并按照报告里描述的问题在对应的行号提出检视意见 |
| 13 | + | ||
| 14 | +--- | ||
| 15 | + | ||
| 16 | +# PR 合规检视 | ||
| 17 | + | ||
| 18 | +在合入流水线上对本仓 PR 执行合规检视。PR 检视路由以本节路由表为唯一入口;与上方「日志规则检视」相互独立,各自触发、互不替代。 | ||
| 19 | + | ||
| 20 | +## 路由规则 | ||
| 21 | + | ||
| 22 | +收到 PR 检视任务(PR 号/URL 由流水线传入)时: | ||
| 23 | + | ||
| 24 | +1. 取本 PR 变更文件清单: | ||
| 25 | + - 用 `gitcode-mdb-interface-pr-review` skill 的 `gitcode_cli.py get-pr-files <owner> <repo> <number>`,或 | ||
| 26 | + - 本地 `git diff --name-only <merge-base>...HEAD` | ||
| 27 | +2. 按下表路由(命中多行时全部执行,可叠加多个检查): | ||
| 28 | + | ||
| 29 | + | 变更文件命中 | 动作 | | ||
| 30 | + |---|---| | ||
| 31 | + | `mds/ipmi.json` | 依次执行两项相互独立的检查,评论分开发布:① 激活 `gitcode-mdb-interface-pr-review` skill,按其 SKILL.md 完整执行:拉 PR 上下文 + 关联设计帖 → mdb/IPMI 契约一致性检视 → `submit-review` 发结构化评论;② 激活 `doc-sync-check` skill,按其 SKILL.md 完整执行:提取本次变更涉及的命令(NetFn/Cmd)→ 与 docs 主干清单/关联文档 PR 双条件比对 → `post-pr-comment` 发文档覆盖评论(仅供参考,不阻塞合入) | | ||
| 32 | + | 无命中 | 输出「未变更 mds/ipmi.json,跳过合规检视」并结束,不生成检视评论 | | ||
| 33 | + | ||
| 34 | +## 降级与容错 | ||
| 35 | + | ||
| 36 | +- 路由到的 skill 未安装时,先执行 `bingo skill sync` 后重试(`bingo` 是 openUBMC 流水线内置的 skill 管理工具,见 https://gitcode.com/openUBMC/bingo);若环境无 bingo 或重试后仍不可用,则按该 skill 的 SKILL.md 流程手动编排,无法编排时跳过该检查并在流水线日志记录(不阻塞)。 | ||
| 37 | +- 文档同步检查评论必须带「仅供参考,不阻塞合入」说明与 `head_sha: <sha>` 标记;同一 head sha 重跑不重复发(幂等)。 | ||
| 38 | +- 检查异常(网络/API 失败)输出「检查未完成」降级评论,不影响其它检视动作与合入流程。 | ||