CommunityRédaction et éditiongithub.com

Itérer Projet de Recherche

Compétences Codex pour gérer des portefeuilles de recherche et des workflows de projet itératifs.

Qu'est-ce que Itérer Projet de Recherche ?

Cette compétence est conçue pour maintenir l'honnêteté et la clarté d'un projet de recherche en constante évolution. Elle repose sur un principe central : classer le travail, l'écrire au bon endroit, enregistrer les preuves, puis synchroniser uniquement les résumés et le tableau de bord nécessaires aux collaborateurs. La compétence introduit une structure de dossier standardisée, un tableau de bord HTML (PROJECT_BOARD.html) et des règles de synchronisation pour garantir que les expériences sont documentées de manière append-only (jamais écrasées) et facilement comparables. Elle prend en charge l'utilisation autonome pour un projet unique ou l'intégration facultative dans un portefeuille de recherche plus vaste. Elle est idéale pour les chercheurs, les scientifiques des données et les ingénieurs qui travaillent sur des projets d'exploration et ont besoin de garder une trace de toutes les tentatives, des idées futures et des décisions clés sans perte de contexte.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add jiangjin1999/codex-research-project-skills

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Itérer Projet de Recherche ?

Utilisez cette compétence pour garder un projet de recherche honnête à mesure qu'il évolue. L'habitude principale est : classer le travail, écrire à l'endroit durable le plus étroit, enregistrer les preuves, puis synchroniser uniquement les résumés et le tableau de bord dont les collaborateurs ont besoin.

Deux règles s'appliquent à tout :

  1. Markdown d'abord, tableau de bord ensuite. Mettez d'abord à jour le markdown source ou la note _ai. Ensuite seulement, synchronisez PROJECT_BOARD.html.
  2. Le tableau de bord est une carte, pas un journal. PROJECT_BOARD.html montre l'état actuel et pointe vers les preuves. Il ne stocke jamais de journaux bruts, de données privées ou de chemins absolus.

Et une habitude qui guide l'itération : nouvelle idée → nouveau sous-projet. Les tentatives d'expérimentation sont le cœur du travail. Lorsqu'il y a quelque chose à essayer, créez un nouveau dossier 0-Project/<date>_<slug>/ et itérez à l'intérieur plutôt que d'écraser ou de réitérer sans cesse une seule tentative. Gardez les sous-projets petits et à usage unique ; ne craignez pas la duplication. Cela conserve un historique append-only et comparable (voir references/project-iteration-system.md).

Les sous-projets ont également des voies :

  • Ligne principale — les tentatives actuelles qui définissent la voie active.
  • Garé — idées de tentatives futures capturées tôt (car la pensée de recherche n'est pas entièrement séquentielle), mais pas encore exécutées. Note par défaut : 0-Project/_parking-lot.md.
  • Archivé — tentatives abandonnées ou remplacées, conservées avec une raison d'arrêt et des preuves. Dossier par défaut : 0-Project/_archive/.

Garez à moindre coût. Une idée future peut être une courte entrée dans _ai/task_plan.md, 1-Docs/, ou 0-Project/_parking-lot.md ; créez un dossier de tentative complet uniquement lorsque l'idée a suffisamment d'entrées, de critères ou de valeur de transfert.

Acheminez les discussions et les tentatives séparément : les discussions, décisions, comparaisons et explications de méthodes vont dans 1-Docs/<date>_<topic>.md ; les essais concrets avec entrées, critères, sorties ou résultats vont dans 0-Project/<date>_<slug>/ ; les discussions propres à une tentative vont dans 0-Project/<attempt>/docs/<date>_<topic>.md.

Autonome ou dans un portefeuille. Cette compétence est autonome : utilisez-la seule pour un projet unique à n'importe quel chemin — aucun portefeuille requis. Tout ce dont le projet a besoin (dossiers, fichiers d'entrée, tableau de bord, mémoire de travail, politique git) vit à l'intérieur du dossier du projet. En option, lorsque le projet se trouve dans un portefeuille (<slug>-project/<project>/), synchronisez l'état, le propriétaire, la priorité et l'état public vers le tableau de bord du portefeuille avec la compétence manage-research-portfolio. Lorsque vous fonctionnez en mode autonome, sautez toutes les étapes de « tableau de bord du portefeuille » et de « registre » dans cette compétence — ce sont des intégrations facultatives, jamais des prérequis.

Contrat du Projet

