Synthèse automatique
Ce skill définit le workflow Git pour le projet QCC Plus avec une stratégie de branches, des conventions de commit et un processus de publication.
Points forts
- Séparation claire des environnements (test, main, prod)
- Format de commit standardisé facilitant la génération de changelogs
- Règles de sécurité Git strictes empêchant les erreurs courantes
- Intégration de tests et de revue de code pour la qualité
Limites
- Structure de branches rigide (test/main/prod) peu flexible
- Nécessite de respecter les Conventional Commits, ce qui peut ralentir le commit
- Peut être trop lourd pour de petits projets
Utilisez ce skill lorsque vous travaillez sur un projet nécessitant un workflow Git organisé avec séparation des environnements de développement, test et production.
Évitez ce skill pour des prototypes rapides ou des projets où la gestion de version n'est pas critique.
Analyse de sécurité
SûrThe skill describes standard Git workflows and explicitly prohibits destructive operations (force push, hard reset, amend without explicit request). No external commands, data exfiltration, or obfuscated payloads. It only uses git commands for branch management, merging, and committing within the project’s defined workflow.
Aucun point d'attention détecté
Comment cette analyse est faiteExemples
I want to start a new feature. Please switch to the test branch and prepare the Git workflow according to the project conventions.Merge the current test branch into main and create a new tag for release v1.2.0 following the qcc-git workflow.I fixed a bug in the health check endpoint. Please commit with the correct Conventional Commit format and ensure we are on the test branch.name: qcc-git description: Use for Git workflow, branch strategy, and commit conventions in qcc_plus project
QCC Plus Git 工作流
分支策略（强制）
强制规则: 所有开发工作必须在 test 分支进行，编写代码前必须确认当前分支。
| 分支 | 用途 | 说明 |
|------|------|------|
| test | 日常开发 | ✅ 在这里开发，推送后自动部署到测试环境（端口 8001） |
| main | 正式发布 | 合并测试通过的代码，用于打 tag 发布版本 |
| prod | 生产部署 | 部署到生产服务器（端口 8000） |
编写代码前检查
# 确认在 test 分支
git branch --show-current
# 如不在 test 分支
git checkout test
工作流程
# 1. 开发
git checkout test
# 编写代码
git push origin test
# 2. 发布
git checkout main
git merge test
git tag vX.Y.Z
git push origin vX.Y.Z
# 3. 部署
git checkout prod
git merge main
git push origin prod
Commit 格式
使用 Conventional Commits 格式：type: description
| 类型 | 说明 | 版本影响 |
|------|------|----------|
| feat | 新功能 | minor 升级 |
| fix | Bug 修复 | patch 升级 |
| feat! / fix! | 重大变更 | major 升级 |
| docs | 文档更新 | 不触发 |
| refactor | 代码重构 | 不触发 |
| test | 测试相关 | 不触发 |
| chore | 构建/工具 | 不包含在 CHANGELOG |
示例
feat: 添加健康检查 API 端点
fix: 修复节点切换延迟问题
docs: 更新 CLAUDE.md 文档结构
feat!: 重构 API 接口，移除 v1 兼容性
提交规范
Git 安全协议
- 永不更新 git config
- 永不运行破坏性命令（如 push --force, hard reset）除非用户明确请求
- 永不跳过 hooks（--no-verify, --no-gpg-sign）除非用户明确请求
- 永不强制推送到 main/master
- 避免
git commit --amend，仅在用户明确请求或添加 pre-commit hook 的编辑时使用 - 修改前总是检查作者：
git log -1 --format='%an %ae' - 永不提交更改除非用户明确要求
提交消息格式
使用 HEREDOC 确保格式正确：
git commit -m "$(cat <<'EOF'
Commit message here.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
EOF
)"
质量保证
测试要求
- 核心业务逻辑必须有单元测试
- 使用真实数据测试，避免过度 mock
- 测试边界条件和错误场景
- 使用
go test -race检测竞态条件
代码审查
- 所有合并到 main 的代码必须经过审查
- 检查错误处理是否完善
- 检查是否有资源泄漏（goroutine、文件句柄）
- 检查并发安全性
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/qcc-plus-git-workflow-mm5t89en/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/qcc-plus-git-workflow-mm5t89en' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/qcc-plus-git-workflow-mm5t89en/download' --output '.skill-downloads/qcc-plus-git-workflow-mm5t89en/SKILL.md.part' && mv '.skill-downloads/qcc-plus-git-workflow-mm5t89en/SKILL.md.part' '.skill-downloads/qcc-plus-git-workflow-mm5t89en/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.
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/qcc-plus-git-workflow-mm5t89en/SKILL.md' && test -s '.skill-downloads/qcc-plus-git-workflow-mm5t89en/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/qcc-git' && cp -R '.skill-downloads/qcc-plus-git-workflow-mm5t89en' '.claude/skills/qcc-git'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/qcc-plus-git-workflow-mm5t89en'openskills read 'qcc-plus-git-workflow-mm5t89en'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/qcc-plus-git-workflow-mm5t89en/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.
Bonnes pratiques React Hook Form
Developpement
Maîtrisez React Hook Form : évitez les anti-patterns, gérez les abonnements, et traitez correctement reset, dirty state et entrées contrôlées.
Migration Emotion vers Mantine
Developpement
Migrer les styled-components Emotion vers des composants Mantine avec style props et modules CSS. Pour convertir .styled.tsx ou supprimer les imports @emotion.
Détecteur de dérive de périmètre
Developpement
Analyse les diffs git par rapport à une intention pour détecter la dérive de périmètre, fichiers non liés et PR trop larges, puis suggère de garder, diviser ou justifier.