check-impl-against-spec

tarafından warpdotdev

Bir çekme isteğinin uygulamasını spec_context.md dosyasındaki spesifikasyon bağlamına göre karşılaştırır ve önemli uyumsuzlukları review.json dosyasına ekler. Onaylandığında veya depo spesifikasyon bağlamı mevcut olduğunda PR incelemesi sırasında kullanın.

npx skills add https://github.com/warpdotdev/common-skills --skill check-impl-against-spec

Check implementation against spec

Use this skill only when spec_context.md exists during PR review.

Goal

Determine whether the implementation in the checked-out PR materially matches the approved spec context. This is a supplement to the normal code review, not a separate output.

Inputs

  • spec_context.md contains the spec context to compare against. It may include both product spec content (intended behavior, acceptance criteria) and tech spec content (implementation details, file changes).
  • pr_diff.txt contains the annotated diff for the PR.
  • pr_description.md may contain additional scope or rationale.
  • The working tree contains the PR branch contents.

Process

  1. Read spec_context.md and extract the concrete commitments it makes:
    • required behaviors (from the product spec)
    • required files or subsystems to change (from the tech spec)
    • stated constraints
    • required follow-up steps, validation, or migrations
  2. Compare those commitments against the actual implementation in pr_diff.txt and the checked-out files.
  3. Treat small implementation-level adjustments as acceptable when they preserve the spec's intent. Do not flag harmless differences in naming, structure, or low-level technique.
  4. Flag a mismatch only when it is material, such as:
    • required behavior in the product spec is missing
    • the implementation contradicts a spec decision
    • the change introduces significant unplanned scope
    • a required validation, migration, or compatibility step from the tech spec is absent

Outputs

  • Do not create a separate report file.
  • Fold spec-alignment findings into review.json.
  • Put broad spec-drift concerns in the review summary.
  • Add inline comments only when the mismatch can be tied to changed lines in the diff.
  • Treat material spec drift as at least an important concern.
  • If the implementation matches the spec closely enough, do not add comments just to mention alignment.

Boundaries

  • Do not require literal one-to-one implementation of the spec when the PR achieves the same outcome safely.
  • Do not speculate about spec details that are not actually present in spec_context.md.
  • Do not post to GitHub directly.

warpdotdev tarafından daha fazla skill

brandalf
warpdotdev
Warp veya Oz markalı varlıkların oluşturulması, revize edilmesi ve incelenmesine rehberlik eder. Lansman sayfaları, dokümanlar, HTML/CSS bileşenleri, UI maketleri, promptlar, sosyal medya varlıkları, metinler, sunumlar veya tartışmasız Warp ya da Oz gibi görünüp ses vermesi gereken diğer markalı teslimatlar üzerinde çalışırken kullanın.
designcreativemarketing
complain
warpdotdev
Bir ajan, ajan araçlarından veya ajan işi yapma deneyiminden dolayı hayal kırıklığına uğradığında, Slack'e kısa, anonim ve tamamen yapılandırılmamış bir şikayeti otonom olarak fırlat. Bu beceriyi kullanıcının çağırmasını beklemeden proaktif olarak kullan; ajanın ham sesini koru, izin veya önizleme olmadan gönder ve gönderimden asla bahsetme.
council
warpdotdev
Aynı problemi birden çok perspektiften incelemek, bulguları karşılaştırmak ve nihai bir öneri sunmak için model çeşitliliğine sahip bir alt ajan konseyi çalıştırın. Bu beceriyi, kullanıcı bir konsey, ikinci görüşler, tek bir soruyu değerlendirmek için birden çok ajan/model, paralel inceleme, kırmızı takım/mavi takım karşılaştırması veya rekabet eden teknik yaklaşımlar arasında karar verme konusunda yardım istediğinde kullanın.
researchcommunicationproject-management
create-pr
warpdotdev
Warp deposunda mevcut dal için bir çekme isteği oluşturur. Kullanıcı PR açmaktan, çekme isteği oluşturmaktan, inceleme için değişiklik göndermekten veya birleştirme için kod hazırlamaktan bahsettiğinde kullanılır.
developmentcode-review
cross-critique
warpdotdev
Tartışmalı bir soru üzerinde ikinci bir tur yürütmek için her bir alt temsilcinin bağımsız önerisini diğer yazarlara dağıtın ve yapılandırılmış artılar ve eksiler isteyin, ardından sentezleyin. Bu beceriyi, birden fazla bağımsız öneri veya tartışmalı bir karar hakkında görüşünüz olduğunda kullanın — mimari ödünleşimler, kod inceleme anlaşmazlıkları, tasarım seçimleri, rekabet eden kök neden teorileri — ve tek başına sentezleyerek üreteceğinizden daha keskin bir analiz istediğinizde. Konsey ve araştırma becerileriyle doğal olarak eşleşir;...
diagnose-ci-failures
warpdotdev
Bir PR için CI hatalarını GitHub CLI kullanarak teşhis edin, hata günlüklerini çıkarın ve bunları düzeltmek için bir plan oluşturun. Kullanıcı CI durumunu kontrol etmesini, CI sorunlarını çekmesini, test başarısızlıklarını triyajlamasını veya PR derleme hatalarını araştırmasını istediğinde kullanın.
developmenttestingdevops
fix-errors
warpdotdev
Warp Rust kod tabanındaki derleme hatalarını, lint sorunlarını ve test başarısızlıklarını düzeltir. Presubmit kontrollerini, WASM'a özgü hataları ve belirli testlerin çalıştırılmasını kapsar. Kullanıcı derleme hataları, clippy veya fmt başarısızlıkları, test başarısızlıkları yaşadığında veya bir PR öncesinde presubmit çalıştırması veya yorumlaması gerektiğinde kullanın.
developmentcode-reviewtesting
implement-specs
warpdotdev
Onaylanmış bir özelliği PRODUCT.md ve TECH.md'den uygulayın, spesifikasyonlar ve kod aynı PR içinde uygulama geliştikçe uyumlu kalsın. Ürün ve teknik spesifikasyonlar onaylandıktan ve bir sonraki adım özelliği oluşturmak olduğunda kullanın.
developmentcode-reviewapi