Utilisez cette structure, sauf si le projet a déjà des noms équivalents. C'est le squelette _PROJECT_TEMPLATE copiable.

<projet>/
├── README.md              entrée : objectif en une phrase, plan des dossiers, démarrage rapide, statut actuel
├── PROJECT_GUIDELINES.md  règles de synchronisation locales, limites des dossiers, classification HTML
├── PROJECT_BOARD.html     le tableau de bord (看板) : carte de l'état actuel et navigation
├── GIT_WORKFLOW.md        identité git + politique de commit par changement pour ce projet
├── scripts/
│   └── init_project_git.sh   aide facultatif pour définir l'identité et le premier commit
├── 0-Project/             tentatives / expériences concrètes (un `0-Project/<date>_<slug>/` par tentative)
├── 1-Docs/
│   └── README.md          l'entrée Docs unique fixe + index des sujets
├── 2-Data/
│   └── DATA.md            source, provenance, autorisations, versions, schéma, QC, limites
├── 3-Paper_Survey/
│   └── README.md          file de lecture, notes sur les articles, matrice de preuves, sources de méthodes
├── 4-Skills/
│   └── PROJECT_SKILLS.md  invites locales, règles IA, procédures réutilisables
└── _ai/
    ├── project_overview.md   objectif, portée, statut, propriétaire, priorité, suite
    ├── project_board_spec.md comment `PROJECT_BOARD.html` est généré/synchronisé à partir des sources
    ├── task_plan.md          phase actuelle, plan, bloqueurs, suite
    ├── findings.md           résultats stables, questions ouvertes
    └── progress.md           synchronisation la plus récente et significative, actions, validation, commit

Les fichiers racine sont : entrée + règles + tableau de bord + politique git. Tout ce qui est concret va dans le dossier numéroté le plus correspondant ; n'empilez jamais de matériel à la racine du projet, et ne mettez jamais l'aperçu du projet, les règles du tableau de bord ou les lignes directrices à long terme dans 0-Project/ (ce dossier est réservé aux tentatives concrètes).

Classifier Avant d'Écrire

Lorsque l'utilisateur donne un nouveau matériel, choisissez un emplacement d'atterrissage, puis décidez si le tableau de bord change.

Intention de l'utilisateurEmplacement d'atterrissageVue du tableau de bord qu'il peut toucher
« C'est une discussion / méthode / décision / comparaison »1-Docs/<date>_<topic>.md + mettre à jour 1-Docs/README.mdCarte des Docs (文档地图)
« C'est une expérience / tentative concrète »0-Project/<date>_<slug>/ ; mettre les notes locales sous docs/Tâches (任务尝试)
« C'est une note sur une tentative existante »0-Project/<attempt>/docs/<date>_<topic>.mdgénéralement Tâches, parfois Carte des Docs si cela modifie l'index du projet
« C'est une idée de tentative future »_ai/task_plan.md, 1-Docs/, ou 0-Project/_parking-lot.md ; dossier complet uniquement si concretgénéralement aucune, ou une voie Tâches garée
« Cette tentative est abandonnée / remplacée »gardez le dossier de tentative ou déplacez-le sous 0-Project/_archive/ ; marquez comme archivé avec la raison d'arrêt, les preuves et le remplacementvoie Tâches archivée/pliée
« Ce sont des informations de données / benchmark »2-Data/DATA.mdMatériaux (数据材料)
« C'est un article / une source externe / une preuve »3-Paper_Survey/README.md + matrice de preuvesRéférences (参考文献)
« C'est un workflow / une invite / une règle IA réutilisable »4-Skills/PROJECT_SKILLS.md(généralement aucune)
« Cela change le statut / la prochaine action / le bloqueur »_ai/project_overview.md, _ai/task_plan.mdAperçu supérieur + Progrès (项目进度)

Si la classification modifie la portée du projet, les critères d'évaluation, les limites des données, l'exposition publique ou l'appartenance d'une tentative au projet, demandez avant de la traiter comme confirmée. Pour les nominations/mises en forme à faible risque, choisissez l'option conservatrice et enregistrez l'hypothèse dans _ai/progress.md.

Le Tableau de Bord (看板)

PROJECT_BOARD.html est le tableau de bord du projet unique. Il répond en un coup d'œil : quel est ce projet, quel est l'état actuel, qu'est-ce qui a changé, où sont les preuves et par où continuer. Il est coordonné avec les dossiers — chaque vue est alimentée par un dossier ou fichier _ai spécifique.

