TongyiDai/feishu-okr-drafter

Brouillon d'OKR Feishu

Objectifs et limites

Compilez des faits de travail provenant de multiples sources en OKR Feishu discutables, mesurables et alignables, et après autorisation explicite de l'utilisateur, écrivez-les dans un brouillon en mentionnant les collaborateurs concernés. L'interface sert à accélérer le processus ; les pages Feishu, documents historiques, captures d'écran, contenu collé par l'utilisateur et bilans de travail sont également des entrées valides. Par défaut, effectuez d'abord l'analyse et le brouillon, sans créer, publier ou modifier des OKR existants.

Respectez trois règles fondamentales :

• N'inventez pas de valeurs cibles, de bases de référence, de dates limites, de responsables, de résultats métier ou d'objets d'alignement ; les informations manquantes sont rédigées sous la forme [À confirmer].
• Séparez les rapports de brouillon, d'écriture, de sauvegarde et de publication ; ne déclarez pas une tâche comme terminée sans preuve de relecture.
• Lorsque des données sensibles (revenus, coûts, clients, personnel ou données stratégiques) sont impliquées, privilégiez les proportions, intervalles, taux d'achèvement ou expressions anonymisées confirmés, et marquez les parties nécessitant une communication séparée.

Flux de travail

1. Déterminer le mode de tâche

Identifiez ce que l'utilisateur souhaite faire :

1. Générer un nouveau brouillon à partir de notes de travail ;
2. Réécrire des O/KR existants ;
3. Examiner la qualité et les relations d'alignement ;
4. Écrire le brouillon dans Feishu ;
5. Ajuster les objectifs, KR, pondérations ou dates limites au cours d'un cycle.

En l'absence d'intention claire d'écriture, restez en mode lecture seule et brouillon.

2. Établir le contexte et les sources de données

Lisez d'abord les descriptions de version actuelles de lark-shared et lark-okr. Lorsque vous devez lire du contenu Feishu, exécutez la vérification d'identité, de locataire et d'autorisations :

lark-cli auth status --json --verify
lark-cli contact +get-user --as user

Dans un environnement prenant en charge auth status --json --verify, confirmez que identity=user et verified=true. Si la version actuelle de l'interface CLI ne dispose pas de la sous-commande auth, vous pouvez utiliser contact +get-user --as user pour analyser l'utilisateur actuel ; si vous devez continuer en mode brouillon, utilisez ensuite task +get-my-tasks --as user pour prouver que le user-context est lisible. Avant d'écrire réellement des OKR ou de mentionner des collaborateurs, confirmez toujours l'utilisateur et le locataire cibles.

Choisissez les sources de données disponibles dans l'ordre suivant. Ne considérez pas « l'interface n'est pas disponible » comme un point d'arrêt de la tâche :

1. Chemin Interface/CLI : lorsque les autorisations le permettent, utilisez l'interface pour lire en masse les cycles, O/KR, indicateurs, progrès et relations d'alignement.
2. Chemin Page Feishu : en cas d'absence d'interface, de portée insuffisante ou de nécessité de confirmer l'état de sauvegarde d'une page, utilisez control-in-app-browser. Donnez la priorité à la prise en main de la page OKR que l'utilisateur a actuellement ouverte ; s'il n'y a pas de page disponible, effectuez une seule navigation explicite vers l'entrée des OKR Feishu. Lisez en fonction de la page visible, sans deviner l'URL, l'ordre des champs ou la signification des boutons.
3. Chemin Matériel Utilisateur : lisez les textes, captures d'écran, documents, comptes rendus de réunion, bilans de performance, auto-évaluations H1 et rétrospectives de travail fournis par l'utilisateur.
4. Chemin Document Feishu : recherchez et lisez les documents sur l'élaboration, la rédaction, l'alignement, l'assistant de remplissage et les exemples de poste des OKR accessibles au locataire actuel.

Même lorsque l'interface réussit, combinez-la avec la page ou le texte original pour vérifier les états clés ; lorsque la page réussit, conservez les faits de la page et ne jetez pas les preuves simplement parce qu'aucun ID API ne peut être formé.

