sdd-pr

The `sdd-pr` skill is designed to automate the creation of high-quality pull requests (PRs) by leveraging AI to analyze completed specifications, git history, commit messages, and developer journal entries. It addresses the common challenge of manually writing comprehensive PR descriptions, which can be time-consuming and inconsistent. By aggregating and understanding the context around code changes, this skill ensures that PRs accurately reflect not only what was changed but also why those changes were made, improving communication and code review efficiency within development teams.

This skill offers several core capabilities. It gathers context from multiple sources including spec metadata, file changes, commit history, and technical journal notes. It then performs AI-driven analysis to generate context-aware PR descriptions, highlighting key decisions, technical depth, and maintaining a professional tone. Users are always presented with a draft for review and approval before any PR is created, ensuring full control and the opportunity for revisions. The skill also supports long-running operations, such as test suites or large analyses, with recommended foreground execution and timeouts to maintain stability and prevent output spam.

`sdd-pr` is ideal for developers and teams practicing Spec-Driven Development who want to streamline the PR process, maintain consistent documentation quality, and save time on repetitive tasks. Typical use cases include generating detailed PRs after completing feature specifications, ensuring that complex changes are well-documented for reviewers, and standardizing the quality of PRs across a project. It is particularly valuable for projects where code quality, clarity of technical decisions, and traceability are critical.