Éléments de base :

  • Lien d'accueil / retour (persistant) : un lien tout en haut de la page, dans la zone de marque en haut à gauche. Dans un portefeuille, faites-en un lien « Retour au tableau de bord » pointant vers la racine du site / ; en mode autonome, soit omettez-le, soit faites-le pointer vers le README.md du projet. Préservez ce que vous choisissez lors de la création, de la copie, de la publication ou de la mise à jour de la page.

  • Statut de version : version de la page YYYY-MM-DD-vN et marqueur de dernière synchronisation (optionnellement un contrôle d'actualisation/rafraîchissement).

  • Aperçu supérieur (toujours visible, léger) : nom du projet, description en une phrase, statut, propriétaire, synchronisation récente, focus actuel et au plus une ligne de progrès courte. Source : _ai/project_overview.md. Ne mettez pas de listes de phases, de cartes de version, de listes de tentatives ou de routes à long terme ici.

  • Cinq vues mutuellement exclusives, chacune mappée à un dossier :

    VueAlimentée parMontre
    Progrès (项目进度)_ai/progress.md, _ai/findings.md, 1-Docs/README.mdchangements majeurs au niveau du projet uniquement : objectif, portée, phase, résultat clé, jugement, état public, résumé compact des versions
    Carte des Docs (文档地图)1-Docs/README.md + structure racineindex des sujets des docs + arbre de structure de type VS Code Explorer (fichiers/dossiers de niveau 1 racine et niveau 2 via <details>/<summary>), noms sûrs pour le public uniquement
    Tâches (任务尝试)0-Project/<attempt>/tentatives de la ligne principale en premier ; tentatives futures garées et tentatives archivées/dépréciées uniquement dans des voies pliées séparées
    Matériaux (数据材料)2-Data/DATA.mdblocs de données, publicité, version, qualité, limites d'utilisation
    Références (参考文献)3-Paper_Survey/README.mdarticles, sources de méthodes, état des preuves, impact ; uniquement s'il y a du contenu

Règles du tableau de bord : n'inventez pas de propriétaires, de statut, de priorité ou de phases futures ; n'ajoutez pas de vue « prochaine étape » autonome (la prochaine action se trouve dans l'aperçu supérieur, _ai/task_plan.md ou une tentative) ; utilisez <details> plié pour les tentatives et l'arbre de structure ; gardez-le comme un établi de recherche calme, pas une page d'accueil. Les idées futures et les tentatives abandonnées ne doivent pas concurrencer visuellement la voie active. Les règles de génération se trouvent dans _ai/project_board_spec.md. Voir references/project-board.md pour le contrat complet.

Boucle d'Itération

  1. Restaurez le contexte à partir de _ai/project_overview.md, _ai/project_board_spec.md, _ai/task_plan.md, _ai/findings.md, _ai/progress.md et du README du dossier pertinent.
  2. Confirmez l'identité Git de l'opérateur avant de modifier les fichiers du projet ; si elle est manquante, demandez à l'utilisateur de configurer la sienne et faites une pause.
  3. Nommez l'itération actuelle en une phrase : question, tentative ou décision.
  4. Créez ou mettez à jour le fichier source le plus étroit en premier.
  5. Enregistrez les résultats qui changent la direction dans _ai/findings.md ; enregistrez les actions, les validations et les chemins échoués dans _ai/progress.md.
  6. Mettez à jour _ai/task_plan.md lorsque la phase, le bloqueur ou la prochaine action change.
  7. Avant la compression du contexte, après avoir terminé une petite étape, ou avant de changer de sujet/sous-projet, écrivez un transfert compact dans le fichier Markdown correspondant le plus étroit.
  8. Appliquez l'Échelle de Synchronisation pour décider s'il faut toucher à PROJECT_BOARD.html, puis validez les fichiers modifiés sûrs avec des chemins explicites.

Compression du Contexte et Hygiène des Transferts

Écrivez le contexte de manière proactive avant que la conversation ne devienne coûteuse à transporter. Faites-le lorsque la fenêtre de contexte devient grande, qu'une petite étape se termine, qu'un sous-projet atteint un point de décision, ou que la prochaine action va passer à un autre sujet, projet ou tentative.

Choisissez l'emplacement le plus étroit :

SituationEmplacement du transfert
Discussion, décision ou note de méthode au niveau du projet1-Docs/<date>_<topic>.md
Étape, observation ou discussion locale au niveau de la tentative0-Project/<attempt>/docs/<date>_<topic>.md
Statut du projet, bloqueur, prochaine action ou résumé de validation_ai/progress.md, _ai/findings.md, _ai/task_plan.md
Contexte inter-projets ou de portefeuillele <slug>-ai/<date>_<topic>.md du portefeuille s'il existe

Champs minimum du transfert : objectif actuel, étape terminée, décisions clés, chemins de preuves, questions non résolues, prochaine action et si une synchronisation du tableau de bord est nécessaire. Gardez cela compact ; ne collez pas de transcriptions complètes ou de journaux bruts.

Échelle de Synchronisation

Évaluez chaque changement par rapport à cette échelle avant de modifier le tableau de bord.

NiveauDéclencheurMise à jour
0Exploration en lecture seule, aucune nouvelle décisionRien
1Résultat mineur, petite branche échouée, note temporaireMarkdown ou _ai uniquement
2Nouvel artéfact/chemin/résultat QC, bloqueur, prochaine action, statut, carte des docs, arbre de structure, limite de données, référence, ou tentative modifiéeMarkdown source ou _ai, puis synchronisez PROJECT_BOARD.html
3Phase, jalon, revendication publique, propriétaire, priorité ou état public modifiésMarkdown source, tableau de bord, PROJECT_GUIDELINES.md, et — uniquement si le projet appartient à un portefeuille — le tableau de bord du portefeuille

Les notes de transfert de contexte sont généralement de niveau 1. Élevez-les au niveau 2 uniquement lorsqu'elles modifient la prochaine action, le statut, le bloqueur, la carte des docs, la limite des données, l'état des références ou l'état d'une tentative.

Ne synchronisez pas le tableau de bord à chaque modification. Synchronisez lorsqu'un collaborateur aurait besoin du nouvel état.

Enregistrements des Sous-Projets

Chaque 0-Project/<date>_<slug>/README.md doit répondre : quelle question la tentative teste ; quelles entrées, articles, notes de données ou hypothèses elle utilise ; ce qui a été exécuté ou raisonné (objectif, hypothèse, entrées, commande, métriques) ; ce qui a échoué, changé ou s'est stabilisé ; la conclusion et la prochaine action ; et si cela affecte le statut du projet, les notes de données, les notes de littérature ou le tableau de bord. Mettez les discussions propres à la tentative, les transferts d'étape et les notes de conception dans le dossier docs/ de cette tentative.

Enregistrez les tentatives échouées. Un chemin échoué avec une raison claire est un atout utile pour le projet. Si elle est abandonnée ou remplacée, marquez-la comme archivée avec la raison d'arrêt, le remplacement éventuel, la dernière preuve et ce qu'il ne faut pas répéter ; montrez-la dans le tableau de bord uniquement comme un élément plié secondaire une fois qu'elle atteint une phase stable ou un point de décision.

Données et Littérature

  • Utilisez 2-Data/DATA.md pour la provenance, les versions, la classe d'accès, les emplacements autorisés, le schéma, le QC et les limites des artefacts dérivés. Gardez les données dérivées du projet (caractéristiques, trajectoires, tables prêtes à l'analyse, intermédiaires QC) sous le dossier 2-Data/ de ce projet, pas dans la zone de données globale. N'écrivez jamais d'enregistrements sensibles bruts, d'exemples portant une identité, d'identifiants ou d'extraits non publiés dans les notes, le tableau de bord ou les copies publiques.
  • Utilisez 3-Paper_Survey/README.md pour les preuves qui peuvent modifier les méthodes, l'évaluation, la portée ou l'interprétation. Résumez les articles par problème, méthode, données ou benchmark, résultat, limitation et implication pour ce projet. Utilisez une matrice de preuves lorsque plusieurs sources portent sur une même affirmation. Privilégiez une paraphrase concise et des liens plutôt que de longues citations.

Références

  • Lisez references/project-iteration-system.md lors de la création de la structure du projet, des fichiers d'entrée, des sous-projets, des fichiers de mémoire de travail ou des règles de synchronisation.
  • Lisez references/project-board.md lors de la création, de la révision ou de la synchronisation de PROJECT_BOARD.html.
  • Lisez references/data-and-literature.md avant de traiter les notes de données, la provenance des benchmarks, les résumés de littérature ou les mises à jour de preuves à décision.

Skills associés