Obtenez selon les besoins :

• Le cycle cible de l'utilisateur actuel : okr +cycle-list ;
• Les O/KR du cycle : okr +cycle-detail ;
• Les indicateurs des O, les indicateurs des KR : objective.indicators list, key_result.indicators list ;
• Les relations d'alignement des O : objective.alignments list ;
• Les enregistrements de progression associés : okr +progress-list ;
• Les documents Feishu associés : recherchez OKR, élaboration, rédaction, alignement, assistant de remplissage, en donnant la priorité aux normes et exemples accessibles au locataire actuel.

Le jugement du cycle se base principalement sur le chevauchement entre les dates de début et de fin et la date actuelle, puis sur l'état du cycle ; en l'absence de demande explicite de l'utilisateur, ne considérez pas le cycle annuel comme le cycle actuel par défaut.

Si la portée dédiée aux OKR est manquante, arrêtez les tentatives aveugles et expliquez la portée manquante et son impact. Vous pouvez continuer à générer un brouillon marquant les limites du contexte, basé sur les documents de travail fournis par l'utilisateur et les documents Feishu que vous êtes autorisé à lire.

2.1 Utilisation des documents historiques

Les OKR historiques sont une référence clé. Vérifiez au moins le cycle terminé le plus récent, et si possible, examinez les cycles antérieurs, les enregistrements de progression, les évaluations, les commentaires, les bilans de performance et les auto-évaluations H1.

Classez le contenu historique en quatre catégories :

• Faits accomplis : utilisés comme bases de référence, preuves de capacité ou preuves de cas, ne les recopiez pas tels quels en nouveaux KR ;
• Tâches non terminées ou récurrentes à haute priorité : comme axes potentiels du cycle actuel, en redéfinissant les résultats de phase ;
• Retours répétés des supérieurs ou collègues : transformez-les en résultats de qualité, de collaboration ou de mécanisme ;
• Capacités déjà développées mais non encore reproduites : transformez-les en résultats de mise à l'échelle, de standardisation, d'opérabilité indépendante par d'autres ou en résultats commerciaux.

Établissez un registre des sources concis : Fait → Source → Date → Rôle pour le nouvel O/KR → Si encore à confirmer. Séparez les réalisations passées des engagements futurs.

2.2 Lecture de quatre types de contexte relationnel des OKR

Avant d'écrire les OKR du cycle actuel, vérifiez systématiquement les quatre types de relations suivants ; en l'absence d'interface, complétez via les pages OKR Feishu, captures d'écran, contenu collé par l'utilisateur ou documents accessibles :

1. Achèvement personnel du cycle précédent : comparez point par point les valeurs cibles, progrès, évaluations, commentaires et résultats réels des O/KR. Distinguez les termes « terminé », « partiellement terminé », « non terminé », « objectif modifié » et « preuve manquante » ; ne réintégrez que les éléments non bouclés ayant encore un sens pour le cycle actuel ou les nouveaux résultats de phase.
2. Mentions reçues par l'utilisateur dans le cycle actuel : collectez dans quels O/KR l'utilisateur a été mentionné, par qui, les attentes de collaboration correspondantes, les délais de livraison et les limites de responsabilité. Classez-les en « candidat responsable », « collaborateur », « élément à confirmer » ou « mention informative » ; ne considérez pas automatiquement une mention comme un engagement.
3. Mentions faites par l'utilisateur au cycle précédent : revoyez les objets que l'utilisateur a mentionnés, les O/KR correspondants, le contenu de la collaboration et si la boucle a été fermée. Identifiez les dépendances persistantes, les recherches répétées de personnes, les inadéquations de collaboration et les relations pouvant être consolidées en mécanismes ; ne conservez que les relations de collaboration toujours valides pour le cycle actuel.
4. OKR du supérieur hiérarchique direct : confirmez l'identité du supérieur direct, le cycle actuel, l'ordre des O/KR, les résultats clés, les métriques et les limites de collaboration. Déterminez si l'O personnel est un prolongement, un soutien, une collaboration horizontale ou un axe indépendant ; si l'OKR du supérieur est manquant, que le cycle est indéfini ou que l'identité ne peut être vérifiée, marquez les limites sans déduire par vous-même.

