Aller au contenu
English

Contexte et limites

  • Leçon 3
  • 45 min
  • Module 1 : Mettre en place un environnement de travail sûr

Où nous en sommes

Dans la dernière leçon, nous avons préparé un point de départ propre, pour que chaque modification de l'assistant apparaisse dans les différences. Mais les différences montrent un changement seulement après coup. Un assistant serviable peut aussi lire un secret, installer un paquet ou pousser vers un dépôt distant. Dans cette leçon, nous notons ce qu'il peut lire, modifier et exécuter avant qu'il commence, comme une note laissée à la personne qui garde votre appartement.

Ce que vous saurez faire

Avant de commencer, notez ce qu’un assistant de programmation peut lire, modifier et exécuter dans votre projet. Un court fichier de périmètre précise les fichiers, les secrets, les commandes à réviser et les actions qui dépassent votre ordinateur.

Avant de commencerCe qu’il faut savoir et avoir sous la mainEnviron 45 minutes

Ce que vous devez savoir

Ce qu’il vous faut sur votre ordinateur

  • Le projet ~/projects/ticket-cleaner-assist de Préparer le dépôt, sur la branche feature/category-option, avec son environnement actif. python -m pytest affiche 25 passed (25 tests réussis), et git status indique working tree clean (répertoire de travail propre).
  • Si le projet manque ou ne fonctionne plus, renommez-le et recréez-le avec les étapes de Mettre en place le projet et Fixer le rapport avec un test.

Vous partez une semaine et un voisin s’occupe de votre appartement. Vous laissez une clé et une note sur la table de cuisine :

  • Vous pouvez utiliser la cuisine. Veuillez arroser les plantes.
  • N’ouvrez pas le bureau dans la pièce de travail. Il contient mes documents bancaires.
  • Appelez-moi avant de laisser entrer quelqu’un ou de signer pour un colis.
  • Ne payez aucune facture pour moi, même si quelqu’un dit que c’est urgent.

La note ne dit pas que votre voisin est malhonnête. Elle précise les pièces, les objets précieux, les décisions qui vous reviennent et les actions qui dépassent l’appartement. Sans elle, un voisin serviable doit deviner. Et une supposition bien intentionnée peut être fausse.

Le problème : un assistant serviable décide des limites

Section intitulée « Le problème : un assistant serviable décide des limites »

L’équipe du cours a donné cette requête à un assistant, avec les fichiers de ticket_cleaner/ (transcription refactor-open) :

Prompt
Refactor the code in ticket_cleaner/ to make it cleaner and easier to maintain.

L’assistant a modifié 3 fichiers, ajouté 40 lignes et supprimé 21 lignes. Les 24 tests ont réussi. Une des modifications a réécrit write_json() dans files.py, la fonction qui écrit chaque rapport de façon sûre :

