SuperAPI AI 工具集

contribution-submit

编程与开发

查看项目

更新于 10-16 06:59

技能介绍

用途 该技能用于在 Drupal 贡献流程中提交工作:创建或更新合并请求(MR),并在达到政策阈值时生成所需的 AI 披露评论。它作为 worker skill 支撑 /drupal-ai-contrib:submit 命令,通过 dev-guides-navigator 加载知识层,包括 drupal/contributing-with-ai/merge-request-workflow、drupal/contributing/issue-forks-merge-requests、drupal/contributing-with-ai/commit-messages、drupal/contributing-with-ai/disclosure-checkboxes、drupal/contributing/contribution-etiquette-rtbc-credit。

主要能力

  1. 提交前先决条件检查:submit 会按之前的状态运行,但在创建 MR 前会检查并提示:verify 是否运行且门禁为绿(未验证的提交正是 AI 政策所列不可接受的“drive-by”行为);review 是否运行;绿灯是否仍然有效(运行 ${CLAUDE_PLUGIN_ROOT}/scripts/reverify-list.sh,若打印路径说明这些文件在 verify 通过后被编辑,绿灯已过期,建议重新运行 verify);review 是否仍然有效(将贡献的变更文件通过 git diff --name-only <target-branch>...<issue-fork-branch> | ${CLAUDE_PLUGIN_ROOT}/scripts/review-mark.sh 传入 review 标记,若打印路径说明文件在上次 review 后被修改,review 产物过期,需显式确认而非硬阻断)。若先决条件未满足,报告并让贡献者决定,不静默阻断。
  2. 确认分支与目标:issue-fork 分支(名称含 issue 编号)与目标分支(核心为 main,贡献项目为各自项目的最新开发分支);区分草稿与就绪状态。
  3. AI 披露决策:判断 AI 是否生成了重要部分(整个函数、类、架构脚手架或大量文档块;单行自动补全豁免)。若是,则按政策要求在两处准备披露——issue 披露复选框(AI Assisted Code / AI Generated Code / Vibe Coded,视适用情况)以及 MR 描述中的 AI-Generated: Yes (...) 评论;若否,则记录已评估阈值且未跨越。政策状态通过 drupal-ai-contrib:ai-policy-checker 代理(Task 工具)获取,不依赖硬编码阈值。
  4. 提交信息:按 commit-messages 开发指南在提交信息中标注 AI 参与,保持贡献者为责任作者。
  5. 创建或更新 MR:迁移(GitLab)项目委托给 drupal-gitlab 技能(其 references/merge-requests.md)。Drupal MR 从 issue fork 到上游项目(跨项目),glab mr create 无法完成,drupal-gitlab 通过 glab api … /projects/issue%2F<project>-<id>/merge_requests 并带显式 target_project_id 创建,确认 201(误发到 git.drupal.org 会静默降级为 200 + 列表,不创建任何内容)。读取(确认并报告已有 MR)使用 drupalorg mr:list / mr:status(无需认证)或 glab mr view。遗留队列项目没有 GitLab MR,按经典补丁/队列流程通过 drupalorg / Web UI 进行,见 ${CLAUDE_PLUGIN_ROOT}/skills/drupal-ai-contrib/references/drupalorg-cli.md §Hybrid model。
  6. 写令牌安全(来自 drupal-gitlab,为约束权威):GitLab 写令牌不是项目范围的,可触达你有写权限的所有仓库;确认目标仓库/分支,未经明确人工批准不得推送到受保护分支,即使作为维护者也默认使用 issue fork。git.drupalcode.org 上 API/CLI 合并被阻止,只能通过 Web UI 合并,绝不声称执行了无法执行的合并。在任何 shell 调用前,用显式模式校验标识符——issue ID ^[0-9]+$,项目机器名 ^[a-z][a-z0-9_]*$——拒绝不匹配值,绝不插入未净化输入。凭据属于贡献者本人,绝不存储或传输。MR 描述说明:变更内容、所解决的 issue、AI 披露(§2)、以及如何验证(引用捕获的 verify 产物)。
  7. 状态与 RTBC 指引(双模式):正确设置 issue 状态(MR 就绪时为 Needs review);强调 RTBC 纪律——RTBC 主张完整清单(测试通过、phpcs 干净、讨论串已解决、核心门禁通过),绝不只是代码阅读,绝不自我 RTBC。drupal.org 经典队列与 GitLab state::* 标签不同,处理项目实际使用的系统。
  8. 报告:汇总 MR URL、目标分支、披露决定及其放置位置、设置的 issue 状态、以及下一步(流水线——真实流水线是权威的最终门禁)。避免过度声称:绝不暗示 Drupal“认可 AI 贡献”,绝不保证 MR 被接受,绝不做 GPL 或来源保证;贡献者对提交负全责,包括版权与许可。

使用方式 通过 /drupal-ai-contrib:submit 命令(参数为 issue 编号)触发。示例 1:AI 生成了整个服务类,超过“重要部分”阈值,则在 issue 披露复选框和 MR 描述中准备披露,并通过 ai-policy-checker 获取当前政策,MR 在两处必需位置带有披露。示例 2:在没有绿色 verify 运行的情况下提交,技能会指出 verify 未产生绿色门禁,如实报告并让贡献者决定是否继续,不静默阻断但点明 drive-by 风险。

适用场景 适用于 Drupal 核心或贡献项目的 AI 辅助贡献提交流程,特别是需要按政策进行 AI 披露、需要处理 issue fork 到上游的跨项目 MR、以及需要区分迁移项目与遗留队列项目的场景。

限制与处理 verify/review 未运行:提示并报告,不拒绝,由贡献者决定。上次 review 后文件被修改:review-mark.sh 打印过期路径,提示过期警告并要求确认,绝不阻断;重新运行 review 会重新打标记。drupalorg 未安装:提示 references/drupalorg-cli.md 中的安装步骤,不编造 MR URL。推送到 issue fork 被拒:可能是 drupal.org SSH 密钥缺失/未注册,指向 setup §5 和 references/drupalorg-cli.md §Authentication,无推送则无 MR。MR 创建调用返回 200 + 列表(未创建):glab api 写被误发到 git.drupal.org,须发往 git.drupalcode.org,重新发出并确认 201。glab 未安装或写认证失败:迁移项目 MR 创建需要 glab + 写范围令牌(glab auth login --hostname git.drupalcode.org),读取/报告仍可通过 drupalorg 工作。披露阈值模糊:通过 ai-policy-checker 获取实时政策,仍不明确时进行披露。项目使用 GitLab state::* 标签:设置 GitLab 范围标签而非经典队列状态。