Établissez un registre des relations : Type de relation → Objet source → O/KR → Partie/ Collaborateur → Fait ou attente → Traitement du cycle actuel → Si déjà confirmé. Utilisez les quatre types d'informations respectivement comme « résultat historique », « entrée de collaboration », « rétrospective de collaboration » et « prolongement vertical », en évitant de les mélanger en une simple liste de tâches.

3. Collecte des entrées minimales nécessaires

Confirmez au moins : le cycle, le rôle ou le périmètre de responsabilité, les résultats métier à atteindre, les bases de référence connues, les valeurs cibles ou critères de jugement, les principaux collaborateurs, les contraintes et les informations sensibles.

Lorsque des OKR de l'équipe ou du supérieur sont déjà disponibles, identifiez d'abord :

• Quels O nécessitent un prolongement ;
• Quels KR sont des collaborations entre pairs ;
• Quels travaux relèvent de la responsabilité principale de l'utilisateur et lesquels sont une assistance ;
• Si les travaux proposés par l'utilisateur sont en double ou en conflit avec des O existants.

S'il existe un supérieur direct, son OKR du cycle actuel est la première référence pour le prolongement vertical ; les OKR d'équipe, des pairs et les mentions reçues servent à compléter le périmètre de prolongement et les limites de collaboration. Les mentions reçues, les mentions faites et « semble pertinent » ne peuvent former que des relations candidates ; ce n'est que lorsque le contenu, la responsabilité principale, le cycle et la confirmation mutuelle sont tous établis que l'on peut déclarer l'alignement comme établi.

En cas d'absence d'entrées clés, complétez avec un minimum de questions ; si la confirmation reste impossible, continuez à produire, mais explicitez l'incertitude entre [À confirmer].

4. Génération du brouillon

Rédaction des O

• Concentrez-vous sur les travaux à haute priorité et à haute valeur, en excluant l'empilement des tâches quotidiennes ; suggérez 3–5 O, moins si le périmètre de travail est étroit.
• Décrivez clairement la direction, la valeur attendue et la période ; maintenez une granularité modérée, en évitant les slogans ou les listes de tâches.
• Gardez un certain niveau de défi, en évitant de considérer « continuer à faire » comme un objectif.
• Pour les sujets de long terme, décomposez-les en résultats de phase pour le cycle actuel.
• Utilisez un vocabulaire métier compréhensible dès la première lecture ; reprenez les termes propres déjà validés par l'organisation.

Lorsque l'utilisateur liste plusieurs projets ou campagnes en une seule fois, regroupez-les d'abord par résultat métier, puis décidez du nombre d'O. Les noms de projets entrent généralement dans les KR, les chemins de réalisation ou les colonnes de preuves ; ils ne deviennent des O distincts que s'ils représentent un axe de résultat indépendant. Les directions de regroupement courantes incluent les résultats clients/commerciaux, l'efficacité des processus de bout en bout, la produitisation et la reproduction, ainsi que les mécanismes organisationnels et l'influence.

Rédaction des KR

• Chaque O suggère 3–5 KR, couvrant chacun différents axes de soutien clés.
• Rédigez d'abord le résultat et l'état, puis complétez avec les chemins de réalisation nécessaires ; évitez de n'écrire que « terminer, être responsable, piloter, suivre ».
• Donnez des critères de jugement qualitatifs ou quantitatifs objectivement observables ; pour « améliorer, optimiser, renforcer », complétez avec le point de départ, le point d'arrivée ou les conditions d'acceptation.
• Mentionnez les jalons temporels du cycle ; si la valeur cible est inconnue, conservez [Valeur cible à confirmer].
• En cas de collaboration nécessaire, indiquez le responsable principal, les collaborateurs et les limites de responsabilité ; le nombre de co-responsables ne dépasse généralement pas 4.
• Si une explication de la direction du KR est nécessaire, utilisez un sous-titre court, par exemple [Valeur client], [Efficacité des processus], en évitant de fusionner plusieurs axes en un seul.

