spectra-commit

Stage artifact-scoped Spectra changes with per-file confirmation and commit messages.

Updated Nov 24, 2024
One-click install
npx skills add https://github.com/dogwantfly/Nuxt3-training --skill spectra-commit-dogwantfly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spectra-commit
Source: https://github.com/dogwantfly/Nuxt3-training/tree/main/.claude/skills/spectra-commit
Command: npx skills add https://github.com/dogwantfly/Nuxt3-training --skill spectra-commit-dogwantfly

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams manage commits for Spectra changes by ensuring only relevant artifact files (and optionally tracked source files) are included in a change commit, preventing mixed changes and reducing review effort.

Core Features & Use Cases

  • Reads per-change tracking data and collects artifact files under openspec/changes/<name> to prepare focused commits.
  • Displays a commit plan separating Change Artifacts, Source Files, and Unrelated Changes, and requires explicit user confirmation before staging.
  • Supports an optional Archive-then-Commit flow that archives changes, updates the commit set, and regenerates the plan for a clean history.
  • Generates a tailored commit message from the proposal, counts completed tasks, and enforces per-file staging (no git add .).

Quick Start

Describe the Spectra change you want to commit and follow the prompts to stage only the relevant files.

Frequently Asked Questions about spectra-commit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I commit only the relevant change files in a multi-change workflow?

To commit only relevant change files, this Skill reads per-change tracking data and collects artifact files under openspec/changes to prepare focused commits. It displays a plan separating change artifacts, source files, and unrelated changes, requiring explicit confirmation before staging.

How do I prevent mixed changes and unrelated files from entering my git commit history?

Preventing mixed changes in your git commit history is achieved by enforcing per-file staging without git add. This Skill surfaces unrelated changes for awareness and stages only selected artifacts and optional tracked source files, ensuring a clean, reproducible history.

Can I archive Spectra changes before creating a git commit?

Yes, you can archive Spectra changes before committing through an optional Archive-then-Commit flow. This archives changes, updates the commit set, and regenerates the plan to produce a clean, reproducible commit history.

Does this commit workflow generate a git commit message from the change proposal?

Yes, the commit workflow generates a tailored commit message from the proposal. It counts completed tasks and enforces per-file staging to ensure the commit message accurately reflects the specific change artifacts being submitted.

What is the best way to manage artifact-scoped commits for version control?

The best way to manage artifact-scoped commits is using a disciplined workflow that selects relevant files and guides user confirmation. This ensures only change artifacts and optional tracked source files are committed, reducing review effort and maintaining reproducibility.

Why should I avoid git add . when committing version control changes?

You should avoid git add . because it stages all modifications indiscriminately, leading to mixed changes. This Skill enforces per-file staging to precisely select relevant artifact files, preventing unrelated changes from entering the commit history.