| name | git-pr |
| description | 创建包含正确远程处理的 Pull Request |
git remote -v
# 如果 origin URL 过期，请修复它：
# git remote set-url origin https://github.com/AI-Cultivation/cultivation-world-simulator.git
git checkout main && git pull origin main
git checkout -b <github-username>/<branch-name>
git add <files>
git commit -m "<type>: <description>"
git push -u origin <github-username>/<branch-name>
gh pr create --head <github-username>/<branch-name> --base main --title "<type>: <description>" --body "<body>"
main 分支拉取新分支，而不是从当前分支.github/PULL_REQUEST_TEMPLATE.md 中的 PR 模板<github-username>：例如 xzhseh<type>：feat | fix | refactor | test | docsUse when working on tools/img_gen avatar image generation, OpenAI-compatible image API config, human or yaoguai portrait prompts, qi-refining base generation, image-to-image realm edits, white-background postprocessing, manifests, or prompt rules that preserve pixel-art identity while changing cultivation realms.
规划、实现或重构角色扮演模式（默认上帝视角下的单角色接管）时使用。适用于一期文本决策、二期统一有限选择框架、三期依附 Conversation 动作的自由对话，以及对应的 runtime/API/frontend/test 收口。
规划或实现面向外部 agent / Claw 的稳定控制 API，优先做底层分层、query/command 收口、runtime 串行化与契约文档，而不是零散补接口
运行 Phase 2 工作流。执行脚本扫描缺失的多语言词条，并按注册表补全启用语言（如 en-US、zh-TW、vi-VN、ja-JP），最后修复相关测试。
国际化 (i18n) 开发指南。在添加新文本、创建物品/事件、修改翻译或管理 PO/MO 文件时使用。
运行项目测试（涵盖 Python 后端、Vue 前端及多语言校验）