check-impl-against-spec

作成者: warpdotdev

プルリクエストの実装をspec_context.md内の仕様コンテキストと比較し、重要な不一致があればreview.jsonにフィードバックします。承認済みまたはリポジトリの仕様コンテキストが利用可能な場合、PRレビュー時に使用します。

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のその他のスキル

brandalf
warpdotdev
WarpまたはOzブランドのアセットの作成、改訂、レビューをガイドします。ランディングページ、ドキュメント、HTML/CSSコンポーネント、UIモックアップ、プロンプト、ソーシャルアセット、コピー、プレゼンテーション、その他WarpまたはOzと明確にわかるブランド成果物に使用します。
designcreativemarketing
complain
warpdotdev
エージェントがエージェントツールやエージェント作業の体験にフラストレーションを感じたとき、匿名で短く、完全に構造化されていない苦情をSlackに自動的に放り込む。ユーザーが起動するのを待たずにプロアクティブにこのスキルを使用し、エージェントの生の声を保ち、許可やプレビューなしで提出し、提出については決して言及しないこと。
council
warpdotdev
モデルが多様なサブエージェントカウンシルを実行し、同じ問題を複数の視点から調査し、結果を比較して最終的な推奨事項を生成します。ユーザーがカウンシル、セカンドオピニオン、一つの質問を評価するための複数のエージェント/モデル、並行調査、レッドチーム/ブルーチームの比較、または競合する技術的アプローチの選択の支援を求めた場合に、このスキルを使用してください。
researchcommunicationproject-management
create-pr
warpdotdev
現在のブランチに対してwarpリポジトリにプルリクエストを作成します。ユーザーがPRを開く、プルリクエストを作成する、レビューのために変更を提出する、またはマージのためにコードを準備することを言及した場合に使用します。
developmentcode-review
cross-critique
warpdotdev
争点のある質問について、各サブエージェントの独立した提案を他の作成者に回覧し、構造化された賛否を求めてから統合する、第二ラウンドを実行します。このスキルは、複数の独立した提案や意見がある場合——アーキテクチャのトレードオフ、コードレビューの意見の相違、設計上の選択、競合する根本原因の理論など——に、単独で統合するよりも鋭い分析を得たいときに使用します。councilスキルやresearchスキルと自然に組み合わせられます。...
diagnose-ci-failures
warpdotdev
PRのCI障害を診断し、GitHub CLIを使ってエラーログを抽出し、修正計画を生成します。ユーザーがCIステータスの確認、CI問題の取得、テスト失敗のトリアージ、またはPRビルド障害の調査を依頼した場合に使用します。
developmenttestingdevops
fix-errors
warpdotdev
Warp Rustコードベースのコンパイルエラー、リンティング問題、テスト失敗を修正します。presubmitチェック、WASM固有のエラー、特定のテストの実行をカバーします。ユーザーがビルドエラー、clippyやfmtの失敗、テスト失敗に遭遇した場合、またはPR前にpresubmitを実行・解釈する必要がある場合に使用します。
developmentcode-reviewtesting
implement-specs
warpdotdev
承認されたPRODUCT.mdとTECH.mdの機能を実装し、実装の進化に合わせて仕様とコードを同じPR内で整合させます。プロダクトと技術仕様が承認され、次のステップが機能の構築である場合に使用します。
developmentcode-reviewapi