check-impl-against-spec

bởi warpdotdev

So sánh triển khai của pull request với ngữ cảnh đặc tả trong spec_context.md và đưa mọi khác biệt quan trọng vào review.json. Sử dụng trong quá trình đánh giá PR khi đã được phê duyệt hoặc có sẵn ngữ cảnh đặc tả của kho lưu trữ.

npx skills add https://github.com/warpdotdev/common-skills --skill check-impl-against-spec
Tải ZIPGitHub
165

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.

Thêm skills từ warpdotdev

council
warpdotdev
Chạy một hội đồng phụ trợ đa dạng mô hình để điều tra cùng một vấn đề từ nhiều góc nhìn, so sánh các phát hiện và đưa ra khuyến nghị cuối cùng. Sử dụng kỹ năng này bất cứ khi nào người dùng yêu cầu một hội đồng, ý kiến thứ hai, nhiều tác nhân/mô hình để đánh giá một câu hỏi, điều tra song song, so sánh đội đỏ/đội xanh, hoặc trợ giúp quyết định giữa các phương pháp kỹ thuật cạnh tranh.
researchcommunicationproject-management
spec-driven-implementation
warpdotdev
Thúc đẩy quy trình làm việc theo hướng đặc tả trước cho các tính năng lớn bằng cách viết PRODUCT.md trước khi triển khai, viết TECH.md khi cần thiết, và cập nhật cả hai đặc tả khi quá trình triển khai phát triển. Sử dụng khi bắt đầu một tính năng quan trọng, lên kế hoạch triển khai do tác nhân điều khiển, hoặc khi người dùng muốn kiểm tra các đặc tả sản phẩm và kỹ thuật vào hệ thống quản lý mã nguồn.
developmentdocumentproject-management
review-pr
warpdotdev
Xem xét diff của pull request và viết phản hồi có cấu trúc vào review.json để quy trình làm việc xuất bản. Sử dụng khi xem xét một PR đã checkout từ các tạo phẩm cục bộ như pr_diff.txt và pr_description.txt và tạo đầu ra đánh giá có thể đọc bằng máy thay vì đăng trực tiếp lên GitHub.
code-reviewdevelopment
create-pr
warpdotdev
Tạo một pull request trong kho lưu trữ warp cho nhánh hiện tại. S
developmentcode-review
implement-specs
warpdotdev
Triển khai một tính năng đã được phê duyệt từ PRODUCT.md và TECH.md, giữ cho đặc tả và mã nguồn luôn đồng bộ trong cùng một PR khi quá trình triển khai tiến triển. Sử dụng sau khi đặc tả sản phẩm và kỹ thuật đã được phê duyệt và bước tiếp theo là xây dựng tính năng.
developmentcode-reviewapi
cross-critique
warpdotdev
We need to translate the given text from English to Vietnamese. The text is a description of a skill called "cross-critique". The instruction says to preserve the name "cross-critique" if it appears in the source text. It does appear: "cross-critique" is in the skill name at the top, but the instruction says "Do not include the name unless it appears in the source text." The source text inside <text> does not contain the name "cross-critique" explicitly; it only says "this skill" at the end. So we should not add the name. We just translate the text. The text: "Run a second round on a contested question by circulating each subagent's independent proposal to the other authors and asking for structured pros and cons, then synthesize. Use this skill whenever you have multiple independent proposals or opinions on a contested decision — architecture tradeoffs, code review disagreements, design choices, competing root-cause theories — and want sharper analysis than you'd produce by synthesizing alone. Pairs naturally with the council and research skills;
resolve-merge-conflicts
warpdotdev
Resolve Git merge conflicts by extracting only unresolved paths, conflict hunks, and compact diffs instead of loading whole files into context. Use when a merge, rebase, cherry-pick, or stash pop stops on conflicts, when `git status` shows unmerged paths, or when files contain conflict markers.
developmentcode-review
brandalf
warpdotdev
Hướng dẫn tạo, chỉnh sửa và xem xét các tài sản mang thương hiệu Warp hoặc Oz. Sử dụng khi làm việc trên các trang ra mắt, tài liệu, thành phần HTML/CSS, mô phỏng giao diện người dùng, lời nhắc, tài sản truyền thông xã hội, nội dung quảng cáo, bài thuyết trình hoặc bất kỳ sản phẩm có thương hiệu nào khác cần trông và nghe rõ ràng là của Warp hoặc Oz.
designcreativemarketing