该技能用于在创建 PR 前执行合规检查,适用于 ActivityPub 插件的开发与协作流程。主要内容如下:
分支命名:新功能用 add/{feature},迭代已有功能用 update/{feature},修 bug 用 fix/{bug},实验性想法用 try/{idea}。保留前缀 release/{X.Y.Z}(仅发布)与 trunk(主分支)。
预审范围:只审改动内容,不审整个 PR。文档类(*.md、docs/、README)、工具或配置类(.claude/、.agents/、workflow 文件)以及琐碎修改(错别字、注释、空白)可直接提 PR;仅当分支改动插件代码(PHP/JS/CSS 逻辑)时才运行代码审查代理,并在继续前处理严重问题。
创建 PR 要求:指派 @me,添加 Automattic/fediverse 为审阅者,包含 changelog 条目或打上 "Skip Changelog" 标签,通过 CI 检查,与 trunk 干净合并。命令:gh pr create --assignee @me --reviewer Automattic/fediverse。必须使用 .github/PULL_REQUEST_TEMPLATE.md 中的模板,不要自定义格式。PR 正文与评论中反引号直接书写,无需转义。
Changelog:面向最终用户而非开发者,用户在 WordPress 插件更新界面阅读,避免内部术语、类名与方法名,描述用户视角的变化,并以标点结尾。遗漏时可执行:composer changelog:add。
工作流:创建分支前先 git checkout trunk && git pull origin trunk,再建分支。推前检查包括 composer lint(PHP 规范,composer lint:fix 自动修复)、npm run lint:js(JS 改动时)、npm run lint:css(CSS 改动时)、npm run env-test(测试)、npm run build(资源改动时)。保持分支更新用 git fetch origin、git rebase origin/trunk,必要时 git push --force-with-lease。
特殊情形:热修复用 fix/critical-issue,改动最小化,加 [Pri] High 或 [Pri] BLOCKER 标签并请求加急审阅;实验性用 try/ 前缀并标为草稿;多 PR 功能先建跟踪 issue 并统一命名。标签涵盖 Bug、Enhancement、Docs、Code Quality、Skip Changelog、[Status] Needs review、[Status] In Progress、[Pri] High / [Pri] BLOCKER。完整细节见 docs/pull-request.md 与 AGENTS.md。