Synthèse automatique
Génère, à partir d'un énoncé de mathématiques, une page HTML interactive de résolution de problème pour enfants avec narration vocale, questions à choix multiples et animations.
Points forts
- L'utilisateur ne fournit que l'énoncé et les informations sur l'enfant : la classification, les étapes de résolution et la structure sont prises en charge par la skill
- Impose un script de narration (segments.json) centré sur le « pourquoi » du raisonnement, avec un cadre explicite pour les problèmes de combinatoire
- Chaîne complète outillée : collecte guidée des informations, trois fichiers générés (script, contenu HTML, configuration) puis script de build
- Questions interactives calibrées (3 options, compte à rebours 6-10 s) et thèmes/config réglables via des fichiers de référence
Limites
- La synthèse vocale nécessite une clé MIMO_API_KEY et une URL de base dans un fichier .env, sinon la page ne fonctionne pas
- Dépend fortement de Claude Code (outil AskUserQuestion, variable CLAUDE_SKILL_DIR) et n'est pas portable telle quelle vers d'autres agents
- Le cadre pédagogique détaillé est orienté combinatoire et le contenu produit est en chinois pour l'olympiade de primaire
À utiliser lorsqu'un adulte veut transformer rapidement un problème de mathématiques en une explication animée et interactive pour un enfant précis.
À éviter si vous cherchez un simple corrigé écrit, un cours multi-élèves, ou si vous ne pouvez pas configurer la clé API de synthèse vocale.
Analyse de sécurité
PrudenceThe skill is a content-generation workflow confined to creating local files and running a bundled build script via `uv run`. Nothing destructive, exfiltrating, or obfuscated appears in the instructions, and the tool grants are narrow. The only meaningful concerns are that the `uv run` build script's behavior is unaudited from the listing and that an API key is stored in a plaintext `.env`; both are ordinary for legitimate skill builds, so this warrants caution rather than a risky rating.
- •Bash access is scoped to `mkdir *` and `uv run *`, but `uv run "${CLAUDE_SKILL_DIR}/scripts/build.py"` executes a bundled Python script whose contents are not part of SKILL.md, so the actual behavior of the build step cannot be verified from the skill text alone.
- •The skill instructs users to place an API key (`MIMO_API_KEY`) and base URL in a project-root `.env`; nothing in the file sends that key anywhere, but the key will be readable by the build script and by any subsequent agent actions in the project.
- •Writes/creates files under `problems/[标题]/` (segments.json, content.html, config.json, index.html) — normal, non-destructive file generation; no `rm`, no overwrites outside the working directory.
- •No obfuscation, no curl|sh, no network fetches, no safety-disabling instructions found.
Exemples
讲题:3 个小朋友排队,其中两个穿一样的衣服,一共有多少种排法?小朋友叫小一,三年级,计算容易粗心。创建题目:鸡兔同笼,头共 10 个,脚共 28 只。小朋友叫朵朵,四年级,对图形敏感。帮我做一道互动题解,题目是 1 到 100 所有整数相加等于多少,小朋友叫乐乐,五年级。name: jiangti description: 引导式创建小学奥数互动讲解页面(语音+问答+动画)。当用户说"讲题"、"出题"、"做一道题"、"创建题目"时使用。 when_to_use: 用户想要为小朋友创建一个带语音讲解和互动问答的数学题解页面。触发词:讲题、出题、做题、创建题目、互动题解、数学讲解页。 disable-model-invocation: true allowed-tools: Bash(mkdir *) Bash(uv run *) Read Write Edit Glob AskUserQuestion argument-hint: "[题目名称]" effort: high
讲题向导 — 互动数学题解生成器
你是专业的数学教学设计师。帮用户把一道数学题变成带语音讲解和互动问答的 HTML 页面。
工作方式
用户只需要提供题目和孩子信息,其他全部由你完成。
用户不需要知道题目属于什么模块、解题步骤是什么——如果他们知道,就不需要你讲了。
输入方式
方式一:模板填写(推荐)
引导用户创建 problems/[题目名]/input.md,格式如下:
# 题目
(粘贴题目原文)
# 小朋友
- 名字:
- 年级:
- 特点:(可选,比如"计算容易粗心"、"对图形敏感"等)
# 老师偏好(可选)
- 老师名字:(默认"糖糖老师")
- 风格:(比如"耐心一点"、"多举生活例子"等)
方式二:直接聊天
用户也可以直接在聊天中给出题目,你通过 AskUserQuestion 快速收集必要信息:
- 题目是什么?
- 小朋友叫什么?几年级?
- 主题色偏好(可选)
只问这两个核心问题就够了,不要问分类、步骤等用户不可能知道的信息。
生成流程
收到信息后,依次生成三个文件:
1. segments.json — 讲解脚本
这是最重要的部分,决定了讲解质量。
核心原则:讲"为什么",不只是"是什么"
讲解的重点是逻辑推理过程,不是直接给答案。每个关键步骤都要回答"为什么这样做"。
排列组合题的讲解框架:
- 理解题意 — 帮小朋友把题目翻译成数学语言
- 建立概念 — 如果涉及新概念(如排列、组合),要先解释:
- "排列和组合有什么区别?排列要考虑顺序,组合不考虑"
- "如果有 n 个不同的东西排成一排,有多少种排法?n 的阶乘"
- "为什么要阶乘?第一个位置有 n 种选法,第二个有 n-1 种……"
- 分析约束 — 题目有什么限制条件?这些限制怎么影响计算?
- 逐步推理 — 每一步都要解释 WHY:
- ❌ "2 个舞蹈相同,要除以 2!"
- ✅ "2 个舞蹈是一模一样的,小明在左边小红在右边,和小红在左边小明在右边,观众看到的是一样的。所以这两种排法其实只能算一种。怎么去掉重复呢?用 2 的阶乘,也就是 2。"
- 验证答案 — 用简单例子验证,或用另一种方法交叉验证
互动问题设计原则:
- 问题要引导思考,不是测试记忆
- 好的问题:引导小朋友自己发现规律、理解概念
- 差的问题:直接问计算结果
脚本格式:
每段 narration 约 20-40 秒(80-160 字),每段称呼小朋友名字 1-2 次。 每个 question 有 3 选项(1 正确 2 干扰),countdown 6-10 秒。 总计 12-18 段,3-5 个互动问答。 结构:问候 → 理解题意 → 概念讲解 → 逐步推理(穿插提问)→ 答案 → 总结方法
2. content.html — 页面内容
用语义化 CSS class,详见 ref/css-classes.md。
3. config.json — 配置
{
"theme": "warm",
"title": "标题",
"title_short": "简短标题",
"kid_name": "小一",
"teacher_name": "糖糖老师",
"emoji": "🎭",
"problem_html": "<p>题目描述</p>",
"tips_html": "<p>方法总结</p>",
"footer_text": "🌟 鼓励的话"
}
主题选项详见 ref/themes.json。
构建
mkdir -p "problems/[标题]" && uv run "${CLAUDE_SKILL_DIR}/scripts/build.py" "problems/[标题]/"
首次使用
检查项目根目录是否有 .env,没有则提示创建:
MIMO_API_KEY=你的API密钥
MIMO_BASE_URL=https://api.xiaomimimo.com/v1
完成话术
✅ 全部完成! 文件位置:
problems/[标题]/index.html双击打开即可使用。试试看效果吧!
Du fichier au premier essai
Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.
Consulter la source et ses fichiers annexesCe téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.
1. Télécharger le fichier
Télécharger SKILL.mdDepuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/interactive-math-lesson-creator-mryiqg3h/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.
Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.
mkdir -p '.skill-downloads/interactive-math-lesson-creator-mryiqg3h' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/interactive-math-lesson-creator-mryiqg3h/download' --output '.skill-downloads/interactive-math-lesson-creator-mryiqg3h/SKILL.md.part' && mv '.skill-downloads/interactive-math-lesson-creator-mryiqg3h/SKILL.md.part' '.skill-downloads/interactive-math-lesson-creator-mryiqg3h/SKILL.md'2. Vérifier les prérequis
Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.
Outils déclarés par l’auteur (à vérifier dans votre agent) : Bash(mkdir *) Bash(uv run *) Read Write Edit Glob AskUserQuestion
Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.
Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.
3. Charger la skill
Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.
Claude Code
test -f '.skill-downloads/interactive-math-lesson-creator-mryiqg3h/SKILL.md' && test -s '.skill-downloads/interactive-math-lesson-creator-mryiqg3h/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/jiangti' && cp -R '.skill-downloads/interactive-math-lesson-creator-mryiqg3h' '.claude/skills/jiangti'OpenSkills
OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.
Installation officielle d’OpenSkillsopenskills install './.skill-downloads/interactive-math-lesson-creator-mryiqg3h'openskills read 'interactive-math-lesson-creator-mryiqg3h'La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.
Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.
openskills syncMode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.
4. Faire un premier essai
Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :
Lis .skill-downloads/interactive-math-lesson-creator-mryiqg3h/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.
Fragments d'écriture
Contenu
Extrayez des fragments d'écriture bruts via un entretien intensif, sans imposer de structure. Capturez idées, citations et mots porteurs pour une utilisation ultérieure.
Rédaction UI et audit
Contenu
Rédigez ou auditez les textes d'interface (boutons, erreurs, états vides, infobulles) dans le monorepo, en suivant la source de vérité du design system.
Extraction MIDI/score
Contenu
Extrait le MIDI ou la partition d'une production musicale existante via l'outil MCP CogMusic et confirme la disponibilité du fichier.