Koordineeri salvestatud plaani

Kasuta bee plan sõltuvate sammude koordineerimiseks juba registreeritud seansside vahel. Praegune Bee sisaldab create, show, next, children, claim, update ja comment. See ei käivita agente, ei saada ülesandeid automaatselt ega jooksuta teste.

Enne alustamist

Näited on kontrollitud avaldatud spikri/lähtekoodi järgi, mitte käivitatud jagatud andmehoidlas. Vaja on seadistatud profiili, ligipääsetavat MongoDB-d, lubatud koostööd, toetatud elavat native-seanssi sobiva kohaliku seosega ning hoidla töökoopiat. Kasuta koostöö profiili/seansivalikut. Kopeeritud avalik seansi ID üksi ei anna ligipääsu. Spikri nägemine ei kinnita profiili ühendust ega autentimist. Käsk võib ebaõnnestuda käivitamisel enne töö lugemist või salvestamist.

1 · Määra töö

Salvesta failina plan.json. Asenda demo-team ja example.com/team/catalog täpsete seadistatud space’i ja hoidla identiteetidega. Allika asukoht/revision on deklareeritud viide; Bee ei laadi ega kontrolli sisu. ID-d ja ulatus on tõstutundlikud. Seotud worktree võib saada teise ulatuse; ära järelda ligipääsu nimekirjas reklaamitud hoidlanimest.

Loe tegelik ulatus enne plan.json muutmist. Hoidla väärtus on stats-vastuse scope, space tuleb seadistusest. Säilita join’i tagastatud seansivalija kõigis plaanikäsudes.

bee remember stats --json
bee config get collaboration.space

{
  "schemaVersion": 1,
  "revision": 1,
  "id": "catalog-change",
  "title": "Change catalog prices",
  "scope": {
    "space": "demo-team",
    "repository": "example.com/team/catalog"
  },
  "sources": [
    {
      "location": "docs/prices.md",
      "revision": "requirements-v1"
    }
  ],
  "steps": [
    {
      "id": "implement",
      "title": "Implement price change",
      "acceptanceCriteria": [
        {
          "id": "cents",
          "description": "Prices remain whole cents"
        }
      ]
    },
    {
      "id": "verify",
      "title": "Review tests",
      "dependencyIds": [
        "implement"
      ],
      "acceptanceCriteria": [
        {
          "id": "evidence",
          "description": "Review original test artifacts and runner exit"
        }
      ]
    }
  ]
}

2 · Loo ja uuri

Määra enne esimest kasutust CREATE_REQUEST_ID, CLAIM_REQUEST_ID ja COMPLETE_REQUEST_ID erinevateks uuteks väiketähtedega UUID-deks. Korda sama ID ja argumentidega ainult sama toimingut. Allolevad muutujad on POSIX-kesta näited.

Genereeri päringu ID-d Bash/zsh-s üks kord (vajab Python 3):

CREATE_REQUEST_ID="$(python3 -c 'import uuid; print(uuid.uuid4())')"
CLAIM_REQUEST_ID="$(python3 -c 'import uuid; print(uuid.uuid4())')"
COMPLETE_REQUEST_ID="$(python3 -c 'import uuid; print(uuid.uuid4())')"

PowerShell:

$CREATE_REQUEST_ID = [guid]::NewGuid().ToString()
$CLAIM_REQUEST_ID = [guid]::NewGuid().ToString()
$COMPLETE_REQUEST_ID = [guid]::NewGuid().ToString()

bee plan create --file plan.json --request-id "$CREATE_REQUEST_ID" --json
bee plan show catalog-change --json
bee plan next catalog-change --limit 1 --json

show tagastab määratluse ja käitusoleku. Uue muutmata näite korral pakub next sammu implement, millel pole sõltuvusi. verify saab valmisoleku pärast sõltuvuse lõpetatuks raporteerimist. See on määratlusest tulenev oodatud projektsioon, mitte salvestatud eduka käituse väljund. next annab nõu ega reserveeri tööd. Tagastatakse kuni viis sammu; kontrolli hasMore ja väljajätmiste arve.

3 · Võta töö ja raporteeri

Kasuta claim tagastatud claim generation’i. Salvesta faili summary.txt üherealine UTF-8 kokkuvõte ilma algus-/lõputühikute ja reavahetuseta, näiteks Implementation ready for review. Järgmine update teatab lõpetamisest, kuid ei kinnita kvaliteeti:

