GitHub Release Assistant
Overview
Generate polished README files in English and Chinese using repo facts plus a small config file, following a concise “Redmax-style” layout. Produce README.md
- README.zh.md , then optionally guide a clean git commit and push.
Workflow
-
Collect repo facts from config.json , README.md , PROJECT_STRUCTURE.md , requirements*.txt , and docs/ .
-
Ask for missing details or have the user fill release_assistant.json (see assets/release_config.example.json ).
-
Run the generator script to write README files.
-
Review the diff with the user and refine content if needed.
-
If requested, stage/commit/push changes with explicit confirmation.
Quick Start
-
Create or edit release_assistant.json in the repo root (optional but recommended).
-
Run: python3 /Users/cuizhanlin/.codex/skills/github-release-assistant/scripts/generate_release_readme.py --project-root <repo> --language both --overwrite
-
Verify README.md and README.zh.md .
Git Workflow (Commit + Push)
-
Run git status and git diff to show changes.
-
Ask for confirmation before git add , git commit , and git push .
-
Propose a concise commit message (e.g., docs: add bilingual README ), and wait for approval.
Resources
-
Script: scripts/generate_release_readme.py .
-
Templates: assets/readme_template_en.md , assets/readme_template_zh.md .
-
Config example: assets/release_config.example.json .
-
Style cues: references/redmax_style.md .
-
Outline guide: references/readme_outline.md .