Synthèse automatique
Ce skill guide l'implémentation de nouvelles fonctionnalités ou l'optimisation de code Python en imposant la lecture préalable de docs/ARCHITECTURE.md comme source de vérité.
Points forts
- Force la lecture de docs/ARCHITECTURE.md avant toute modification, ce qui ancre les changements dans les conventions réelles du projet
- Impose une phase de localisation (ls, grep, read) et un plan explicite avant d'écrire du code
- Rappelle des points d'intégration concrets : tools.py pour les appels MCP, middleware.py pour l'interception, config.py pour la configuration
- Vise explicitement du code de qualité production plutôt qu'une démo
Limites
- Entièrement dépendant de l'existence et de la fraîcheur de docs/ARCHITECTURE.md ; sans ce fichier, le skill perd son garde-fou principal
- Très orienté Python et vers une architecture d'agent spécifique (MCP, middleware), donc peu réutilisable tel quel sur d'autres stacks
- La vérification reste auto-déclarée par le modèle : aucune exécution de tests ni de linters n'est prescrite
À utiliser lorsqu'on ajoute une fonctionnalité ou refactorise du code dans un projet Python doté d'un docs/ARCHITECTURE.md décrivant la stack et les conventions.
À éviter sur un dépôt sans documentation d'architecture à jour ou pour des expérimentations jetables où les contraintes de style et de middleware sont hors sujet.
Analyse de sécurité
SûrThe skill only instructs the agent to read project documentation and existing code, plan changes, implement code, and verify against configuration files. It does not request destructive commands, secret exfiltration, obfuscated payloads, or disabling safety mechanisms.
Aucun point d'attention détecté
Comment cette analyse est faiteExemples
请先阅读 docs/ARCHITECTURE.md,然后为项目新增一个「会话历史导出为 JSON」的功能,说明你的修改计划后再写代码。基于 docs/ARCHITECTURE.md 的规范,在 middleware.py 中增加一层请求日志拦截,保持与现有多层级拦截逻辑一致的代码风格。用 grep 定位现有的工具注册代码,参考 tools.py 中的包装策略,重构这段逻辑使其符合架构文档中的异步处理方式。name: feature description: 基于 docs/ARCHITECTURE.md 的规范,安全地实现新功能或优化现有代码。
Feature Implementation Skill
Instructions
当用户要求开发新功能、修改代码或进行优化时,请扮演一名资深 Python 工程师,严格遵守以下流程:
-
[关键] 加载上下文 (Context Loading):
- 必须优先读取
docs/ARCHITECTURE.md文件。 - 仔细理解其中的 "核心技术栈"、"系统架构" 和 "开发注意事项" 章节。
- 确认你的代码变更是否符合文档中的 "Agent 配置" 和 "中间件" 规范。
- 必须优先读取
-
定位与规划 (Locate & Plan):
- 使用
ls,grep或read命令找到相关联的现有代码文件。 - 不要直接覆盖文件!先理解现有逻辑。
- 在回复中简述你的修改计划(Plan)。
- 使用
-
代码实现 (Implementation):
- 编写代码时,严格保持与现有项目的代码风格一致(如文档中提到的命名规范、异步处理方式等)。
- 如果涉及 MCP 工具调用,确保参考
tools.py中的包装策略。 - 如果涉及中间件修改,确保参考
middleware.py的多层级拦截逻辑。
-
自我验证 (Verification):
- 检查你的修改是否破坏了
config.py中的配置结构。 - 确保没有引入文档中明确禁止的模式。
- 检查你的修改是否破坏了
提示
- 你的目标是编写生产级代码,而非简单的 Demo。
- 始终以
docs/ARCHITECTURE.md作为最高真理来源。
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/feature-implementation-mma3jsjx/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/feature-implementation-mma3jsjx' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/feature-implementation-mma3jsjx/download' --output '.skill-downloads/feature-implementation-mma3jsjx/SKILL.md.part' && mv '.skill-downloads/feature-implementation-mma3jsjx/SKILL.md.part' '.skill-downloads/feature-implementation-mma3jsjx/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/feature-implementation-mma3jsjx/SKILL.md' && test -s '.skill-downloads/feature-implementation-mma3jsjx/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/feature' && cp -R '.skill-downloads/feature-implementation-mma3jsjx' '.claude/skills/feature'Cursor
test -f '.skill-downloads/feature-implementation-mma3jsjx/SKILL.md' && test -s '.skill-downloads/feature-implementation-mma3jsjx/SKILL.md' && mkdir -p '.cursor/skills' && test ! -e '.cursor/skills/feature' && cp -R '.skill-downloads/feature-implementation-mma3jsjx' '.cursor/skills/feature'Codex
test -f '.skill-downloads/feature-implementation-mma3jsjx/SKILL.md' && test -s '.skill-downloads/feature-implementation-mma3jsjx/SKILL.md' && mkdir -p '.agents/skills' && test ! -e '.agents/skills/feature' && cp -R '.skill-downloads/feature-implementation-mma3jsjx' '.agents/skills/feature'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/feature-implementation-mma3jsjx'openskills read 'feature-implementation-mma3jsjx'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/feature-implementation-mma3jsjx/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.