Skip to content

chore(agents): place Polish before Bug Fixes in changelog sections #1527

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
wbxl2000 merged 1 commit into from
Jul 9, 2026
Merged

chore(agents): place Polish before Bug Fixes in changelog sections #1527

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .agents/skills/sync-changelog/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -148,8 +148,8 @@ The docs changelog uses five section types:
| English section | Chinese section | Meaning |
|---|---|---|
| `### Features` | `### 新功能` | New user-facing functionality, such as a new command, flag, mode, or capability that did not exist before |
| `### Bug Fixes` | `### 修复` | Fixes for behavior that was broken |
| `### Polish` | `### 优化` | User-visible improvements to existing functionality, including UX adjustments, behavior tweaks, and performance improvements that are not fixes or new capabilities |
| `### Bug Fixes` | `### 修复` | Fixes for behavior that was broken |
| `### Refactors` | `### 重构` | Internal changes with no user-visible behavior change, including build, CI, tests, dependency cleanup, and internal renames |
| `### Other` | `### 其他` | Anything that does not fit above, such as CDN/endpoint swaps and docs-related artifacts |

Expand All @@ -176,7 +176,7 @@ Keyword hints:
Within each version, section order is:

```text
Features → Bug Fixes → Polish → Refactors → Other
Features → Polish → Bug Fixes → Refactors → Other

@chatgpt-codex-connector chatgpt-codex-connector Bot Jul 9, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Keep pre-changelog ordering instructions in sync

Changing this canonical order leaves the preview workflow with contradictory hard-coded ordering: .agents/skills/pre-changelog/SKILL.md still says to bucket/render Features / Bug Fixes / Polish / Refactors / Other and lists the Chinese headings as 新功能 / 修复 / 优化 / 重构 / 其他 (lines 42-43, with the sample output showing 修复 before any polish section). For release PRs that contain both fixes and polish, running pre-changelog can therefore produce the old preview order while the post-release docs sync uses the new order, defeating the intended pre-release review of the final changelog layout.

Useful? React with 👍 / 👎.

```

Omit empty sections. Within each section, order entries by reader value, not upstream order:
Expand Down
Loading