Organisez de préférence un KR selon la structure suivante :

[Aspect clé] Grâce à [chemin nécessaire], d'ici [jalon temporel] atteindre [résultat observable/valeur cible], sous la responsabilité de [responsable principal], avec la collaboration de @ [collaborateur].

Si le chemin est trop long, réduisez-le ; le résultat, le délai et les critères d'acceptation doivent être conservés.

5. Exécution du contrôle qualité

Vérifiez chaque O et KR point par point, et classez les problèmes en « bloquant la publication » et « optimisation suggérée ». Les règles détaillées se trouvent dans references/okr-writing-principles.md.

Points de contrôle essentiels :

• Les O sont-ils à haute priorité, clairs, modérément stimulants, et correspondent-ils au cycle actuel ;
• Les KR soutiennent-ils directement les O, décrivent-ils des résultats, sont-ils mesurables, réalisables, avec une limite temporelle ;
• Les KR sont-ils redondants, manquent-ils d'axes de soutien clés ou sont-ils en conflit entre eux ;
• Les valeurs cibles, bases de référence, dates et responsables ont-ils une source ;
• Existe-t-il un prolongement vertical, une collaboration horizontale, une responsabilité principale claire et un objet d'alignement réel ;
• Le taux d'achèvement du cycle précédent, les mentions reçues du cycle actuel, les mentions faites au cycle précédent et les OKR du supérieur direct ont-ils été vérifiés ;
• L'ordre des objectifs, les termes propres, la protection de la vie privée et la cohérence des informations sensibles sont-ils maintenus ;
• Les scores, progrès, pondérations et valeurs cibles ne sont-ils pas confondus.

6. Livraison du brouillon

Livrez selon l'ordre suivant :

1. Cycle et contexte : quels cycles, O supérieurs, documents et entrées utilisateur ont été utilisés ; expliquez les limites de lecture.
2. Brouillon d'OKR : sous chaque O, listez les KR, les critères de résultats, les délais, le responsable, les collaborateurs et les sources des preuves.
3. Prolongement historique : quels faits historiques sont devenus des bases de référence, quels sujets se poursuivent, quels résultats sont promus en résultats de reproduction ou de mise à l'échelle.
4. Registre des relations et des prolongements : taux d'achèvement du cycle précédent, mentions reçues du cycle actuel, mentions faites au cycle précédent, prolongement du supérieur direct, objets de mention suggérés, conflits et sujets à communiquer.
5. Diagnostic qualité : éléments bloquants, optimisations suggérées, hypothèses non encore validées.
6. À confirmer : listez uniquement les éléments qui modifieraient le sens des objectifs, les critères de résultats ou l'écriture système.

Interdiction d'utiliser un ensemble de chiffres apparemment complet pour masquer l'incertitude. Les jugements de qualité doivent expliquer « pourquoi ce KR prouve que l'O est atteint ».

7. Écriture dans Feishu

N'effectuez des opérations d'écriture que lorsque l'utilisateur demande explicitement une écriture ou une sauvegarde. Avant d'écrire :

1. Reconformez l'utilisateur actuel, le locataire, le cycle, l'appartenance de l'objectif et le brouillon complet ;
2. Établissez une « Liste d'écriture et de mentions » : pour chaque O/KR, mentionnez le collaborateur, la raison de la mention, les limites de responsabilité principale, la source et l'état de vérification ;
3. Utilisez lark-cli contact +search-user pour résoudre chaque nom ou email en open_id. En cas de multiples candidats, de locataire croisé ou d'informations d'identité insuffisantes, suspendez cette mention et demandez confirmation, sans deviner ;
4. Utilisez d'abord --dry-run pour vérifier la requête ;
5. Pour le texte normal et les mentions, privilégiez le style simple ; lorsque le contrôle précis de l'emplacement de la mention est nécessaire, utilisez l'élément mention du format richtext ;
6. Pour la création de plusieurs O/KR, privilégiez okr +batch-create ; pour un seul O ou KR, utilisez okr +create ; placez la mention sur l'O/KR correspondant, en évitant de concentrer toutes les mentions dans un seul objectif ;
7. Ne définissez pas automatiquement des scores en raison du « brouillon » ; ne traitez les scores que si l'utilisateur demande explicitement une évaluation ;
8. Après l'écriture, relisez les détails du cycle, vérifiez le nombre, le contenu, l'ordre, les pondérations, les dates limites, les mentions et l'état de sauvegarde/publication des O/KR ;
9. En cas de relecture incomplète, de mentions non appliquées ou de sémantique système susceptible d'entraîner une publication directe, arrêtez-vous, expliquez à l'utilisateur et ne poursuivez pas.

