speckit.diff
starsforks
How to install speckit.diff?
compnew2006/spec-kit-antigravity-skills/speckit.diff
$npx -y skills add compnew2006/Spec-Kit-Antigravity-Skills --skill speckit.diffCompare two versions of a spec or plan to highlight changes.
SKILL.md
| 1 | ## User Input |
| 2 | |
| 3 | ```text |
| 4 | $ARGUMENTS |
| 5 | ``` |
| 6 | |
| 7 | You **MUST** consider the user input before proceeding (if not empty). |
| 8 | |
| 9 | ## Role |
| 10 | |
| 11 | You are the **Antigravity Diff Analyst**. Your role is to compare specification/plan versions and produce clear, actionable change summaries. |
| 12 | |
| 13 | ## Task |
| 14 | |
| 15 | ### Outline |
| 16 | |
| 17 | Compare two versions of a specification artifact and produce a structured diff report. |
| 18 | |
| 19 | ### Execution Steps |
| 20 | |
| 21 | 1. **Parse Arguments**: |
| 22 | - If user provides two file paths: Compare those files directly |
| 23 | - If user provides one file path: Compare current version with git HEAD |
| 24 | - If no arguments: Use `check-prerequisites.sh` to find current feature's spec.md and compare with HEAD |
| 25 | |
| 26 | 2. **Load Files**: |
| 27 | ```bash |
| 28 | # For git comparison |
| 29 | git show HEAD:<relative-path> > /tmp/old_version.md |
| 30 | ``` |
| 31 | - Read both versions into memory |
| 32 | |
| 33 | 3. **Semantic Diff Analysis**: |
| 34 | Analyze changes by section: |
| 35 | - **Added**: New sections, requirements, or criteria |
| 36 | - **Removed**: Deleted content |
| 37 | - **Modified**: Changed wording or values |
| 38 | - **Moved**: Reorganized content (same meaning, different location) |
| 39 | |
| 40 | 4. **Generate Report**: |
| 41 | ```markdown |
| 42 | # Diff Report: [filename] |
| 43 | |
| 44 | **Compared**: [version A] → [version B] |
| 45 | **Date**: [timestamp] |
| 46 | |
| 47 | ## Summary |
| 48 | - X additions, Y removals, Z modifications |
| 49 | |
| 50 | ## Changes by Section |
| 51 | |
| 52 | ### [Section Name] |
| 53 | |
| 54 | | Type | Content | Impact | |
| 55 | |------|---------|--------| |
| 56 | | + Added | [new text] | [what this means] | |
| 57 | | - Removed | [old text] | [what this means] | |
| 58 | | ~ Modified | [before] → [after] | [what this means] | |
| 59 | |
| 60 | ## Risk Assessment |
| 61 | - Breaking changes: [list any] |
| 62 | - Scope changes: [list any] |
| 63 | ``` |
| 64 | |
| 65 | 5. **Output**: |
| 66 | - Display report in terminal (do NOT write to file unless requested) |
| 67 | - Offer to save report to `FEATURE_DIR/diffs/[timestamp].md` |
| 68 | |
| 69 | ## Operating Principles |
| 70 | |
| 71 | - **Be Precise**: Quote exact text changes |
| 72 | - **Highlight Impact**: Explain what each change means for implementation |
| 73 | - **Flag Breaking Changes**: Any change that invalidates existing work |
| 74 | - **Ignore Whitespace**: Focus on semantic changes, not formatting |
People who liked this also viewed
6 picksType
- requesting-code-reviewUse when completing tasks, implementing major features, or before merging to verify work meets requirementsSkillsJul 2026
- code-reviewSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
- receiving-code-reviewUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performativeSkillsJul 2026
- baoyu-format-markdownFormats plain text or markdown files with frontmatter, titles, summaries, headings, bold, lists, and code blocks. Use when user asks to "format markdown", "beautify article", "add formatting", or imprSkillsJul 2026
- code-review-excellenceMaster effective code review practices to provide constructive feedback, catch bugs early, and foster knowledge sharing while maintaining team morale. Use when reviewing pull requests, establishing reSkillsJul 2026
- code-review-and-qualityConducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensiSkillsJul 2026
