用途:把 Drupal 贡献请求路由到对应的贡献质量阶段,并提供贡献知识层。它本身不运行各阶段,每个阶段由独立的工作技能执行。核心原则为“证据胜于断言”:每道关卡只依据产出的工件通过,例如命令输出、文件差异、实时 API 响应或真实流水线结果,绝不依据模型自称“完成”“通过”或“应该可行”。贯穿性纪律位于 contribution-guardrails 技能,在 issue 与 verify 之间的任何开发中调用。
主要能力:贡献弧线共六个阶段,由检测驱动而非强制顺序。各阶段自行检查所需状态并运行,不依赖前序阶段是否执行;贡献者可从 issue(环境就绪)甚至 verify(工作已在进行)进入。发现真实缺口的阶段只指向该缺口的 setup,不会拒绝运行,setup 是入口而非前置条件。阶段与命令:1 环境入职 /drupal-ai-contrib:setup(contribution-setup);2 处理 issue /drupal-ai-contrib:issue(contribution-issue);3 本地验证(内循环)/drupal-ai-contrib:verify(contribution-verify);4 诚实评审 /drupal-ai-contrib:review(contribution-review);5 提交 MR /drupal-ai-contrib:submit(contribution-submit);6 确认真实流水线 /drupal-ai-contrib:pipeline(contribution-pipeline)。当请求未指明具体命令时按意图路由:搭建 DDEV 环境、脚手架 CI 配置、安装 Drupal AI 技能→contribution-setup;查找/创建/认领 issue、检出 issue fork 与分支→contribution-issue;运行本地 drupalci 对等/AI 政策/评估关卡→contribution-verify;获取诚实、全新上下文的评审→contribution-review;创建或更新合并请求、撰写 AI 披露评论→contribution-submit;检查权威的真实 GitLab MR 流水线→contribution-pipeline;在 issue 与 verify 之间安全开发→contribution-guardrails。请求模糊时应询问属于哪个阶段,不要猜测。
使用方式与知识层:技术操作指南(正确编写代码、贡献机制、编码标准、drupalci 流水线)来自 camoa/dev-guides 贡献指南,而非本插件;通过 dev-guides-navigator 技能加载,切勿直接抓取 llms.txt 或 dev-guides URL。references/dev-guides-index.md 将每个贡献阶段映射到需加载的 dev-guide slug,工作技能引用这些 slug;尚未编写的指南不会解析,导航器会优雅降级,绝不因缺少指南而阻塞。治理层 AI 政策、合规与评估锚定 ai_best_practices(Drupal AI 的规范事实来源)与已采用的《在贡献 Drupal 时使用 AI 的政策》,两者由 ai-policy-checker 代理在每次贡献时实时获取,绝不硬编码或假设,因为这是变化最快的领域。
与其他部分的关系:一次贡献是一个 ai-dev-assistant 任务,该框架负责阶段生命周期(研究→架构→实现→评审→完成)及其阶段关卡;本插件是框架之外的独立层,在其上增加贡献质量命令与关卡,不分支或修改框架,应把贡献作为 ai-dev-assistant 任务运行并同时使用本插件的命令。互操作遵循“委托而非重造”:阶段生命周期与关卡→ai-dev-assistant;哲学/标准评审(SOLID、DRY)→code-quality-tools;提交前的纸面测试→code-paper-test;issue/MR/流水线 CLI→mglaman/drupalorg-cli,可执行文件 drupalorg,由 issue/submit/pipeline 包装,见 references/drupalorg-cli.md;Drupal AI 技能安装→drupal_devkit。
示例:用户说“我想为 Pathauto 模块贡献一个修复”,识别为未指明阶段的 Drupal 贡献请求,尚无环境上下文,路由到 contribution-setup 检测工作流与环境,再到 contribution-issue,从而在正确阶段入职而不猜测。用户说“在我提交前检查我的 Drupal 贡献”,工作已在进行,跳过 setup/issue,路由到 contribution-verify(关卡)再到 contribution-review(诚实评审),即从 verify 进入,不强制更早阶段。
排障:请求可能属于两个阶段时,询问属于哪个阶段,绝不猜测路由;dev-guide slug 无法解析时,导航器优雅降级,继续执行且不阻塞;贡献者要求跳过某阶段时,允许,因为弧线由检测驱动,但应指出被跳过阶段本会产出的证据;请求属于 Drupal 开发但非贡献时,超出范围,这是贡献质量而非通用 Drupal 开发,交由 ai-dev-assistant。参考:references/dev-guides-index.md(贡献阶段→需加载的 dev-guide slug)、references/drupalorg-cli.md(drupalorg CLI 是什么、安装、子命令)。