メニュー
面向 SurveyController 仓库的设置、路径与配置迁移技能。用于修改 `software/app/`、`software/io/config/`、`software/core/config/` 里的 QSettings 键、用户目录、配置文件路径、schema 版本、序列化字段、默认值和兼容策略，避免升级后读错配置、写错目录或把旧配置直接干爆。适合做预防性演进，不适合只修表面报错。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | app-settings-migration |
| description | 面向 SurveyController 仓库的设置、路径与配置迁移技能。用于修改 `software/app/`、`software/io/config/`、`software/core/config/` 里的 QSettings 键、用户目录、配置文件路径、schema 版本、序列化字段、默认值和兼容策略，避免升级后读错配置、写错目录或把旧配置直接干爆。适合做预防性演进，不适合只修表面报错。 |
这个 skill 处理“配置怎么演进才不炸”。 重点是路径、QSettings、配置文件 schema、默认值和 UI 同步一起看，不让升级把用户数据搞烂。
software/app/settings_store.pysoftware/app/user_paths.pysoftware/app/runtime_paths.pysoftware/io/config/store.pysoftware/core/config/codec.pysoftware/core/config/schema.pysoftware/app/settings_store.pysoftware/app/user_paths.pysoftware/app/runtime_paths.pysoftware/io/config/store.pysoftware/core/config/codec.pysoftware/app/user_paths.py。software/app/runtime_paths.py 只表示安装目录和只读资源目录，别拿去存配置。CONFIG_DIRECTORY_SETTING_KEY 这种 QSettings 键改名时，要同步考虑旧值读取和页面回填。config_schema_version 前先想清楚。
当前 software/core/config/codec.py 只接受当前 schema，旧版本会直接报不兼容。
如果你要改成可迁移，必须把迁移逻辑写清楚，别半吊子。常见改法：
RuntimeConfig 增字段normalize_runtime_config_payload() 给默认值serialize_runtime_config() 和相关 UI 同步路径确认能 round-tripuser_paths.pyensure_user_data_directories() 和打开目录行为get_default_runtime_config_path()。software/io/config/store.py::_strip_json_comments()。ValueError。SURVEYCONTROLLER_QSETTINGS_FILE，CI/unit_tests/conftest.py 已经有夹具。uv run pytest CI/unit_tests/app/test_config_codec.py
uv run pytest CI/unit_tests/app/test_config_store.py
uv run pytest CI/unit_tests/app/test_settings_page_qtbot.py
uv run pytest CI/unit_tests/app/test_workbench_presenter.py
uv run pytest CI/unit_tests/app/test_workbench_pages_smoke.py
uv run python CI/python_ci.py
uv run python CI/python_ci.py --full
rg "config_schema_version|QSettings|config_directory|user_paths|load_config|save_config" software CI/unit_tests/app
test_config_codec.py、test_config_store.py 或相关 qtbot 测试。CI/python_ci.py --full。面向 SurveyController 仓库的全异步 HTTP 解析与执行链路技能。用于修改或排查 software/network/http/、software/core/engine/、software/providers/、software/network/proxy/ 以及各平台 provider 的异步请求、响应解析、任务调度、并发控制、超时、重试、取消和资源释放问题。适合处理纯 HTTP 提交链路，不适合恢复浏览器自动化兜底。
面向 SurveyController 桌面端的 GUI 开发与界面修复技能。用于修改 software/ui/ 下的 PySide6 + QFluentWidgets 页面、弹窗、导航、配置编辑、运行状态展示和日志界面，处理信号槽、线程协作、对象生命周期、布局、主题和窗口缩放问题。适合做桌面界面开发、交互修复和配置同步，不适合把耗时逻辑直接塞进主线程。
面向 SurveyController 的日志、配置与报错排查技能。用于根据用户提供的日志、截图、配置文件、调用栈、运行环境和最近改动定位根因，修复 software/app/、software/io/、software/logging/、software/network/、software/ui/ 以及平台适配层中的配置兼容、路径、编码、权限、依赖版本和平台差异问题。适合处理真实报错和配置脱节，不适合只改表面提示词。
面向 SurveyController 仓库 v3 分支的 Playwright 作答执行层技能。仅在修改或排查 Playwright 作答链路、异步浏览器 owner/context 池、BrowserDriver 封装、页面加载、运行时答题、翻页、提交、取消、超时、资源释放和并发调度时使用。只能用于 v3 分支；只允许系统自带 Microsoft Edge，不允许安装或引入 Chromium；要求全量异步，不使用 Playwright sync_api。
面向 SurveyController 仓库的题型解析、字段映射与 parser 规则技能。用于修改 `wjx/provider/`、`tencent/provider/`、`credamo/provider/`、`software/core/questions/`、`software/providers/` 中的题目结构解析、元数据字段、题型识别、逻辑规则标记、答案模型映射和最小兼容适配。适合处理 parser 规则和题目结构演进，不适合处理 HTTP 提交调度或纯接口逆向分析。
面向 SurveyController 仓库的目录结构重构与模块拆分技能。用于整理 software/、wjx/、tencent/、credamo/、CI/unit_tests/ 等真实目录，处理文件移动、命名调整、导入修复、测试路径更新、资源路径修复、CI 检查联动。适合在需要小步重构、保持行为不变、清理屎山边界时使用，不适合纯样式改名或无关大洗牌。