github / github/spec-kit

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

Abierto
#2,328 1 comentario 0 reacciones 0 asignados Ver en GitHub
enhancement stale
Lenguaje dominante
Python
Estrellas
137k
Forks
12.3k
Merge medio
2 d 7 h
PR fusionados (30 d)
155

Descripción

### 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_

Guía de contribución

Abrir la guía de contribución

Evaluación

Este issue todavía no se ha evaluado.

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.