temporary = path.with_name(path.name + ".tmp")
with open(temporary, "w", encoding="utf-8") as file:
json.dump(data, file, indent=2, ensure_ascii=False)
file.write("\n")
os.replace(temporary, path)
temporary: Path | None = None
try:
with NamedTemporaryFile(

Le nouveau code est peut-être correct. Mais personne n’a demandé une nouvelle façon d’écrire les rapports, et tous les rapports du projet passent maintenant par ce code. Le bogue de Grace, la raison d’examiner ce code maintenant, était toujours présent après la session. La requête ne fixait aucune limite. L’assistant les a donc fixées lui-même.

Un agent peut faire plus que modifier des fichiers. Si vous le permettez, il exécute des commandes, dont certaines dépassent votre ordinateur. pip install télécharge du code sur Internet et en exécute une partie. python -m ticket_cleaner remote envoie une requête à un service Web, avec le jeton si vous en avez défini un. git push publie vos commits (modifications enregistrées) pour l’équipe. Une conversation dépasse aussi votre ordinateur : tout ce que vous collez va sur les serveurs du fournisseur.

Le périmètre d’un assistant définit ce qu’il peut lire, modifier et exécuter dans un projet. Notez-le dans un court fichier du projet, en quatre parties, comme la note pour votre voisin :

  1. Fichiers : ceux qu’il peut modifier, ceux qu’il peut seulement lire et ceux qu’il ne doit jamais ouvrir.
  2. Secrets : leur emplacement et la règle interdisant de les inclure dans une requête (prompt), un journal ou un fichier.
  3. Commandes : celles qu’il peut exécuter et celles que vous devez d’abord réviser.
  4. Actions externes : tout ce qui dépasse cet ordinateur, comme un téléchargement, un téléversement, un message ou un envoi au dépôt distant.

Un périmètre est une demande, pas un verrou. Un modèle peut ignorer une phrase de sa requête. Le fichier de périmètre a donc deux fonctions. Il indique les limites à l’assistant. Et il vous donne une liste pour vérifier les différences et la session. Les vrais verrous sont les paramètres de l’outil et l’endroit où l’assistant travaille.

Pour rédiger la partie sur les commandes, classez chaque commande selon ce qu’elle peut toucher. Il y a trois groupes : lecture seulement, modification de fichiers sur cet ordinateur ou accès à l’extérieur.

Commande Ce qu’elle touche Groupe
python -m pytest lit le code. Elle écrit seulement dans le dossier de cache .pytest_cache/, que Git ignore. Les tests écrivent dans des dossiers temporaires. lecture seulement
ruff check . lit le code, écrit seulement dans .ruff_cache/ lecture seulement
ruff format . réécrit chaque fichier dont le format est incorrect modifie des fichiers locaux
python -m ticket_cleaner data/tickets.csv écrit reports/summary.json modifie des fichiers locaux
pip install some-package télécharge un paquet depuis PyPI, peut exécuter son code pendant l’installation et modifie .venv/ accède à l’extérieur et modifie des fichiers locaux
git push envoie vos commits à un autre dépôt accède à l’extérieur

Le premier groupe peut s’exécuter à tout moment. Le deuxième demande d’examiner git diff après l’exécution. Le troisième exige votre décision avant l’exécution. Une règle simplifie le dernier groupe : un assistant n’accède pas à l’extérieur de sa propre initiative.

Amira écrit ASSISTANT-SCOPE.md dans le dossier du projet, avec Kwame. Pour chaque partie, Kwame pose sa question habituelle : « Que peut toucher l’assistant ici? » Voici le résultat. Il se trouve aussi dans l’instantané end-of-m01 :

ASSISTANT-SCOPE.md
# What a coding assistant may do in this project
This file is for anyone who uses a coding assistant on ticket-cleaner: a chat
window, completions in an editor, or an agent that changes files and runs
commands. Give it to the assistant with each task, and check its work against it.
## Files
| Files | The assistant may |
|---|---|
| `ticket_cleaner/*.py`, `tests/*.py` | read and change them, for the task only |
| `README.md`, `DECISIONS.md`, `docs/` | read them; change them when the task changes what they say |
| `data/` | read them; never change, add or delete a data file |
| `requirements.txt`, `requirements-lock.txt`, `pyproject.toml` | read them; a change needs my review first (see "Dependencies") |
| `.env.example` | read it; never add a real value |
| `.env`, `.venv/`, `reports/`, `.git/` | never read or change them |
## Secrets
- `TICKETS_API_TOKEN` is a secret. It is only in my terminal or in `.env`, which
is in `.gitignore`. The assistant never sees, prints, logs or writes it.
- Never paste a token, a password or a customer's personal data into a prompt.
The sample data in `data/` is made up.
## Commands
| Command | Rule |
|---|---|
| `python -m pytest`, `ruff check .`, `ruff format --check .` | may run at any time: they only read the code |
| `python -m ticket_cleaner <file> --output <path>` | may run with a file in `data/` and an output in `reports/` or a temporary folder |
| `ruff format .` | changes files: I review the diff after it |
| `pip install`, `pip uninstall` | **never without my review**: I check the package first (see "Dependencies") |
| `git commit`, `git push`, `git checkout`, `git reset`, `rm` | **I run them myself**, after I read the diff |
| `python -m ticket_cleaner remote` | **needs my review**: it connects to a web service |
## External actions
The assistant does not send anything outside this computer: no web requests, no
uploads, no messages, no pull requests. The only command that uses the network
is `remote`, and I run it myself.
## Dependencies
Before a new package is added, I check on https://pypi.org that it exists, that
it is maintained, that its licence fits this project (MIT), and that the
project really needs it. The standard library comes first.
## Every change
- Work happens on a branch, never on `main`.
- I read the whole diff before I accept it, and I run the tests and ruff myself.
- A change that is not in the task goes into a separate task.

Chaque règle a une raison que vous avez déjà rencontrée :

  • « Pour la tâche seulement » répond à la session de réusinage ci-dessus. Une modification hors de la tâche devient une tâche distincte, avec sa propre révision.
  • data/ est en lecture seule, car le test de référence de base et le rapport de Grace dépendent de ces lignes exactes. Un fichier de données « nettoyé » ferait paraître correct un programme défectueux.
  • .env n’est jamais ouvert, car c’est le seul fichier qui pourrait contenir le vrai jeton. .gitignore l’exclut déjà de Git. Un agent qui construit sa carte à partir de Git, comme Aider, ne le liste donc pas.
  • Les dépendances exigent votre révision, car un modèle peut inventer un nom de paquet. Vérifier les dépendances examine les noms réels et inventés.
  • Les commandes Git vous reviennent. Un commit dit « J’ai lu ceci et je l’accepte », et vous seul pouvez le dire. Un git reset ou un rm peut supprimer du travail qui ne figure dans aucun commit.
Trois zones imbriquées. À l'intérieur : le dossier du projet, avec quatre groupes de fichiers : modification permise pour la tâche seulement (ticket_cleaner et tests); modification seulement si la tâche change leur contenu (README, DECISIONS, docs); lecture seule, avec révision pour toute modification (data, requirements, pyproject, .env.example); lecture et modification interdites (.env, .venv, reports, .git). Autour : le terminal sur cet ordinateur, avec les commandes qui lisent seulement le code (pytest, ruff check, ruff format --check) et celles qui modifient des fichiers locaux (ruff format, le programme avec --output, git commit). À l'extérieur : les services externes. Trois commandes franchissent la limite extérieure : pip install vers PyPI, python -m ticket_cleaner remote vers le service Web de billets, git push vers le dépôt distant de l'équipe.
La frontière d'accès de ticket-cleaner, selon ASSISTANT-SCOPE.md. Plus une action va loin, plus elle exige votre intervention : le vert peut s'exécuter, l'orange modifie des fichiers et exige d'examiner les différences, le rouge exige d'abord votre décision.
Description textuelle du diagramme

Le diagramme comporte trois zones imbriquées. La zone intérieure est le dossier du projet, avec quatre groupes de fichiers. ticket_cleaner/.py et tests/.py peuvent changer, pour la tâche seulement. README.md, DECISIONS.md et docs/ changent seulement si la tâche change leur contenu. data/, les fichiers requirements, pyproject.toml et .env.example sont en lecture seule, et une modification exige une révision. .env, .venv/, reports/ et .git/ ne sont jamais lus ni modifiés. La zone centrale est le terminal sur cet ordinateur. Les commandes qui lisent seulement le code peuvent s’exécuter : python -m pytest, ruff check . et ruff format –check . Une flèche nommée « lecture » va de ces commandes au code. Les commandes qui modifient les fichiers locaux sont ruff format . (réviser les différences après), le programme avec –output reports/…, et git commit, que vous exécutez vous-même. Une flèche nommée « écriture » va de ces commandes aux fichiers. La zone extérieure est hors de cet ordinateur : les services externes. Trois flèches rouges y entrent. pip install va vers PyPI, l’index de paquets. python -m ticket_cleaner remote va vers le service Web de billets. git push va vers le dépôt distant de l’équipe. Vous révisez ou exécutez vous-même ces trois commandes.

Un bac à sable : une limite qui ne dépend pas du modèle

Section intitulée « Un bac à sable : une limite qui ne dépend pas du modèle »

Le fichier de périmètre demande. Un bac à sable impose. C’est un endroit où un programme peut travailler sans atteindre ce qui compte pour vous. Le nom évoque le bac à sable d’un enfant : creusez autant que vous voulez, le jardin reste intact.

L’équipe a enregistré chaque session de ce cours dans un bac à sable simple. C’est un bon modèle pour votre travail :

Une zone verte en pointillés, le bac à sable : un dossier temporaire sur l'ordinateur de l'auteur. À l'intérieur : une nouvelle copie de start dans un nouveau dépôt Git; l'assistant, Aider, avec les commandes shell et les commits désactivés, et HOME défini sur le dossier temporaire; sa clé, factice; un encadré Git : chaque modification apparaît dans git diff et la copie peut être supprimée; un serveur mandataire de journalisation qui ajoute la vraie clé et enregistre chaque requête et réponse. L'assistant modifie les fichiers de la copie et envoie des requêtes par le serveur mandataire au modèle sur Azure, hors de l'ordinateur. Un encadré rouge hors du bac à sable : les projets personnels de l'auteur, les paramètres de l'éditeur et de l'assistant, et les autres clés.
Comment le cours a enregistré ses sessions avec l'assistant. L'assistant pouvait modifier seulement une copie jetable et ne détenait jamais la vraie clé. Il n'exécutait aucune commande, sauf les tests dans les échanges qui les autorisaient.
Description textuelle du diagramme

Le diagramme montre une zone verte en pointillés, le bac à sable : un dossier temporaire sur l’ordinateur de l’auteur. Il contient une nouvelle copie de start dans un nouveau dépôt Git, facile à comparer et à jeter. L’assistant, Aider, fonctionne avec les commandes shell et les commits désactivés. Son dossier personnel est le dossier temporaire. Il ne lit donc pas les paramètres personnels de l’auteur. Il pouvait exécuter les tests seulement dans les quelques échanges qui les autorisaient. Sa clé est factice, pas la vraie clé. L’assistant modifie les fichiers de la copie, et chaque modification apparaît dans git diff. Ses requêtes passent par un serveur mandataire de journalisation, qui ajoute la vraie clé et enregistre chaque requête et réponse dans un journal. Le serveur mandataire envoie la requête au modèle sur Azure, hors de l’ordinateur. Hors du bac à sable, en rouge, se trouvent les projets personnels de l’auteur, les paramètres de l’éditeur et de l’assistant, et les autres clés. L’assistant ne peut pas y accéder.

Chaque élément est un vrai paramètre du script d’enregistrement, par exemple --no-suggest-shell-commands et --no-auto-commits. La vraie clé existait seulement dans le serveur mandataire. Aucune transcription ni aucun journal ne la contient donc.

Vous pouvez construire un bac à sable plus simple avec vos connaissances. Travaillez dans une copie, comme ticket-cleaner-assist, jamais dans la seule copie d’un projet. Faites un commit avant chaque session pour que git restore . puisse annuler les modifications. Utilisez les paramètres de votre outil pour désactiver les commandes indésirables ou demander votre accord avant chacune. Et gardez les secrets hors du dossier et du terminal où l’assistant travaille.

  1. Dans ~/projects/ticket-cleaner-assist, vérifiez l’état de départ :

    Fenêtre de terminal
    git status

    La sortie doit indiquer On branch feature/category-option (sur la branche feature/category-option) et nothing to commit, working tree clean (rien à enregistrer, répertoire de travail propre).

  2. Copiez le fichier de périmètre depuis l’instantané end-of-m01 :

    Fenêtre de terminal
    cp ../nextia-learning-labs/C15/snapshots/end-of-m01/ASSISTANT-SCOPE.md .

    Vous pouvez aussi le saisir vous-même à partir de l’encadré ci-dessus. La vérification de l’étape suivante détectera alors toute erreur de saisie.

  3. Lisez le fichier dans votre éditeur, une règle à la fois. Pour chaque règle, nommez sa partie : fichiers, secrets, commandes ou actions externes.

  4. Faites un commit :

    Fenêtre de terminal
    git add ASSISTANT-SCOPE.md
    git commit -m "Write down what an assistant may do in this project"
    git log --oneline
    Sortie
    [feature/category-option 03e50ea] Write down what an assistant may do in this project
    1 file changed, 52 insertions(+)
    create mode 100644 ASSISTANT-SCOPE.md
    03e50ea Write down what an assistant may do in this project
    245d23e Pin today's report of the sample file
    2498e15 Start

    Vos empreintes sont différentes.

  5. Exécutez de nouveau les vérifications :

    Fenêtre de terminal
    python -m pytest
    ruff check .
    ruff format --check .
    Output (the end of each command)
    ============================== 25 passed in 0.04s ==============================
    All checks passed!
    17 files already formatted

    ruff vérifie aussi le format des fichiers Markdown. Il compte donc un fichier de plus.

  6. Sur macOS et Linux, comparez votre projet à l’instantané. Les dossiers créés par vous-même, comme .venv, sont exclus :

    Fenêtre de terminal
    diff -rq . ../nextia-learning-labs/C15/snapshots/end-of-m01 -x .git -x .venv -x reports -x __pycache__ -x .pytest_cache -x .ruff_cache

    La commande n’affiche rien : votre projet correspond à end-of-m01. Sur Windows, sautez cette étape.

La façon dont l’assistant reçoit le fichier dépend du mode :

  • Conversation : collez les parties utiles à la tâche avant la tâche elle-même. La conversation ne peut pas exécuter de commandes. Les parties fichiers et secrets comptent donc le plus.
  • Complétion : le périmètre vous sert pendant que vous acceptez ou refusez chaque suggestion.
  • Agent : ajoutez le fichier à la session comme fichier à lire, pas à modifier. Plusieurs agents peuvent aussi lire un fichier d’instructions du projet au début de chaque session. La documentation de votre outil donne son nom. Utilisez ensuite les paramètres de l’outil pour que les commandes exigent votre approbation.

Dans chaque mode, le périmètre reste votre liste de vérification. Après la session, comparez git diff --stat à la partie fichiers, et les commandes de la session à la partie commandes.

Écrivez-en un avant la première session de chaque projet et gardez-le court : un écran. Cela prend quelques minutes. Mettez-le à jour quand le projet change, par exemple avec un nouveau secret ou une nouvelle commande qui accède à l’extérieur.

Un périmètre a un coût. Un périmètre strict bloque du travail utile : si l’assistant ne peut pas modifier README.md, il ne peut pas documenter l’option ajoutée. Voilà pourquoi le fichier dit « si la tâche change leur contenu », et non « jamais ». Et un périmètre ne rend jamais une modification correcte. Il limite les endroits où les erreurs peuvent survenir. La révision dans le module Examiner le travail généré les trouve.

Erreur courante

Un secret se retrouve dans une requête

Symptôme : un test de l’entrée remote échoue avec une erreur du service Web. Pour obtenir de l’aide, vous collez la sortie et votre fichier .env dans une conversation. La réponse est utile. Plus tard, vous remarquez que le vrai TICKETS_API_TOKEN est dans la conversation.

Cause : tout ce que vous collez dans une conversation va sur les serveurs du fournisseur. Cela peut rester dans votre historique, dans les journaux du fournisseur et dans toute copie de la conversation que vous partagez. Un secret qui a quitté votre ordinateur n’est plus un secret.

Correction : considérez le jeton comme divulgué. Demandez un nouveau jeton au propriétaire du service et invalidez l’ancien, même si rien de grave n’est encore arrivé. Suivez ensuite le périmètre : collez seulement .env.example, dont les valeurs sont vides, et remplacez toute vraie valeur par un substitut comme <token>. Le code des paramètres du cours Python pour l’ingénierie de l’IA en pratique exclut déjà le jeton de la sortie du programme, avec field(repr=False).

Exercice du module : un projet jetable avec son propre périmètre

Section intitulée « Exercice du module : un projet jetable avec son propre périmètre »

L’exercice du module : préparez un projet jetable et documentez le périmètre d’une nouvelle tâche. Un projet jetable est une copie que vous pouvez supprimer à tout moment. Utilisez-le pour expérimenter et essayer un nouvel assistant.

Voici votre tâche : un assistant ajoutera des tests pour count_by_category() dans report.py, et rien d’autre.

  1. Dans ~/projects, copiez l’instantané end-of-m01 dans un nouveau dossier, ticket-cleaner-try.
  2. Créez son environnement, un dépôt Git avec un commit et une branche try/tests-only.
  3. Vérifiez la référence de base : python -m pytest affiche 25 passed.
  4. Remplacez son ASSISTANT-SCOPE.md par un périmètre pour cette tâche seulement. Utilisez les quatre parties. Réfléchissez aux fichiers que l’assistant peut modifier maintenant et à ceux qu’il peut seulement lire.
  5. Faites un commit du périmètre. Supprimez ensuite le dossier : il était jetable.
Afficher un exemple de réponse

Les commandes, sur macOS et Linux (sur Windows, utilisez Copy-Item -Recurse, python -m venv .venv et .venv\Scripts\Activate.ps1, comme dans la dernière leçon) :

Fenêtre de terminal
cd ~/projects
cp -R nextia-learning-labs/C15/snapshots/end-of-m01 ticket-cleaner-try
cd ticket-cleaner-try
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements-lock.txt
git init
git add -A
git commit -m "Start"
git switch -c try/tests-only
python -m pytest

La dernière ligne est 25 passed. Voici un périmètre possible :

ASSISTANT-SCOPE.md (ticket-cleaner-try)
# What a coding assistant may do in this copy
Task: add tests for `count_by_category()` in `ticket_cleaner/report.py`.
This folder is a disposable copy: I delete it when the task is done.
## Files
| Files | The assistant may |
|---|---|
| `tests/*.py` | read and change them; add a new test file |
| `ticket_cleaner/*.py` | read them only: a test must not change the code |
| `data/`, `README.md`, `requirements*.txt`, `pyproject.toml` | read them only |
| `.env`, `.venv/`, `reports/`, `.git/` | never read or change them |
## Commands
| Command | Rule |
|---|---|
| `python -m pytest`, `ruff check .`, `ruff format --check .` | may run at any time |
| `ruff format tests/` | changes files: I review the diff after it |
| `pip install`, `git commit`, `git push`, `rm` | never: I decide and run them myself |
## Secrets and external actions
No secret is needed for this task. Nothing leaves this computer: no `remote`,
no `pip install`, no push.

Ensuite :

Fenêtre de terminal
git add ASSISTANT-SCOPE.md
git commit -m "Scope for the tests-only task"
python -m pytest
cd ..
rm -rf ticket-cleaner-try

pytest affiche toujours 25 passed : le fichier de périmètre ne modifie aucun code. Sur Windows, supprimez le dossier avec Remove-Item -Recurse -Force ticket-cleaner-try.

La principale différence avec le fichier d’Amira tient en une ligne : ticket_cleaner/*.py est maintenant en lecture seule. Une tâche « ajouter des tests » qui modifie le code testé est une autre tâche. Si les nouveaux tests trouvent un bogue, l’assistant le signale, et vous décidez de la suite. Votre fichier peut utiliser d’autres mots. Vérifiez qu’il contient les quatre parties et qu’un réviseur pourrait dire « cette ligne des différences dépasse le périmètre ».

La vérification de fin du module : indiquez quelles actions modifient les fichiers locaux et lesquelles touchent des systèmes hors de votre ordinateur. Classez ces huit actions en trois groupes : lecture seule, modification de fichiers locaux, accès à l’extérieur. Certaines actions appartiennent à deux groupes.

  1. python -m pytest
  2. ruff format .
  3. python -m ticket_cleaner data/tickets.csv
  4. git commit -m "Add the option"
  5. git restore .
  6. pip install -r requirements-lock.txt
  7. python -m ticket_cleaner remote
  8. git push, et coller cli.py dans une fenêtre de clavardage
Afficher la réponse
Action Groupe Pourquoi
python -m pytest lecture seule lit le code; Git ignore son dossier de cache
ruff format . modification de fichiers locaux réécrit les fichiers dont le format est incorrect : examinez git diff ensuite
python -m ticket_cleaner data/tickets.csv modification de fichiers locaux écrit dans reports/summary.json
git commit modification de fichiers locaux ajoute un commit (enregistrement des modifications) à .git/; rien ne quitte l’ordinateur
git restore . modification de fichiers locaux rétablit les fichiers enregistrés dans un commit et supprime les modifications non enregistrées
pip install -r requirements-lock.txt accès à l’extérieur et modification de fichiers locaux télécharge des paquets depuis PyPI, puis modifie .venv/
python -m ticket_cleaner remote accès à l’extérieur et modification de fichiers locaux envoie une requête au service web, avec le jeton s’il est défini, puis écrit le rapport
git push accès à l’extérieur envoie des commits à un autre dépôt. Dans le cours sur Git, c’était un dossier sur votre ordinateur; en équipe, c’est un serveur
coller cli.py dans un clavardage accès à l’extérieur le texte va aux serveurs du fournisseur

Le fichier de limites soumet le deuxième groupe à votre révision, et le troisième à votre décision.

Vous avez terminé le module quand vous pouvez aussi montrer ces résultats dans votre propre projet :

  • git log --oneline affiche trois commits sur feature/category-option : Start (début), Pin today's report of the sample file (figer le rapport actuel du fichier d’exemple) et Write down what an assistant may do in this project (consigner ce qu’un assistant peut faire dans ce projet).
  • python -m pytest affiche 25 passed (25 tests réussis), et vous pouvez expliquer ce que protège tests/test_baseline.py.
  • Vous pouvez expliquer chaque partie de ASSISTANT-SCOPE.md, et pourquoi un fichier de limites n’est pas un verrou à lui seul.

Réinitialisation. Si votre projet ne fonctionne plus, renommez-le et recréez-le à partir de deux instantanés. main reçoit l’instantané start du cours, comme dans Préparer le dépôt. La branche reçoit l’instantané du dernier module terminé, dans un seul commit. Dans ~/projects, sur macOS et Linux :

Fenêtre de terminal
mv ticket-cleaner-assist ticket-cleaner-assist-old
cp -R nextia-learning-labs/C15/snapshots/start ticket-cleaner-assist
cd ticket-cleaner-assist
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements-lock.txt
git init
git add -A
git commit -m "Start"
git switch -c feature/category-option
cp -R ../nextia-learning-labs/C15/snapshots/end-of-m01/. .
git add -A
git commit -m "Copy the snapshot end-of-m01"
python -m pytest

La dernière ligne est 25 passed. Les modules suivants utilisent les mêmes étapes, avec leur propre instantané aux deux endroits contenant end-of-m01. main reste toujours au point de départ du cours. Ainsi, la demande de tirage (pull request) du module 5 montre l’ensemble des modifications.

Après une réinitialisation, le dépôt contient deux commits plutôt que trois : Start sur main, et un commit sur la branche. Les vérifications des modules suivants comptent les commits des étapes des leçons. Vous en avez donc moins après une réinitialisation. Ce n’est pas un problème : les fichiers, les tests et la vérification diff -rq sont ce qui compte.

Sur Windows, dans PowerShell : Rename-Item ticket-cleaner-assist ticket-cleaner-assist-old, puis Copy-Item -Recurse nextia-learning-labs\C15\snapshots\start ticket-cleaner-assist. Utilisez python -m venv .venv et .venv\Scripts\Activate.ps1. Pour la deuxième copie, utilisez Copy-Item -Recurse -Force ..\nextia-learning-labs\C15\snapshots\end-of-m01\* .. Les commandes Windows n’ont pas été testées.

Vérifiez votre compréhension

Nommez les quatre parties d'un fichier de limites, avec une règle de ASSISTANT-SCOPE.md pour chacune.

Afficher la réponse
  • Fichiers : ticket_cleaner/*.py et tests/*.py peuvent changer, uniquement pour la tâche; data/ est en lecture seule; .env n’est jamais lu ni modifié.
  • Secrets : TICKETS_API_TOKEN reste uniquement dans votre terminal ou dans .env. Il ne va jamais dans une requête (prompt), un journal ou un fichier.
  • Commandes : python -m pytest et ruff check . peuvent être exécutées à tout moment. pip install ne s’exécute jamais sans votre révision. Vous exécutez vous-même git commit et git push.
  • Actions externes : l’assistant n’envoie rien hors de cet ordinateur. La seule commande qui utilise le réseau est remote, et vous l’exécutez vous-même.

Vérifiez votre compréhension

Tomás dit : « On a écrit le fichier de limites et on l'a donné à l'agent. Maintenant, il ne peut plus toucher à .env. » A-t-il raison? Qu'est-ce qui limite vraiment un agent?

Afficher la réponse

Il a tort. Un fichier de limites est du texte dans la requête. Un modèle peut l’ignorer ou mal le comprendre. Ce fichier ne limite rien à lui seul. Deux choses limitent un agent. La première est la configuration de son outil : aucune commande shell, par exemple, ou une approbation avant chaque commande. La deuxième est son environnement de travail : une copie du projet enregistrée dans un commit, sans secret dans le dossier ni le terminal. C’est un bac à sable. Le fichier de limites reste important : il indique les limites à l’assistant. Il vous sert aussi de liste de vérification pour réviser les différences et la session.

Vérifiez votre compréhension

Dans la session refactor-open, la demande « rendre le code plus propre » a modifié write_json() dans files.py. Tous les tests ont réussi. Quelle ligne de ASSISTANT-SCOPE.md un réviseur utiliserait-il pour contester cette modification? Pourquoi est-ce important ici?

Afficher la réponse

« Lisez-les et modifiez-les, uniquement pour la tâche » et « Une modification hors de la tâche va dans une tâche distincte. » La tâche concernait l’option de catégorie ou le bogue de Grace, pas une nouvelle façon d’écrire les fichiers. write_json() écrit tous les rapports du projet. Une modification à cet endroit exige donc sa propre révision et ses propres tests, même si elle semble être une amélioration. Les tests réussis ne répondent pas à cette question : ils montrent seulement que les tests existants réussissent encore.

Récapitulatif

Cette leçon

  • Les limites d’un assistant définissent ce qu’il peut lire, modifier et exécuter. ASSISTANT-SCOPE.md les consigne en quatre parties : fichiers, secrets, commandes et actions externes.
  • Classez les commandes en trois groupes. Certaines lisent seulement (pytest, ruff check .). Certaines modifient des fichiers locaux (ruff format ., le rapport, git commit). Certaines accèdent à l’extérieur (pip install, remote, git push, et le collage dans un clavardage).
  • Un fichier de limites demande; un bac à sable impose. Le cours a enregistré ses sessions dans une copie jetable, avec les commandes shell désactivées et une clé factice.

Module 1 : mettre en place un environnement de travail sûr

  • Trois modes : le clavardage voit ce que vous collez, la complétion suggère du texte là où vous écrivez. Un agent modifie des fichiers et peut exécuter des commandes. Plus il intervient, plus vous vérifiez.
  • Un point de départ propre : un environnement créé à partir du fichier de verrouillage, une branche propre sur un commit et des vérifications de référence de base. Un test fige le rapport actuel.
  • Votre projet correspond à end-of-m01 : trois commits sur feature/category-option et 25 passed.

Ensuite, dans le module 2, vous transformerez le courriel de Grace en tâche. Un assistant ou un collègue pourra la terminer et la vérifier sans devoir deviner.

Leçon suivante : Problème et critères d'acceptation