Jugement pour l'écriture et les mentions

• Lorsque l'utilisateur dit simplement « rédiger, générer, optimiser », produisez uniquement un brouillon local et une liste de suggestions de mentions.
• Lorsque l'utilisateur dit explicitement « écrire, sauvegarder dans Feishu, remplir pour moi », vous pouvez créer un brouillon ; ne mentionnez que si l'utilisateur demande explicitement « mentionner quelqu'un » ou si le registre des relations contient déjà un collaborateur vérifié.
• La mention est un ID d'utilisateur réel, pas une chaîne de caractères @Nom dans le texte. Dans le chemin d'interface, placez mention: ["ou_xxx"] dans l'O/KR correspondant ; dans le chemin de page, utilisez le sélecteur d'utilisateur et relisez l'étiquette d'utilisateur réelle dans la page.
• Expliquez séparément les raisons pour lesquelles le responsable principal, les collaborateurs et le supérieur direct sont mentionnés ; les relations candidates formées uniquement par « pertinent » ou « mentionné » sont d'abord placées dans la liste des éléments à confirmer.
• Rapports de résultats d'écriture séparés : Créé/Sauvegardé, Mentionné, Non mentionné et raisons, Non publié. Pour tout élément sans preuve de relecture, conservez-le comme À vérifier.

Lorsque l'interface ne permet pas l'écriture, vous pouvez utiliser le « Collage en masse d'OKR » ou les contrôles d'édition de la page dans la page OKR Feishu déjà connectée pour sauvegarder le brouillon. Le chemin de la page doit respecter l'ordre suivant :

1. Confirmez d'abord l'utilisateur actuel, le cycle et le titre de la page ;
2. Après avoir collé les O/KR, vérifiez l'aperçu de l'analyse pour confirmer le nombre et la hiérarchie des O/KR ; si le collage en masse ne peut pas générer de mentions réelles, utilisez les contrôles d'édition de la page pour sélectionner les collaborateurs un par un ;
3. Utilisez le sélecteur d'utilisateur de la page pour chaque O/KR nécessitant une mention, vérifiez le nom affiché et le département, évitez de simplement saisir le texte normal @Nom ;
4. Effectuez uniquement la confirmation de sauvegarde, ne cliquez pas sur Publier ;
5. Revenez à la page finale pour vérifier le statut « Sauvegardé », le texte des O/KR et les étiquettes d'utilisateur réelles, et confirmez que chaque objectif conserve toujours le bouton « Publier » ;
6. En cas de fermeture d'une fenêtre contextuelle, d'absence d'invite de sauvegarde, de non-apparition d'étiquettes de mention ou de nombre de champs anormal, relisez la page sans déclarer la sauvegarde réussie.

La relation d'alignement n'agit que sur l'Objective. Avant de créer un alignement, confirmez que les deux objectifs appartiennent à des objectifs différents, que leurs cycles se chevauchent et qu'il existe une relation de prolongement ou de collaboration ; ne transformez pas « pertinent » directement en « aligné ». La procédure complète se trouve dans references/feishu-okr-alignment-review.md.

Routage des références

• Principes de rédaction, diagnostic des O/KR et contre-exemples : lisez references/okr-writing-principles.md.
• Alignement et gestion des conflits avant, pendant et après la réunion : lisez references/okr-alignment-review.md.
• Entités OKR Feishu, lecture, écriture, autorisations et relecture : lisez references/feishu-okr-operations.md.