Kayıtlı planla işi koordine edin

Bağımlı adımları zaten kayıtlı oturumlar arasında eşgüdümlemek için bee plan kullanın. Güncel Bee create, show, next, children, claim, update ve comment içerir. Ajan başlatmaz, görevleri otomatik göndermez ve test çalıştırmaz.

Başlamadan önce

Örnekler yayımlanan yardım/kaynak üzerinden doğrulanmıştır; canlı depoda çalıştırılmamıştır. Başlatılmış profil, erişilebilir MongoDB, etkin iş birliği, yerel bağlaması eşleşen desteklenen canlı ajan oturumu ve Git çalışma kopyası gerekir. İş birliğindeki profil/oturum seçicisini kullanın. Kopyalanmış açık oturum kimliği tek başına erişim sağlamaz. Yardımı görmek, profilinizin bağlanabildiğini veya kimliğini doğrulayabildiğini göstermez. Komutlar iş okunmadan veya kaydedilmeden açılışta başarısız olabilir.

1 · İşi tanımlayın

plan.json olarak kaydedin. demo-team ve example.com/team/catalog yerine yapılandırılmış space ve depo kimliğini tam olarak yazın. Kaynak konumu/revision birer beyan edilmiş başvurudur; Bee içeriğini getirmez veya doğrulamaz. Kimlikler ve kapsam büyük/küçük harfe duyarlıdır. Bağlı worktree farklı kapsama çözümlenebilir; listedeki repo adından Plan erişimi çıkarmayın.

plan.json düzenlemeden gerçek kapsamı okuyun. Depo değeri stats içindeki scope, space ise yapılandırmadan gelir. Join ile dönen oturum seçicisini tüm plan komutlarında koruyun.

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 · Oluşturun ve inceleyin

İlk kullanımdan önce CREATE_REQUEST_ID, CLAIM_REQUEST_ID, COMPLETE_REQUEST_ID değişkenlerini farklı, yeni, küçük harfli UUID’lere ayarlayın. Aynı işlem yeniden deneniyorsa tam kimliğini ve argümanlarını koruyun. Aşağıdaki değişkenler POSIX kabuk örneğidir.

İstek ID’lerini Bash/zsh içinde bir kez üretin (Python 3 gerekir):

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, tanımı ve yürütme durumunu döndürür. Yeni ve değiştirilmemiş örnekte next, bağımlılığı olmayan implement adımını önerir. verify, bağımlılık tamamlandı diye bildirildikten sonra hazır olur. Bu, tanımdan beklenen sonuçtur; canlı başarı kaydı değildir. next öneri verir, iş ayırmaz. En fazla beş adım döndürür; hasMore ve atlanan sayıları kontrol edin.

3 · Sahiplenin ve bildirin

claim sonucundaki claim generation değerini kullanın. summary.txt dosyasına başında/sonunda boşluk ve satır sonu olmayan tek satır UTF-8 özet yazın; örneğin Implementation ready for review. Şu update tamamlanmayı bildirir, onaylamaz:

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

Lease dolmadan son dönen claim generation ile yenileyin. Yeni istek ID’si gerekir; planı okumak süreyi uzatmaz. Son güncellemede de yenilemeden dönen generation değerini kullanın.

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

Tamamlama komutundan önce özeti son satır sonu olmadan oluşturun:

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, değişmez tanım sürümüdür. İsteğe bağlı --if-version N, toplam durumun güncel sürümünü ayrıca kontrol eder. İstenen sahiplenme süresi 30–300 saniyedir; kayıtlı oturum süresi gerçek süreyi kısaltabilir; okumalar/yeniden denemeler uzatmaz. running/blocked sahipliği tutar; failed/abandoned bırakır; reported_complete bırakıp bağımlıları hazırlar. renew canlı sahipliği açıkça uzatır. Süre dolduktan veya yeniden katılımdan sonra eski generation, yeni sahiplenilmiş işi tamamlayamaz.

Alt planlar ve doğrudan bağımlılıklar

Alt plan tanımında değişmez parentId, parentStepId ve parentRevision bulunur. children seçilen ebeveynin doğrudan alt planlarını, isteğe bağlı olarak bir adımın altındakileri listeler. Torunları yinelemeli listelemez; ebeveyn tanımını değiştirmez veya ebeveyn adımını tamamlamaz. Sonraki sınırlı sayfa (1–5 satır) için nextAfter kullanın; kopyalanan cursor yalnız sayfalama konumudur.

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

Alt planın JSON tanımına gerçek ebeveyn ID’sini, adım ID’sini ve revision’ı koyun. İş dağıtmadan önce dönen planı ve alt plan listesini okuyun. Etkin oturum önkoşulu için Birlikte çalışma.

İşi çoğaltmadan toparlanın

Çıkış 2 başlatılmamış, 3 bulunamadı, 4 geçersiz girdi/tanım, 5 kullanılamıyor veya sonuç bilinmiyor, 8 ise kayıp sahiplik veya bağımlılık engeli gibi çatışmadır. Diğer retler 1 döndürebilir. Süreç çıkışının yanında hata kodunu okuyun. outcome_unknown için aynı request ID ve içeriği koruyun; yazma zaten gerçekleşmiş olabilir. Bilinen sahiplik çatışmasında durumu okuyup yeni değişiklikten önce geçerli sahiplik edinin. Tanımlar değişmezdir; update plan metnini değil yürütme durumunu değiştirir.

Tamamlanma neyi kanıtlamaz?

reported_complete iş sahibinin beyanıdır. Kabul ölçütleri gereksinimdir; geçtiğinin kanıtı değildir. Güncel Bee’de tanısal bee qa assess ve açık bee qa run vardır: ikincisi verilen kontrol tanımını yürütür ve tanımlı ölçütler için verifiedCompletion=true raporlayabilir; güveni in_process_only düzeyindedir. Kontrol kalitesi ve öznel niyet ayrıca incelenmelidir. Derleyici analizini, asıl çalıştırıcı çıktısını, kaynak kimliğini ve bağımsız incelemeyi Plan durumuyla birlikte saklayın. TRX özetleri tek başına tüm gerekli testlerin çalıştığını kanıtlamaz.

İş birliği yaşam döngüsü · Kodlama akışı · Komut referansı