القائمة
通用 Python 开发门禁技能。统一执行 Ruff 与 Pyright，并支持多目录目标与自动发现。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | python-quality-gate |
| description | 通用 Python 开发门禁技能。统一执行 Ruff 与 Pyright，并支持多目录目标与自动发现。 |
这个技能用于统一执行 Python 质量门禁，默认一次性执行：
ruff checkpyright.agents/skills/）：
python -m compileall .agents/skills.agents/。推荐在游戏模块内提供：
<game_module>/skills/SKILL.md<game_module>/skills/scripts/mechanical_gate.py<game_module>/skills/scripts/dynamic_agent_playtest.py<game_module>/skills/scripts/build_subagent_test_plan.py<game_module>/tests/test_*.py测试目录约束：
<game_module>/tests/。tests/ 仅用于跨模块或工作区级集成测试。其中动态测试脚本应支持主 agent 将任务分发给 subagents（如 runSubagent）并汇总结果。
python3 .agents/skills/python-quality-gate/scripts/python_gate.py
python3 .agents/skills/python-quality-gate/scripts/python_gate.py --targets src sandbox
说明：
--targets 支持一个或多个目录，例如 --targets src 或 --targets src sandbox。python3 .agents/skills/python-quality-gate/scripts/python_gate.py --skip-functional
python3 .agents/skills/python-quality-gate/scripts/python_gate.py --skip-skill-gates
python3 .agents/skills/python-quality-gate/scripts/python_gate.py --skip-ui-gate
配置文件：
.agents/skills/python-quality-gate/pyrightconfig.skills-strict.json本地手动开启：
python3 .agents/skills/python-quality-gate/scripts/python_gate.py --strict-skills
临时跳过：
python3 .agents/skills/python-quality-gate/scripts/python_gate.py --skip-strict-skills
说明：
CI=1/true/yes/on 时，strict 类型门禁默认开启。python3 .agents/skills/python-quality-gate/scripts/python_gate.py \
--functional-cmd "python -m unittest pixel_coin_game.tests.test_pixel_coin_game -v" \
--functional-cmd "python -m pixel_coin_game --autoplay --no-gui --assert-optimal"
./check_errors.sh，其已委托到本技能脚本。当用户希望把一个实际问题沉淀成内部文档，并且更关心“需要决定什么”和“推荐答案是什么”时使用。适合把原始 query 拆成多个决策题，再直接给默认答案、例外条件和最终建议的写法。
Python 前端开发总技能：提供通用 references + 调度 scripts，按模块加载各游戏自己的 UI 调试与质量门禁脚本，并将缓存统一写入 .agent_cache。
当任务要求在 `.agents/sandbox/` 下隔离工作区时使用。适用于需要先按日期分组、再在当天目录下按“时间（精确到秒）+ task_name”创建任务目录，并将脚本/中间产物/最终结果集中写入该目录、尽量不污染仓库主目录的场景。
当用户要求把本次任务记录成中文日志，并落到 `.agents/logs/timeYYYYMMDD/timeHHMMSS+task_name` 这类时间路径下时使用。适用于需要记录用户原始 query、精简理解、实际执行动作和改动文件的场景。
创建或修改 TeX/LaTeX 文档。适用于新建中文笔记、讲义、报告、幻灯片，或整理 TeX 目录结构，特别是需要把 tex、pdf、build 分开的任务。
当用户从 0 基础学习 notebook、章节、论文或方法，希望 AI 主动模拟新手提问，而不是等用户逐图提问时使用。适合按“背景问题 -> 朴素直觉 -> 数学表达 -> 代码对应”的顺序解释，并在需要时沉淀成中文 TeX/PDF 讲义。