bee plan claim catalog-change implement --revision 1 --lease-seconds 300 --request-id "$CLAIM_REQUEST_ID" --json

Uuenda lease’i enne aegumist viimase tagastatud claim generation’iga. Vaja on uut päringu ID-d; plaani lugemine ei pikenda lease’i. Ka lõpptoimingus kasuta uuendamisel tagastatud generation’it.

RENEW_REQUEST_ID="$(python3 -c 'import uuid; print(uuid.uuid4())')"
bee plan update catalog-change implement --revision 1 --claim-generation <returned-generation> --state renew --lease-seconds 300 --request-id "$RENEW_REQUEST_ID" --json

PowerShell:

$RENEW_REQUEST_ID = [guid]::NewGuid().ToString()
bee plan update catalog-change implement --revision 1 --claim-generation <returned-generation> --state renew --lease-seconds 300 --request-id "$RENEW_REQUEST_ID" --json

Loo kokkuvõte enne lõpetamiskäsku ilma lõpetava reavahetuseta:

printf 'Implementation ready for review' > summary.txt

PowerShell:

[IO.File]::WriteAllText((Join-Path (Get-Location).Path 'summary.txt'), 'Implementation ready for review', [Text.UTF8Encoding]::new($false))

bee plan update catalog-change implement --revision 1 --claim-generation <returned-generation> --state reported_complete --summary-file summary.txt --request-id "$COMPLETE_REQUEST_ID" --json

--revision 1 on muutumatu määratluse versioon. Valikuline --if-version N kontrollib lisaks koondoleku praegust versiooni. Soovitud claim kestab 30–300 sekundit; registreeritud seansi liising võib tegelikku kestust lühendada; lugemine ja korduskatsed ei pikenda seda. running/blocked säilitavad omandi; failed/abandoned vabastavad; reported_complete vabastab ja lubab sõltuvad sammud. renew pikendab kehtivat omandit selgesõnaliselt. Aegumise või uuesti liitumise järel ei saa vana generation lõpetada uuesti võetud tööd.

Alamplaanid ja otsesed sõltuvused

Alamplaani definitsioonis on muutumatud parentId, parentStepId ja parentRevision. children loetleb valitud vanemplaani otsesed lapsed, soovi korral ühe sammu all. See ei loetle järglasi rekursiivselt, ei muuda vanemplaani definitsiooni ega märgi vanemsammu lõpetatuks. Järgmise piiratud lehe (1–5 rida) jaoks kasuta nextAfter väärtust; kopeeritud kursor on vaid lehitsemispositsioon.

bee plan children catalog-change --limit 5 --json
bee plan children catalog-change implement --limit 5 --json
bee plan children catalog-change --after "$NEXT_AFTER" --limit 5 --json

Lisa alamplaani JSON-definitsiooni tegelik vanemplaani ID, sammu ID ja revision. Enne töö jagamist loe tagastatud plaani ning alamplaanide loendit. Aktiivse seansi eeldus on koostöö juhendis.

Taastu tööd dubleerimata

Kood 2 tähendab seadistamata, 3 puuduvat, 4 vigast sisendit/määratlust, 5 kättesaamatust või teadmata tulemust ning 8 konflikti, näiteks kaotatud omandit või blokeerivat sõltuvust. Muud tagasilükkamised võivad anda 1. Loe veakoodi koos protsessi koodiga. outcome_unknown korral säilita täpne request ID ja sisu; kirjutus võib juba olla toimunud. Teadaoleva omandikonflikti korral loe olek ja hangi kehtiv omand enne uut muudatust. Määratlused on muutumatud; update muudab käitusolekut, mitte plaani teksti.

Mida lõpetamine ei tõesta

reported_complete on töö omaniku teade. Vastuvõtukriteeriumid on nõuded, mitte tõend nende täitmisest. Praegune Bee sisaldab diagnostilist bee qa assess ja selgesõnalist bee qa run: viimane käivitab antud kontrollide spetsifikatsiooni ning võib deklareeritud kriteeriumide kohta anda verifiedCompletion=true, kuid usalduspiir on in_process_only. Kontrollide kvaliteet ja subjektiivne eesmärk vajavad eraldi hinnangut. Säilita kompilaatorianalüüs, testikäivitaja algne väljund, lähteidentiteet ja sõltumatu ülevaatus koos plaani olekuga. TRX-i kokkuvõtted üksi ei tõesta, et kõik nõutud testid käivitati.

Koostöö elutsükkel · Kodeerimise töövoog · Käsuviide