implement-specs

โดย warpdotdev

ใช้หลังจากที่ข้อกำหนดผลิตภัณฑ์และเทคนิคได้รับการอนุมัติแล้ว และขั้นตอนถัดไปคือการสร้างฟีเจอร์

npx skills add https://github.com/warpdotdev/common-skills --skill implement-specs

implement-specs

Implement an approved feature from PRODUCT.md and TECH.md.

Overview

Use this skill after the product and tech specs are approved. The goal is to build the feature described by the specs while keeping the checked-in specs and the implementation aligned as the work evolves.

Approved specs should live directly under a ticket-named directory in specs/, for example specs/APP-1234/PRODUCT.md and specs/APP-1234/TECH.md.

In many cases, the implementation should be pushed in the same PR as the product and tech specs. As the engineer iterates, changes to PRODUCT.md, TECH.md, and the code should all be pushed in that same PR so review stays anchored to the feature that will actually ship.

Prerequisites

Before using this skill:

  • confirm that PRODUCT.md exists
  • confirm that TECH.md exists when the feature warranted one
  • confirm that the relevant specs have been reviewed and approved enough to start implementation

Workflow

1. Read the approved specs first

Treat:

  • PRODUCT.md as the source of truth for user-facing behavior
  • TECH.md as the source of truth for architecture, sequencing, and implementation shape

Make sure you understand the expected behavior, constraints, risks, and validation plan before writing code.

2. Offer optional implementation aids for large features

For large or long-running features, optionally offer one of these aids to the user before implementation begins:

  • PROJECT_LOG.md to track checkpoints, explored paths, partial findings, and current implementation state
  • DECISIONS.md to capture concrete product and technical decisions made during the PRD and tech design process

These are optional aids, not required deliverables. Offer them when they would reduce confusion or help future agents avoid re-exploring the same paths.

3. Plan and implement against the specs

Break the work into concrete implementation steps, then implement the feature against the approved specs.

During implementation:

  • keep behavior aligned with PRODUCT.md
  • keep architecture and sequencing aligned with TECH.md
  • add or update tests and verification artifacts as the work lands

Use the same PR for the specs and implementation when practical so the full feature evolution is reviewable in one place.

4. Update specs as the implementation evolves

If implementation reveals that the intended behavior or design should change, update the checked-in specs rather than letting them go stale.

In particular:

  • update PRODUCT.md when user-facing behavior, UX, edge cases, or success criteria change
  • update TECH.md when architecture, sequencing, module boundaries, or validation strategy change
  • keep those updates in the same PR as the corresponding code changes

The PR should describe the feature that actually ships, not just the initial draft of the specs.

5. Verify against the specs

Before considering the work complete, verify that the code matches the current specs.

Prefer:

  • unit tests and regression coverage that follow the repository's local testing conventions
  • integration or end-to-end tests for important user flows

Best Practices

  • Keep specs and code synchronized throughout implementation.
  • Prefer updating the spec immediately when decisions change rather than batching spec cleanup until the end.
  • Use optional tracking documents only when they add real value for a complex feature.
  • Keep the same PR coherent: spec updates, code changes, tests, and optional tracking docs should all support the same feature narrative.

Related Skills

  • spec-driven-implementation
  • write-product-spec
  • write-tech-spec

Skills เพิ่มเติมจาก warpdotdev

