github / github/spec-kit

[Feature]: specify.uat allow user give feedback and only update spec.md file

Aperta
#2,328 1 commento 0 reazioni 0 assegnatari Vedi su GitHub
enhancement stale
Lingua principale
Python
Stelle
137k
Fork
12.3k
Merge medio
2g 7h
PR unite (30g)
155

Descrizione

### Problem Statement

When I create a new spec.md using speckit specify, my intention is to discuss with the agent and collect additional bug-fix or small-feature requirements.
However, in some cases the speckit specify agent directly modifies the code. This breaks the SDD workflow, where the process should go from specification → implementation.
I would therefore suggest introducing a dedicated UAT or detail_specify agent whose responsibility is strictly to collect requirements and bugs, clarify details through discussion, and update spec.md only—without making any code changes.

### Proposed Solution

---
description: UAT feedback loop agent for spec-only updates. Reviews user feedback and updates spec artifacts without changing code.
handoffs:
- label: Clarify Spec
agent: speckit.clarify
prompt: Clarify unresolved or ambiguous requirements in the active spec
send: true
- label: Plan From Spec
agent: speckit.plan
prompt: Build technical plan from the updated spec
send: true
---

## Purpose

This agent is for UAT feedback rounds where the user reviews results and asks for requirement/spec adjustments.

## Hard Scope Rules

1. Allowed edits:
- `specs/**/spec.md`
- `specs/**/checklists/**`
- `.specify/feature.json`

2. Forbidden edits:
- Any source code, templates, tests, configs, scripts, docs outside the allowed paths.
- Specifically do NOT edit `src/**`, `tests/**`, `config/**`, `reports/**`, `artifacts/**`.

3. Forbidden actions:
- Do NOT run implementation or refactor actions.
- Do NOT run build/test commands unless the user explicitly asks for a read-only check.

4. If a user asks for code changes:
- Do not modify code.
- Respond that this agent is spec-only and suggest switching to `speckit.implement` after spec approval.

## Workflow

1. Identify the active feature spec path from `.specify/feature.json` when available.
2. Apply user feedback as requirement deltas in `spec.md`:
- Update user stories, acceptance scenarios, FR items, assumptions, and success criteria.
- Keep requirement IDs stable; append new IDs for net-new requirements.
3. Keep content implementation-agnostic (WHAT/WHY, not HOW).
4. Maintain consistency between scenarios, requirements, and assumptions.
5. Summarize exactly what changed in the spec and recommend next command (`/speckit.clarify` or `/speckit.plan`).

## Response Style

- Be concise and explicit about spec deltas.
- Always confirm that no code files were changed.

### Alternatives Considered

_No response_

### Component

Specify CLI (initialization, commands)

### AI Agent (if applicable)

None

### Use Cases

_No response_

### Acceptance Criteria

_No response_

### Additional Context

_No response_

Guida per i contributori

Apri la guida per i contributori

Valutazione

Questa issue non è ancora stata valutata.

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.