菜单
Use for SPIP translation/i18n work — creating, editing, or auditing language files (lang/prefix_XX.php, lang/paquet-prefix_XX.php), naming keys, adding translations, using _T() / <:module:key:>, or debugging missing/untranslated strings.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when developing a SPIP plugin (paquet.xml present, _pipelines.php, spip_* table references in PHP) or when the user asks about plugin architecture, pipelines, hooks, or the SPIP PHP/SQL API. SPIP 4.1+. Not for template/squelettes work — use the spip-squelettes skill for that.
Use when creating, reviewing, or debugging SPIP CVT forms — canonical HTML wrappers, field/global errors, `charger`/`verifier`/`traiter`/`identifier`, or when deciding whether Saisies or Verifier are appropriate.
Use when writing, reading, or debugging SPIP logs — spip_log(), journal(), log constants, log file location, gravité levels, or log rotation. For SPIP 4.1+.
Guides automated testing of SPIP plugins and squelettes using PHPUnit — the standard test tool for SPIP. Covers the full self-contained setup (composer, spip-cli), unit tests with lightweight mocks, and integration tests against a real SPIP instance. Use whenever the user wants to test, verify, or validate a SPIP plugin or squelette — even if they don't mention PHPUnit — including questions like "how do I test my plugin", "I want to make sure my filtre works", or "how do I write tests for my autorisation / CVT form /
Use for any SPIP template question — BOUCLE loops, balises, critères, filtres, INCLURE, pagination, image filters, recursive trees, AJAX reloads. Covers public squelettes and plugin squelettes (espace privé, modèles). Trigger even when the user doesn't say "squelette". Not for PHP hooks/pipelines → use spip-plugins.
| name | spip-lang |
| description | Use for SPIP translation/i18n work — creating, editing, or auditing language files (lang/prefix_XX.php, lang/paquet-prefix_XX.php), naming keys, adding translations, using _T() / <:module:key:>, or debugging missing/untranslated strings. |
SPIP stores translatable strings in PHP files under lang/. Each plugin declares its
language module in paquet.xml; the reference language is defined by <traduire reference="…"> (typically fr).
| Goal | Read |
|---|---|
Create or edit a lang/prefix_fr.php file | references/format.md |
Add a new translation file (lang/prefix_XX.php) | references/format.md |
| Name keys consistently (prefixes, plural forms, placeholders) | references/conventions.md |
Use _T() in PHP or <:module:key:> in a squelette | references/usage.md |
Apply filters on a translated string (|label_nettoyer, |attribut_html) | references/usage.md |
Singular / plural in a squelette (singulier_ou_pluriel) | references/usage.md |
| Debug missing or untranslated output | references/usage.md + references/conventions.md |
Declare the module in paquet.xml | ../spip-plugins/references/i18n.md |
Send translated output in a different language (lang_select) | references/usage.md |
monplugin/
└── lang/
├── monplugin_fr.php ← main strings (reference)
├── monplugin_en.php ← translation (same keys)
└── paquet-monplugin_fr.php ← plugin manager metadata
paquet.xml declaration:
<traduire module="monplugin" reference="fr" />
<?php
// This is a SPIP language file -- Ceci est un fichier langue de SPIP
return [
// A
'aucun_objet' => 'Aucun objet trouvé',
// B
'bouton_ajouter' => 'Ajouter',
// E
'erreur_champ_vide' => 'Le champ @champ@ est obligatoire',
// I
'info_1_objet' => 'Un objet',
'info_nb_objets' => '@nb@ objets',
// T
'titre_objets' => 'Mes objets',
];
Key rules:
// A, // B…)snake_case@nom@// lang/paquet-monplugin_fr.php
return [
'monplugin_description' => 'Description affichée dans le gestionnaire de plugins',
'monplugin_slogan' => 'Accroche courte',
];
These two keys are mandatory. Module in _T() calls: paquet-monplugin: (not monplugin:).
For plugin architecture, pipelines, or full paquet.xml structure, route to spip-plugins.
For language files and translation usage, stay in this skill.
ecrire/lang/ and plugins-dist/*/lang/references/conventions.mdreferences/usage.mdreferences/format.md