// 规划、实现或重构角色扮演模式（默认上帝视角下的单角色接管）时使用。适用于一期文本决策、二期统一有限选择框架、三期依附 Conversation 动作的自由对话，以及对应的 runtime/API/frontend/test 收口。
| name | roleplay-mode-implementation |
| description | 规划、实现或重构角色扮演模式（默认上帝视角下的单角色接管）时使用。适用于一期文本决策、二期统一有限选择框架、三期依附 Conversation 动作的自由对话，以及对应的 runtime/API/frontend/test 收口。 |
当任务涉及以下任一方向时使用本技能：
RoleplaySession、pending_request、conversation_sessionsingle_choice / mutual action choice 接玩家接管Conversation 对话链、summary、dock chat UI 做改动RoleplaySessionpending_requestconversation_session以上都属于 runtime，必须在 load / reinit / reset / start 后清空。
if roleplay ... else ...build_request()apply_decision(...)Conversation优先查看：
docs/specs/avatar-roleplay-mode.mddocs/specs/single-choice-unified-framework.md.cursor/rules/roleplay-mode.mdc如果改动涉及外接 API，再补看：
docs/specs/external-control-api.md.cursor/rules/external-control-api.mdc后端常见入口：
src/server/runtime/session.pysrc/server/services/roleplay_service.pysrc/server/api/public_v1/command.pysrc/server/api/public_v1/query.pysrc/systems/single_choice/**/*.pysrc/classes/mutual_action/conversation.py前端常见入口：
web/src/stores/roleplay.tsweb/src/components/game/RoleplayDock.vueweb/src/components/game/roleplay/*.vueweb/src/api/modules/avatar.tsweb/src/types/api.tsConversationdecision 型 request？choice 请求？Conversation 动作触发？RoleplayDock 应维持统一骨架：
decision / choice / conversation 只切 request body，不重新发明整页布局改动 roleplay 主链时，优先同步：
docs/specs/avatar-roleplay-mode.mddocs/specs/single-choice-unified-framework.md.cursor/rules/roleplay-mode.mdcAGENTS.md建议至少运行：
pytest tests/test_public_api_v1.py tests/test_single_choice.py tests/test_action_social.py tests/test_mutual_actions.py -q
cd web && npm run type-check
cd web && npm run test
Use 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.
规划或实现面向外部 agent / Claw 的稳定控制 API，优先做底层分层、query/command 收口、runtime 串行化与契约文档，而不是零散补接口
运行 Phase 2 工作流。执行脚本扫描缺失的多语言词条，并按注册表补全启用语言（如 en-US、zh-TW、vi-VN、ja-JP），最后修复相关测试。
国际化 (i18n) 开发指南。在添加新文本、创建物品/事件、修改翻译或管理 PO/MO 文件时使用。
运行项目测试（涵盖 Python 后端、Vue 前端及多语言校验）
创建包含正确远程处理的 Pull Request