Community程式設計與開發github.com

warpdotdev/check-impl-against-spec

將拉取請求的實作與 spec_context.md 中的規格上下文進行比較,並將任何重大差異記錄到 review.json 中。在 PR 審查期間,當規格上下文獲得批准或可用時使用。

check-impl-against-spec 是什麼?

這個技能旨在幫助開發人員或 AI 代理在程式碼審查過程中,自動驗證拉取請求的實作是否與預先定義的規格相符。它通過讀取一個名為 spec_context.md 的文件來獲取規格上下文,然後將 PR 中的程式碼更改與該上下文進行比對,識別出任何重大的不符之處(「material mismatches」)。這些不符之處會被結構化地記錄到一個名為 review.json 的檔案中,方便後續審查或整合到 CI/CD 流程中。此技能特別適用於團隊使用規格驅動開發方法,並希望自動化部分審查流程以確保一致性和節省時間。它支援在審查被批准或儲存庫中有可用規格上下文時使用,並能無縫地與 AI 代碼審查工具協作。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/warpdotdev/common-skills/tree/main/skills/check-impl-against-spec

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

check-impl-against-spec 是做什麼的?

將拉取請求的實作與 spec_context.md 中的規格上下文進行比較,並將任何重大差異記錄到 review.json 中。在 PR 審查期間,當規格上下文獲得批准或可用時使用。

使用方式

當你需要驗證一個拉取請求是否遵循了指定的規格時,可以使用此技能。它會自動從 spec_context.md 中讀取上下文,然後基於 PR 的變更生成審查結果。

輸入

  • spec_context.md:包含規格上下文的檔案,例如功能需求、設計文件或驗收標準。
  • 拉取請求的實作程式碼。

輸出

  • review.json:一個 JSON 檔案,包含任何被偵測到的重大不符之處,以及它們的描述和建議的修正。

注意事項

  • 確保 spec_context.md 存在且內容是最新的。
  • 此技能僅標記重大差異;細微的樣式或非功能性變更可能會被忽略。
  • 建議在 CI/CD 流程中與其他審查工具結合使用。

Individual skills in this repo

This repo contains 16 individual skills — each has its own dedicated page.

warpdotdev/brandalf

Guides creation, revision, and review of Warp- or Oz-branded assets. Use when working on launch pages, docs, HTML/CSS components, UI mockups, prompts, social assets, copy, presentations, or any other branded deliverable that should look and sound unmistakably Warp or Oz.

warpdotdev/council

Run a model-diverse subagent council to investigate the same problem from multiple perspectives, compare findings, and produce a final recommendation. Use this skill whenever the user asks for a council, second opinions, multiple agents/models to evaluate one question, parallel investigation, red-team/blue-team comparison, or help deciding between competing technical approaches.

warpdotdev/create-pr

Create a pull request in the warp repository for the current branch. Use when the user mentions opening a PR, creating a pull request, submitting changes for review, or preparing code for merge.

warpdotdev/diagnose-ci-failures

Diagnose CI failures for a PR using the GitHub CLI, extract error logs, and generate a plan to fix them. Use when the user asks to check CI status, pull CI issues, triage test failures, or investigate PR build failures.

warpdotdev/fix-errors

Fix compilation errors, linting issues, and test failures in the warp Rust codebase. Covers presubmit checks, WASM-specific errors, and running specific tests. Use when the user hits build errors, clippy or fmt failures, test failures, or needs to run or interpret presubmit before a PR.

warpdotdev/implement-specs

Implement an approved feature from PRODUCT.md and TECH.md, keeping specs and code aligned in the same PR as implementation evolves. Use after the product and tech specs are approved and the next step is building the feature.

warpdotdev/pr-walkthrough

Generate a static interactive D3 walkthrough of a pull request. Use when the user wants a zoomable PR map, graph/canvas PR orientation, or alternate visualization of PR system components, data flow, code dependencies, and user actions.

warpdotdev/reproduce-bug-report

Launch Oz cloud agents with computer use to reproduce UI-focused bug reports, capture visual evidence, and report reproduction findings. Use when investigating a specific interactive or visual bug from an issue, ticket, support report, or prompt.

warpdotdev/resolve-merge-conflicts

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.

warpdotdev/respond-to-pr-comments-in-blocklist

Walk users through PR review comments, fetching and displaying them first when needed, collect per-comment response decisions, apply requested fixes, and preview GitHub replies and resolutions before posting. Use when responding to PR review comments on the current branch.

warpdotdev/review-pr

Review a pull request diff and write structured feedback to review.json for the workflow to publish. Use when reviewing a checked-out PR from local artifacts like pr_diff.txt and pr_description.txt and producing machine-readable review output instead of posting directly to GitHub.

warpdotdev/spec-driven-implementation

Drive a spec-first workflow for substantial features by writing PRODUCT.md before implementation, writing TECH.md when warranted, and keeping both specs updated as implementation evolves. Use when starting a significant feature, planning agent-driven implementation, or when the user wants product and tech specs checked into source control.

warpdotdev/update-skill

Create or update skills by generating, editing, or refining SKILL.md files in this repository. Use when authoring new skills or revising the structure, frontmatter, or guidance for existing ones.

warpdotdev/validate-changes-match-specs

Validate that a branch or pull request implementation matches introduced product, technical, security, and related specs. Use when reviewing or finishing a spec-driven change and resolving mismatches between checked-in specs and implementation.

warpdotdev/write-product-spec

Write a PRODUCT.md spec for a significant user-facing feature in Warp, focused on detailed behavior and validation. Use when the user asks for a product spec, desired behavior doc, or PRD, wants to define feature behavior before implementation, or when the feature is substantial or behaviorally ambiguous enough that a written spec would improve implementation or review.

warpdotdev/write-tech-spec

Write a TECH.md spec for a significant Warp feature after researching the current codebase and implementation constraints. Use when the user asks for a technical spec, implementation plan, or architecture doc tied to a product spec.

相關技能