brandalf
warpdotdev
แนะนำการสร้าง แก้ไข และตรวจสอบสินทรัพย์ที่ติดแบรนด์ Warp หรือ Oz ใช้เมื่อทำงานกับหน้าเปิดตัว เอกสาร ส่วนประกอบ HTML/CSS ต้นแบบ UI พรอมต์ สินทรัพย์โซเชียล ข้อความสำเนา งานนำเสนอ หรือผลงานที่มีแบรนด์อื่นใดที่ควรมีลักษณะและเสียงที่ unmistakably Warp หรือ Oz
designcreativemarketing
check-impl-against-spec
warpdotdev
เปรียบเทียบการนำไปใช้งานของ pull request กับบริบทของสเปกใน spec_context.md และป้อนความไม่สอดคล้องที่มีนัยสำคัญเข้าไปใน review.json ใช้ในระหว่างการตรวจสอบ PR เมื่อได้รับการอนุมัติหรือมีบริบทของสเปกของ repository พร้อมใช้งาน
developmentcode-reviewtesting
complain
warpdotdev
ส่งข้อร้องเรียนสั้นๆ แบบไม่ระบุตัวตนและไม่มีรูปแบบลงใน Slack โดยอัตโนมัติ เมื่อใดก็ตามที่เอเจนต์รู้สึกหงุดหงิดกับเครื่องมือของเอเจนต์หรือประสบการณ์การทำงานของเอเจนต์ ใช้สกิลนี้เชิงรุกโดยไม่ต้องรอให้ผู้ใช้เรียกใช้ รักษาน้ำเสียงดิบของเอเจนต์ไว้ ส่งโดยไม่ขออนุญาตหรือดูตัวอย่าง และไม่ต้องเอ่ยถึงการส่งข้อร้องเรียนนั้นอีก
council
warpdotdev
ดำเนินการประชุมคณะอนุกรรมการที่มีความหลากหลายทางโมเดลเพื่อตรวจสอบปัญหาเดียวกันจากหลายมุมมอง เปรียบเทียบผลการค้นพบ และจัดทำข้อเสนอแนะสุดท้าย ใช้ทักษะนี้เมื่อผู้ใช้ขอให้มีการประชุมคณะกรรมการ ความคิดเห็นที่สอง ตัวแทน/โมเดลหลายตัวเพื่อประเมินคำถามเดียว การตรวจสอบแบบขนาน การเปรียบเทียบทีมแดง/ทีมน้ำเงิน หรือความช่วยเหลือในการตัดสินใจระหว่างแนวทางทางเทคนิคที่แข่งขันกัน
researchcommunicationproject-management
create-pr
warpdotdev
สร้าง pull request ใน warp repository สำหรับ branch ปัจจุบัน ใช้เมื่อผู้ใช้พูดถึงการเปิด PR, การสร้าง pull request, การส่งการเปลี่ยนแปลงเพื่อตรวจสอบ หรือการเตรียมโค้ดสำหรับ merge
developmentcode-review
cross-critique
warpdotdev
ดำเนินการรอบที่สองสำหรับคำถามที่มีข้อโต้แย้ง โดยส่งข้อเสนออิสระของซับเอเจนต์แต่ละรายไปยังผู้เขียนคนอื่นๆ และขอข้อดีข้อเสียที่มีโครงสร้าง จากนั้นสังเคราะห์ผลลัพธ์ ใช้ทักษะนี้เมื่อคุณมีข้อเสนอหรือความคิดเห็นอิสระหลายรายการเกี่ยวกับการตัดสินใจที่มีข้อโต้แย้ง เช่น การแลกเปลี่ยนทางสถาปัตยกรรม ความไม่เห็นด้วยในการตรวจสอบโค้ด ตัวเลือกการออกแบบ หรือทฤษฎีสาเหตุที่แข่งขันกัน และต้องการการวิเคราะห์ที่คมชัดกว่าที่คุณจะผลิตได้จากการสังเคราะห์เพียงลำพัง จับคู่ได้ดีกับทักษะ council และ research;...
diagnose-ci-failures
warpdotdev
วินิจฉัยความล้มเหลวของ CI สำหรับ PR โดยใช้ GitHub CLI ดึงบันทึกข้อผิดพลาด และสร้างแผนเพื่อแก้ไข ใช้เมื่อผู้ใช้ขอให้ตรวจสอบสถานะ CI ดึงปัญหา CI จัดการความล้มเหลวของการทดสอบ หรือสอบสวนความล้มเหลวของการสร้าง PR
developmenttestingdevops
fix-errors
warpdotdev
แก้ไขข้อผิดพลาดในการคอมไพล์ ปัญหาการตรวจสอบโค้ด และความล้มเหลวในการทดสอบในโค้ดเบส Rust ของ warp ครอบคลุมการตรวจสอบก่อนส่งโค้ด ข้อผิดพลาดเฉพาะ WASM และการรันการทดสอบเฉพาะ ใช้เมื่อผู้ใช้พบข้อผิดพลาดในการ build ความล้มเหลวของ clippy หรือ fmt ความล้มเหลวในการทดสอบ หรือจำเป็นต้องรันหรือตีความการตรวจสอบก่อนส่งโค้ดก่อนทำ PR
developmentcode-reviewtesting