Files
5chan/.codex/skills/release-description/SKILL.md
T
Tommaso CasaburiandGitHub a92b185a66 chore(ai-workflow): track repo-managed review tooling (#1046)
* chore(ai-workflow): track repo-managed review tooling

* fix(ai-workflow): remove repo-specific path assumptions

Make shared workflow hooks and APK testing guidance resolve paths from the repo and contributor environment so the tooling works for all contributors, not just one machine.
2026-03-10 15:49:15 +08:00

2.1 KiB
Raw Blame History

name, description
name description
release-description Update the one-liner release description in scripts/release-body.js by analyzing commit titles since the last git tag. Use when the user asks to update the release description, release notes one-liner, or prepare release body for a new version.

Release Description

Update oneLinerDescription in scripts/release-body.js before each release.

Steps

1. Find the latest release tag

git tag --sort=-creatordate | head -1

2. List commit titles since that tag

git log --oneline <tag>..HEAD

If there are no commits since the tag, stop — nothing to update.

3. Analyze the commits

Categorize by Conventional Commits prefix:

Prefix Category
feat: New features
fix: Bug fixes
perf: Performance improvements
refactor: Refactors / internal changes
chore:, docs:, ci: Maintenance (mention only if significant)
No prefix Read the title to infer category

4. Write the one-liner

Compose a single sentence that summarizes the release at a high level. Rules:

  • Start with "This version..." or "This release..."
  • Be concise — one sentence, no bullet points
  • Highlight the most impactful changes — lead with the biggest features or fixes
  • Group similar changes — e.g. "several bug fixes" instead of listing each one
  • Use plain language — this is user-facing, not developer-facing
  • Don't mention every commit — summarize the theme

Examples of good one-liners:

  • "This version adds backlinks for quoted posts, a copy user ID menu item, and several bug fixes."
  • "This version introduces mod queue improvements and performance optimizations."
  • "This release adds pseudonymity mode support per-reply and fixes timezone display issues."

5. Update the constant

Edit oneLinerDescription in scripts/release-body.js (around line 104105):

const oneLinerDescription = 'Your new one-liner here.';

6. Verify

Read the updated line back to confirm it looks right. The string should:

  • Be a single sentence
  • End with a period
  • Not contain backticks or markdown