mcpField
P
pr

pr

github.com/automattic开发58382 次安装1 天前更新
代码仓库

关于 pr

ActivityPub PR 工作流技能，为 WordPress ActivityPub 插件贡献者提供分支、审查与提交 PR 的规范，并涵盖变更记录和特殊发布情形。

主要功能

  1. 01分支命名规范
  2. 02按变更范围执行代码审查
  3. 03PR 必备配置与模板
  4. 04面向用户的变更记录指南
  5. 05热修复与实验分支流程

适用场景

  1. 01创建符合项目规范的功能或修复分支
  2. 02判断是否需要运行代码审查 Agent
  3. 03提交前核对 PR、CI 与变更记录要求

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/automattic/wordpress-activitypub --skill pr

安装后在 Claude Code 中输入/pr确认已加载。

详细介绍

ActivityPub PR 工作流

分支命名

前缀用途
add/{feature}新功能
update/{feature}迭代现有功能
fix/{bug}修复 Bug
try/{idea}实验性想法

保留名称： release/{X.Y.Z}（仅用于发布），trunk（主分支）。

PR 前审查

审查范围仅限于变更内容——无需审查每个 PR：

  • 跳过仅涉及文档（*.md、docs/、README）、仅涉及工具/配置（.claude/、.agents/、工作流文件）以及细微编辑（拼写错误、注释、空白字符）的变更。直接推送这些变更并创建 PR。
  • 仅当分支修改了插件代码（PHP/JS/CSS 逻辑）时，才运行 code-review Agent。继续之前，先处理所有严重问题。

创建 PR

每个 PR 都必须：

  • 指派给 @me
  • 添加 Automattic/fediverse 作为审查者
  • 包含变更日志条目，或添加 "Skip Changelog" 标签
  • 通过 CI 检查
  • 与 trunk 干净合并
# Create PR (includes required assignment/reviewer)
gh pr create --assignee @me --reviewer Automattic/fediverse

必须使用 .github/PULL_REQUEST_TEMPLATE.md 中的确切模板——不要自定义格式。

在 PR 正文和评论中直接输入反引号。在 GitHub 上，使用反斜杠转义的反引号会按字面显示；而单引号 heredoc 本身就不需要转义。

变更日志

变更日志面向最终用户，而非开发者。 用户会在 WordPress 插件更新界面中阅读这些内容。避免使用内部术语（OOM、批处理、N+1）、类名或方法名。请描述用户会感受到的变化，或从用户角度说明有哪些改动。

✅ Fix automatic cleanup of old activities failing silently on sites with many items.
✅ Add a Site Health check that warns when plugins are causing too many federation updates.
❌ Fix collection purge methods to batch deletions and enforce a hard item cap.
❌ Add Site Health test to detect excessive outbox activity rates.

所有变更日志内容都必须以标点符号结尾。

如果忘记添加，请手动补上：

composer changelog:add
git add . && git commit -m "Add changelog entry" && git push

完整的变更日志详情请参阅 release。

工作流

创建分支
git checkout trunk && git pull origin trunk
git checkout -b fix/notification-issue
推送前检查
composer lint         # PHP standards (composer lint:fix to auto-fix)
npm run lint:js       # If JS changed
npm run lint:css      # If CSS changed
npm run env-test      # Run tests
npm run build         # If assets changed

完整命令请参阅 AGENTS.md。

更新分支
git fetch origin
git rebase origin/trunk
# Resolve conflicts if any
git push --force-with-lease

特殊情况

紧急修复： 创建 fix/critical-issue 分支，尽量减少改动，添加 [Pri] High（或 [Pri] BLOCKER）标签，并请求加急审查。

实验性改动： 使用 try/ 前缀，将 PR 标记为草稿，尽早获取反馈，确认后改用正式的分支类型。

多 PR 功能： 创建跟踪问题，关联所有 PR，统一命名（如 add/feature-part-1 等），并按顺序合并。

标签

标签用途
Bug修复 Bug
Enhancement新功能
Docs文档更新
Code Quality重构、清理等
Skip Changelog无需变更日志
[Status] Needs review已准备好审查
[Status] In Progress仍在进行中
[Pri] High / [Pri] BLOCKER紧急／加急

参考

完整工作流详情请参阅 docs/pull-request.md。

评论

支持 Markdown