⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

WordPress ActivityPub插件发布流程指南：版本管理与更新日志自动化

release by automattic/wordpress-activitypub

58 周安装量

566 GitHub Stars

GitHub

安装命令

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

自动化版本控制 WordPress

🇨🇳中文介绍

ActivityPub 发布流程

WordPress ActivityPub 插件管理版本发布和更新日志的快速参考。

快速参考

发布命令

npm run release              # 创建主要/次要版本发布 PR。

版本文件位置

手动更新版本时，请修改以下文件：

activitypub.php - 插件头部 (Version: X.Y.Z)。
readme.txt - WordPress.org 说明文件 (Stable tag: X.Y.Z)。
package.json - npm 版本 ("version": "X.Y.Z")。
CHANGELOG.md - 更新日志文件（由发布脚本自动更新）。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

主要/次要版本发布

快速工作流：

# 1. 从插件根目录运行发布脚本。
npm run release

# 脚本自动执行：
# - 根据更新日志条目确定版本号。
# - 更新所有文件中的版本号。
# - 更新 CHANGELOG.md。
# - 创建供审查的 PR。

# 2. 审查并合并发布 PR。

# 3. 使用新标签从主干创建 GitHub 发布。

详细步骤请参阅发布流程 - 主要/次要版本。

快速工作流：

# 1. 从要修补的标签创建分支。
git fetch --tags
git checkout -b tags/5.3.1 5.3.0  # 修补 5.3.0 -> 5.3.1

# 2. 从主干挑选合并提交（注意 -m 1 标志）。
git cherry-pick -m 1 <commit-hash>

# 3. 更新更新日志和版本号。
composer changelog:write

# 手动更新以下文件中的版本号：
# - activitypub.php
# - readme.txt
# - package.json

# 4. 推送分支并创建 GitHub 发布。
git push -u origin tags/5.3.1

重要提示： 挑选合并提交时使用 -m 1 标志以选择主线父提交。

详细步骤请参阅发布流程 - 补丁版本。

更新日志通过 PR 工作流自动管理：

PR 模板 (.github/PULL_REQUEST_TEMPLATE.md)：
- 勾选“自动创建更新日志条目”复选框。
- 选择重要性级别：补丁/次要/主要。
- 选择类型：新增/修复/变更/弃用/移除/安全。
- 编写消息并以标点符号结尾！
GitHub Action (.github/workflows/changelog.yml)：
- 根据 PR 描述创建更新日志文件。
- 验证标点符号是否正确。
- 保存到 .github/changelog/ 目录。
发布流程：
- npm run release 汇总所有条目。
- 自动更新 CHANGELOG.md 和 readme.txt。

更新日志消息必须始终以标点符号结尾：

✅ 添加对自定义文章类型的支持。
✅ 修复签名验证错误。
❌ 添加对自定义文章类型的支持
❌ 修复签名验证错误

编写对最终用户友好的消息：

关注用户利益，而非实现细节。
尽可能避免技术术语。
描述用户现在可以做什么，而不是内部如何运作。

✅ 添加预构建的区块模式，便于配置个人资料和侧边栏。 ✅ 修复作者页面未显示关注按钮的问题。 ❌ 在 class-blocks.php 中添加 register_patterns() 方法。 ❌ 重构 User 类以使用 Actors 集合。

切勿在更新日志消息中提及 AI 工具或编码助手。

完整更新日志要求请参阅PR 工作流 - 更新日志。

语义化版本控制：

主要版本 (X.0.0) - 破坏性变更。
次要版本 (0.X.0) - 新功能，向后兼容。
补丁版本 (0.0.X) - 仅错误修复。

发布脚本根据更新日志条目的重要性级别自动确定版本。

2026 年 1 月 23 日

🇺🇸English

ActivityPub Release Process

Quick reference for managing releases and changelogs for the WordPress ActivityPub plugin.

Quick Reference

Release Commands

npm run release              # Create major/minor release PR.

Version File Locations

When updating versions manually, change these files:

activitypub.php - Plugin header (Version: X.Y.Z).
readme.txt - WordPress.org readme (Stable tag: X.Y.Z).
package.json - npm version ("version": "X.Y.Z").
CHANGELOG.md - Changelog file (auto-updated by release script).

Comprehensive Release Guide

See Release Process for complete release workflow and detailed steps.

Release Workflow

Major/Minor Releases

Quick workflow:

# 1. Run release script from plugin root.
npm run release

# Script automatically:
# - Determines version from changelog entries.
# - Updates version numbers in all files.
# - Updates CHANGELOG.md.
# - Creates PR for review.

# 2. Review and merge the release PR.

# 3. Create GitHub release from trunk using the new tag.

See Release Process - Major/Minor for detailed steps.

Patch Releases

Quick workflow:

# 1. Create branch from the tag to patch.
git fetch --tags
git checkout -b tags/5.3.1 5.3.0  # Patch 5.3.0 -> 5.3.1

# 2. Cherry-pick merge commits from trunk (note -m 1 flag).
git cherry-pick -m 1 <commit-hash>

# 3. Update changelog and versions.
composer changelog:write

# Manually update versions in:
# - activitypub.php
# - readme.txt
# - package.json

# 4. Push branch and create GitHub release.
git push -u origin tags/5.3.1

Important: Use -m 1 flag when cherry-picking merge commits to select the mainline parent.

See Release Process - Patch Releases for detailed steps.

Changelog Management

How It Works

Changelogs are managed automatically through the PR workflow:

PR Template (.github/PULL_REQUEST_TEMPLATE.md):
- Check "Automatically create a changelog entry" checkbox.
- Select significance: Patch/Minor/Major.
- Select type: Added/Fixed/Changed/Deprecated/Removed/Security.
- Write message ending with punctuation!
GitHub Action (.github/workflows/changelog.yml):
- Creates changelog file from PR description.
- Validates proper punctuation.
- Saves to .github/changelog/ directory.
Release Process :
- npm run release aggregates all entries.
- Updates CHANGELOG.md and readme.txt automatically.

Critical Requirements

Always end changelog messages with punctuation:

✅ Add support for custom post types.
✅ Fix signature verification bug.
❌ Add support for custom post types
❌ Fix signature verification bug

Write end-user friendly messages:

Focus on user benefit, not implementation details.
Avoid technical jargon where possible.
Describe what users can now do, not how it works internally.

✅ Add pre-built block patterns for easy profile and sidebar setup. ✅ Fix follow button not appearing on author pages. ❌ Add register_patterns() method to class-blocks.php. ❌ Refactor User class to use Actors collection.

Never mention AI tools or coding assistants in changelog messages.

See PR Workflow - Changelog for complete changelog requirements.

Version Numbering

Semantic versioning:

Major (X.0.0) - Breaking changes.
Minor (0.X.0) - New features, backward compatible.
Patch (0.0.X) - Bug fixes only.

The release script determines version automatically from changelog entry significance levels.

Weekly Installs

Repository

automattic/word…ivitypub

GitHub Stars

564

First Seen

Jan 23, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

gemini-cli39

codex39

opencode38

cursor37

claude-code37

antigravity36

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

52,700 周安装

WordPress ActivityPub插件发布流程指南：版本管理与更新日志自动化

🇨🇳中文介绍

ActivityPub 发布流程

快速参考

发布命令

版本文件位置

相关 Skills

完整发布指南

发布工作流