story-implement

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill: Implementar historia de usuario

Skill: 实现用户故事

Guia para ejecutar en codigo el trabajo especificado en historias

US-XXX

y tareas

TK-XXX

bajo

docs/specs/user-stories/

Alcance: consume especificaciones ya redactadas por story-plan. No reescribe ni reestructura tareas - solo las implementa. Correcciones menores acordadas con el usuario son la unica excepcion.
Ritmo obligatorio - una tarea por confirmacion: implementar una TK, actualizar
progress.md
, ejecutar lint, y esperar confirmacion explicita del usuario antes de arrancar la siguiente. Sin excepcion.
Solo implementacion: no modifica documentacion de producto (
README.md
de US,
TK-XXX
, ADRs, technical-docs) - solo
progress.md
. Si se detecta un conflicto en la documentacion que pueda afectar el resultado, parar inmediatamente y notificar al usuario antes de continuar.
Handoffs: Entrada minima: US y TK en
Ready
; salida:
progress.md
en
Done
y working tree limpio => story-integrate
.

本指南用于指导编码实现

docs/specs/user-stories/

路径下

US-XXX

用户故事和

TK-XXX

任务中指定的工作。

范围： 仅使用由story-plan编写完成的规范。不得重写或重构任务，仅可进行实现。经用户同意的微小修正为唯一例外。
强制节奏 - 每项任务需确认： 实现一个TK，更新
progress.md
，执行lint检查，等待用户明确确认后再开始下一项任务，无例外。
仅负责实现： 不得修改产品文档（US的
README.md
、
TK-XXX
文档、ADRs、technical-docs），仅可修改
progress.md
。若发现文档中存在可能影响结果的冲突，立即停止并通知用户后再继续。
交接要求： 最低输入条件：处于
Ready
状态的US和TK；输出条件：
progress.md
标记为
Done
且工作树干净 => 移交至**
story-integrate
**。

Agentes condicionales

条件代理

Condicion	Agente / Skill requerido
La tarea genera o modifica archivos de UI (HTML, CSS, componentes)	Ejecutar bajo el agente `ui-specialist`
La referencia de diseno es un enlace o archivo de Figma	Usar el MCP de Figma para obtener el contexto del diseno antes y durante la implementacion
Fase final de pruebas (Paso 4) aceptada por el usuario	Ejecutar bajo el agente `quality-specialist` - no escribir tests desde este skill

Ambas condiciones pueden aplicar a la vez. Si la tarea no involucra UI, implementar directamente sin delegar.

条件	所需代理/Skill
任务生成或修改UI文件（HTML、CSS、组件）	在 `ui-specialist` 代理下执行
设计参考为Figma链接或文件	在实现前及实现过程中，使用Figma MCP获取设计上下文
用户已接受最终测试阶段（步骤4）	在 `quality-specialist` 代理下执行 - 不得从此Skill编写测试用例

两个条件可同时适用。若任务不涉及UI，则直接实现无需委托。

Ubicacion de archivos

文件位置

Artefacto	Ruta
Historia de usuario	`docs/specs/user-stories/US-XXX-[nombre-corto]/README.md`
Tareas	`docs/specs/user-stories/US-XXX-[nombre-corto]/TK-XXX-[nombre].md`
Progreso	`docs/specs/user-stories/US-XXX-[nombre-corto]/progress.md`
Unidades de trabajo	`docs/specs/work-units.md`
Glosario	`docs/specs/glossary.md`

工件	路径
用户故事	`docs/specs/user-stories/US-XXX-[短名称]/README.md`
任务	`docs/specs/user-stories/US-XXX-[短名称]/TK-XXX-[名称].md`
进度	`docs/specs/user-stories/US-XXX-[短名称]/progress.md`
工作单元	`docs/specs/work-units.md`
术语表	`docs/specs/glossary.md`

Informacion requerida antes de implementar

实现前需获取的信息

Dato	Como obtenerlo	Si no esta disponible
US padre	Indicada por el usuario o inferida de la ruta	Preguntar a que `US-XXX` pertenece; no implementar hasta tenerla
Alcance	Del mensaje del usuario: toda la US, una lista de TK, o un TK concreto	Preguntar si hay ambiguedad
Unidad de trabajo	Campo `Unidad de trabajo` de cada TK; complementar con `work-units.md` si no es claro	Preguntar al usuario; no asumir
Working tree limpio	`git status --porcelain`	Si hay cambios pendientes no resueltos: parar y avisar al usuario
Rama de la US	`feature/US-XXX-[nombre-corto]`	Crear con `git checkout -b feature/US-XXX-[nombre-corto]` desde la rama base acordada
Usuario asignado	Campo `Asignado a` del TK; si no: `git config user.name`	Aplicar como filtro salvo instruccion explicita del usuario

Si el usuario indica una lista concreta de TK, un implementador distinto o pide implementar sin filtro, esa instruccion explicita prevalece sobre los filtros automaticos.

数据	获取方式	若不可用
父US	用户指定或从路径推断	询问该任务所属的 `US-XXX` ；获取前不得开始实现
范围	用户消息：整个US、TK列表或单个具体TK	若存在歧义则询问用户
工作单元	每个TK的 `工作单元` 字段；若不明确则参考 `work-units.md`	询问用户；不得自行假设
工作树干净	执行 `git status --porcelain`	若存在未解决的待提交变更：停止并通知用户
US分支	`feature/US-XXX-[短名称]`	从约定的基准分支执行 `git checkout -b feature/US-XXX-[短名称]` 创建分支
分配用户	TK的 `分配给` 字段；若未指定则使用 `git config user.name`	除非用户明确指示，否则以此为过滤条件

若用户指定了具体的TK列表、不同的实现人员或要求跳过过滤，则该明确指示优先于自动过滤规则。

Validacion antes de implementar

实现前验证

Verificar las siguientes condiciones. Si alguna falla, parar - informar al usuario y resolver primero.

Working tree limpio:
```
git status --porcelain
```
sin cambios pendientes no resueltos.
Rama correcta: estar en
```
feature/US-XXX-[nombre-corto]
```
(o crearla). No implementar en
```
main
```
ni en ramas de otras historias sin instruccion explicita.
US padre con README.md: la carpeta de la US existe, tiene
```
README.md
```
con metadato
```
Estado: Ready
```
.
TK en estado Ready: solo encolar tareas con
```
Estado: Ready
```
. Las
```
Draft
```
o
```
Done
```
en
```
progress.md
```
no son ejecutables por defecto.
Solapamiento de progreso: leer
```
progress.md
```
si existe; respetar tareas ya en
```
Done
```
; si hay alguna
```
In Progress
```
, revisar notas y estado real antes de continuar.

Si hay conflicto:

WARNING No es posible continuar:
- <razon concreta>

验证以下条件。若任一条件不满足，停止执行 - 通知用户并先解决问题。

工作树干净：
```
git status --porcelain
```
无未解决的待提交变更。
正确分支： 当前处于
```
feature/US-XXX-[短名称]
```
分支（或已创建该分支）。无明确指示的情况下，不得在
```
main
```
或其他用户故事分支上实现。
父US存在README.md： US文件夹存在，且包含带有
```
状态: Ready
```
元数据的
```
README.md
```
。
TK处于Ready状态： 仅将状态为
```
Ready
```
的任务加入执行队列。
```
progress.md
```
中标记为
```
Draft
```
或
```
Done
```
的任务默认不可执行。
进度重叠： 若
```
progress.md
```
存在则读取该文件；尊重已标记为
```
Done
```
的任务；若存在
```
In Progress
```
的任务，需先查看备注和实际状态再继续。

若存在冲突：

WARNING 无法继续执行：
- <具体原因>

Flujo de implementacion

实现流程

Paso 1 - Preparar repositorio y rama

步骤1 - 准备仓库与分支

Verificar working tree limpio; si no, parar y avisar.
Resolver nombre de rama:
```
feature/US-XXX-[nombre-corto]
```
(el segmento tras
```
feature/
```
debe coincidir con la carpeta de la US).

git checkout feature/US-XXX-[nombre-corto]

si la rama existe; si no,

git checkout -b feature/US-XXX-[nombre-corto]

desde la rama base acordada con el usuario (no asumir

main

develop

Leer o crear
```
progress.md
```
(desde
```
assets/progress-template.md
```
si no existe). Al crearlo, anadir una entrada por cada TK del alcance acordado con
```
Estado: Pending
```
salvo las ya
```
Done
```
.

验证工作树是否干净；若否，停止并通知用户。
确定分支名称：
```
feature/US-XXX-[短名称]
```
（
```
feature/
```
后的部分需与US文件夹名称一致）。
若分支已存在则执行
```
git checkout feature/US-XXX-[短名称]
```
；若不存在则从与用户约定的基准分支执行
```
git checkout -b feature/US-XXX-[短名称]
```
（不得默认使用
```
main
```
/
```
develop
```
）。
读取或创建
```
progress.md
```
（若不存在则从
```
assets/progress-template.md
```
生成）。创建时，为每个约定范围内的TK添加一条**状态为
```
Pending
```
**的记录，已标记为
```
Done
```
的任务除外。

Paso 2 - Filtrar y presentar cola

步骤2 - 过滤并展示执行队列

Leer
```
README.md
```
de la US y todos los
```
TK-*.md
```
del alcance indicado.
Consultar
```
docs/specs/work-units.md
```
si el alcance de alguna unidad no es claro.
Construir dos listas:
- Implementables: TK con
```
Estado: Ready
```
  que pasen los filtros de unidad y usuario asignado, no marcadas como
```
Done
```
  en
```
progress.md
```
  .
- Excluidas: el resto, con su estado entre parentesis - p. ej.
```
TK-002 - Ajuste de permisos (Draft)
```
  ,
```
TK-004 - Exportacion CSV (Done)
```
  .
Mostrar ambas listas al usuario en orden numerico. No ejecutar codigo en este turno.
Preguntar explicitamente si se desea continuar y esperar confirmacion antes de implementar.

读取US的
```
README.md
```
及指定范围内的所有
```
TK-*.md
```
文件。
若任一工作单元的范围不明确，参考
```
docs/specs/work-units.md
```
。
构建两个列表：
- 可实现任务： 状态为
```
Ready
```
  、符合工作单元和分配用户过滤规则、且未在
```
progress.md
```
  中标记为
```
Done
```
  的TK。
- 排除任务： 其余任务，标注其状态 - 例如
```
TK-002 - 权限调整 (Draft)
```
  、
```
TK-004 - CSV导出 (Done)
```
  。
按数字顺序向用户展示两个列表。此阶段不得执行代码。
明确询问用户是否希望继续，并等待确认后再开始实现。

Paso 3 - Implementar tarea a tarea

步骤3 - 逐项实现任务

IMPORTANTE Regla de oro - una TK por turno: implementar exactamente una tarea por turno. Al terminar cada TK, detenerse y preguntar al usuario si desea continuar con la siguiente. No avanzar sin confirmacion explicita. Esta regla no tiene excepciones, aunque el usuario haya aprobado la cola completa en el Paso 2.

Por cada tarea aprobada, en orden numerico salvo dependencias obvias en el texto:

Implementar segun la especificacion del TK.
Si la tarea genera o modifica archivos de UI: ejecutar bajo el agente
```
ui-specialist
```
. Si ademas la referencia de diseno es Figma: usar el MCP de Figma.
Al terminar, ejecutar lint, typecheck o build del paquete afectado. Si falla, corregir antes de continuar. No ejecutar suites de tests en esta fase.
Actualizar
```
progress.md
```
:
```
Pending
```
=>
```
In Progress
```
=>
```
Done
```
; anadir notas si quedan aspectos parciales. Registrar en
```
Decisiones adicionales
```
toda decision tomada durante la sesion de chat que no este ya documentada en el TK — cambios de enfoque, alternativas descartadas, restricciones descubiertas, acuerdos con el usuario. Si no hubo decisiones nuevas, omitir la seccion.
Detenerse y preguntar al usuario (con herramienta de preguntas estructuradas):
- Mensaje: "TK-XXX completada. Continuo con TK-YYY - [titulo]?"
- Opciones: [Si, continuar] / [No, detener aqui]
Esperar respuesta. Solo si el usuario confirma: pasar a la siguiente TK. Si detiene, registrar nota en
```
progress.md
```
y pasar al Paso 4.

重要 黄金规则 - 每次仅处理一个TK： 每次仅实现一个任务。完成每个TK后，停止并询问用户是否继续下一个任务。即使用户在步骤2中已批准整个队列，也不得在无明确确认的情况下推进。此规则无例外。

对于每个已批准的任务，按数字顺序执行（除非任务文本中存在明显依赖关系）：

根据TK的规范进行实现。
若任务生成或修改UI文件：在
```
ui-specialist
```
代理下执行。若同时存在Figma设计参考：使用Figma MCP。
完成后，对受影响的包执行lint、类型检查或构建。若失败，先修正再继续。此阶段不得执行测试套件。
更新
```
progress.md
```
：将状态从
```
Pending
```
=>
```
In Progress
```
=>
```
Done
```
；若存在未完成的部分则添加备注。在
```
额外决策
```
部分记录本次会话中做出的所有未在TK文档中记录的决策——方法变更、排除的替代方案、发现的限制、与用户达成的协议。若无新决策则省略该部分。
停止并询问用户（使用结构化提问工具）：
- 消息：“TK-XXX已完成。是否继续执行TK-YYY - [标题]？”
- 选项：[是，继续] / [否，在此停止]
等待回复。仅当用户确认时才进入下一个TK。若用户要求停止，则在
```
progress.md
```
中添加备注并进入步骤4。

Paso 4 - Cierre

步骤4 - 收尾

Cuando no queden tareas pendientes (o el usuario detenga la ejecucion), ofrecer la fase de pruebas: delegar a quality-specialist
para escribir tests basados en los
```
SC-XX
```
y
```
BR-XX
```
del
```
README.md
```
.
Si el usuario acepta: invocar quality-specialist
con el contexto de la US, la rama
```
feature/US-XXX-*
```
y los TK en
```
Done
```
. No escribir tests desde este skill.
Si el usuario rechaza: registrar nota en
```
progress.md
```
.
Handoff: si todo el alcance esta en
```
Done
```
, working tree limpio y commits hechos (
```
git-commit
```
), sugerir: (1) git-pr
si el equipo revisa por PR; (2) story-integrate
para merge local. Si quedan TK en
```
Pending
```
/
```
In Progress
```
, indicar que falta cerrar.

当无待处理任务（或用户停止执行）时，提供测试阶段选项：委托**
```
quality-specialist
```
**根据
```
README.md
```
中的
```
SC-XX
```
和
```
BR-XX
```
编写测试用例。
若用户同意：将US上下文、
```
feature/US-XXX-*
```
分支及已完成的TK信息传递给**
```
quality-specialist
```
**。不得从此Skill编写测试用例。
若用户拒绝：在
```
progress.md
```
中添加备注。
交接： 若所有范围内的任务均标记为
```
Done
```
、工作树干净且已提交变更（执行
```
git-commit
```
），则建议：(1) 若团队采用PR评审则执行**
```
git-pr
```
；(2) 执行
```
story-integrate
```
**进行本地合并。若仍有TK处于
```
Pending
```
/
```
In Progress
```
状态，则需提示完成剩余任务。

Flujo: TK indicada sin US explicita

流程：未明确指定US的TK

TK-XXX

siempre vive bajo la carpeta de una US. Si el usuario indica solo el numero de tarea sin mencionar la US:

Preguntar a que
```
US-XXX
```
pertenece antes de continuar.

Una vez recibida la US, validar que el archivo

TK-XXX-[nombre].md

existe dentro de

docs/specs/user-stories/US-XXX-[nombre-corto]/

Si la tarea no pertenece a esa US o el archivo no se encuentra, parar e informar:

WARNING No es posible continuar con la implementacion:
- TK-XXX no pertenece a US-XXX o no se encontro en su carpeta.
- Motivo: <archivo no encontrado / TK en carpeta de otra US>
- Verificar el numero de tarea y la historia indicada antes de continuar.

No implementar hasta que la relacion TK => US este confirmada.

每个

TK-XXX

始终隶属于某个US的文件夹。若用户仅指定任务编号未提及所属US：

询问该TK所属的
```
US-XXX
```
后再继续。

获取US信息后，验证

docs/specs/user-stories/US-XXX-[短名称]/

路径下是否存在

TK-XXX-[名称].md

文件。

若任务不属于该US或未找到文件，停止执行并通知用户：

WARNING 无法继续实现：
- TK-XXX不属于US-XXX或未在其文件夹中找到。
- 原因：<文件未找到 / TK位于其他US文件夹中>
- 请先确认任务编号及指定的用户故事后再继续。

不得在TK与US的归属关系确认前开始实现。

Checklist antes de implementar

实现前检查清单

Repositorio:

Working tree limpio (
```
git status --porcelain
```
sin cambios pendientes)
Rama
```
feature/US-XXX-[nombre-corto]
```
activa o creada
```
progress.md
```
leido o creado

Cola:

```
README.md
```
de la US leido
Todos los
```
TK-*.md
```
del alcance leidos
```
work-units.md
```
consultado si algun alcance de unidad no era claro
Lista de implementables y excluidas presentada al usuario
Confirmacion del usuario recibida antes del primer cambio de codigo

Por cada tarea:

TK con
```
Estado: Ready
```
No marcada como
```
Done
```
en
```
progress.md
```
Si la tarea genera o modifica UI: ejecutado bajo
```
ui-specialist
```
Si la referencia de diseno es Figma: MCP de Figma usado
Lint/build ejecutado tras la implementacion
```
progress.md
```
actualizado a
```
Done
```
Decisiones tomadas en la sesion registradas en
```
Decisiones adicionales
```
del TK en
```
progress.md
```
Confirmacion explicita del usuario recibida antes de pasar a la siguiente TK

Cierre (fase de pruebas):

Usuario preguntado sobre fase final de pruebas
Si acepta: tests delegados a quality-specialist
, no escritos desde este skill

仓库：

工作树干净（
```
git status --porcelain
```
无待提交变更）
```
feature/US-XXX-[短名称]
```
分支已激活或已创建
已读取或创建
```
progress.md
```

队列：

已读取US的
```
README.md
```
已读取指定范围内的所有
```
TK-*.md
```
文件
若工作单元范围不明确已参考
```
work-units.md
```
已向用户展示可实现任务和排除任务列表
已在首次代码变更前获取用户确认

每项任务：

TK处于
```
Ready
```
状态
未在
```
progress.md
```
中标记为
```
Done
```
若涉及UI生成或修改：已在
```
ui-specialist
```
代理下执行
若存在Figma设计参考：已使用Figma MCP
实现后已执行lint/构建
```
progress.md
```
已更新为
```
Done
```
状态
会话中做出的决策已记录在
```
progress.md
```
的TK
```
额外决策
```
部分
进入下一个TK前已获取用户明确确认

收尾（测试阶段）：

已询问用户是否进入最终测试阶段
若用户同意：测试已委托给**
```
quality-specialist
```
**，未从此Skill编写测试用例

Ejemplos

示例

Ejemplo 1 - US completa con filtro de unidad

Entrada: "Implementa lo Ready de la US-042; estoy en el paquete
```
@acme/web-app
```
."
Salida: Rama limpia y checkout a
```
feature/US-042-[nombre-corto]
```
; mensaje con TK Ready en cola y excluidas; tras confirmacion del usuario, implementa solo la primera TK Ready, ejecuta lint/build, actualiza
```
progress.md
```
, y pausa para preguntar si continuar con la siguiente.

Ejemplo 2 - TK indicada sin US

Entrada: "Implementa TK-003."
Comportamiento: Preguntar a que
```
US-XXX
```
pertenece. Validar que el archivo existe. Si existe, continuar con el flujo normal. Si no, parar con mensaje de error.

Ejemplo 3 - TK en Draft

Entrada: "Ejecuta TK-005 de la US-042" y TK-005 esta en Draft.
Salida: Lista de excluidas:
```
TK-005 - ... (Draft)
```
. No implementa TK-005 hasta que este en Ready.

Ejemplo 4 - Confirmacion entre tareas (caso clave)

Entrada: Hay tres TK Ready aprobadas en la cola.
Comportamiento: Implementa TK-001, actualiza
```
progress.md
```
, ejecuta lint. Luego pausa y pregunta con opciones tappables: "TK-001 completada. Continuo con TK-002 - [titulo]?" [Si, continuar] / [No, detener aqui]. No avanza sin respuesta afirmativa. Mismo ciclo tras TK-002 antes de TK-003.

Ejemplo 5 - Usuario pide "implementar todo de corrido"

Entrada: "Implementa todas las tareas de una vez sin preguntar."
Comportamiento: Informar que el skill opera con una tarea por confirmacion y que no es posible omitir las pausas entre tareas. Explicar el beneficio: detectar errores temprano y mantener control del alcance. Ofrecer continuar con el flujo estandar.

示例1 - 带工作单元过滤的完整US

输入： “实现US-042中处于Ready状态的任务；我在
```
@acme/web-app
```
包中。”
输出： 确保分支干净并切换至
```
feature/US-042-[短名称]
```
；向用户发送包含Ready状态TK队列和排除任务的消息；获取用户确认后，实现第一个Ready状态TK，执行lint/构建，更新
```
progress.md
```
，并暂停询问是否继续下一个任务。

示例2 - 未指定US的TK

输入： “实现TK-003。”
行为： 询问该TK所属的
```
US-XXX
```
。验证文件是否存在。若存在则按正常流程继续。若不存在则停止并发送错误消息。

示例3 - 处于Draft状态的TK

输入： “执行US-042的TK-005”且TK-005处于Draft状态。
输出： 排除任务列表：
```
TK-005 - ... (Draft)
```
。在TK状态变为Ready前不得实现。

示例4 - 任务间确认（关键场景）

输入： 队列中有三个已批准的Ready状态TK。
行为： 实现TK-001，更新
```
progress.md
```
，执行lint。然后暂停并通过可点击选项提问：“TK-001已完成。是否继续执行TK-002 - [标题]？” [是，继续] / [否，在此停止]。无肯定回复不得推进。完成TK-002后重复该流程再处理TK-003。

示例5 - 用户要求“一次性实现所有任务”

输入： “一次性实现所有任务，不要询问。”
行为： 告知用户此Skill遵循每项任务需确认的规则，无法跳过任务间的暂停。解释此规则的好处：及早发现错误并保持范围可控。建议按标准流程继续。

Anti-patterns

反模式

Implementar mas de una TK por turno sin confirmacion intermedia del usuario.
Codificar con working tree sucio sin avisar y pausar.
Implementar en
```
main
```
u otra rama que no sea
```
feature/US-XXX-[nombre-corto]
```
sin instruccion explicita.
Omitir el mensaje de cola y confirmacion e ir directo al codigo.
Tratar tareas en Draft como ejecutables por defecto.
Arrancar la siguiente TK sin confirmacion explicita (aunque el usuario haya aprobado la cola completa en el Paso 2).
Ejecutar suites de tests durante el ciclo de tareas sin que el usuario haya aceptado la fase final.
Escribir tests en la fase final sin delegar a quality-specialist
.
Ignorar
```
progress.md
```
o usar identificadores distintos a
```
TK-XXX
```
.
Omitir la seccion
```
Decisiones adicionales
```
cuando durante la sesion se tomaron decisiones no documentadas en el TK.
Implementar archivos de UI sin usar el agente
```
ui-specialist
```
.
Implementar UI con referencia Figma sin usar el MCP de Figma.
Modificar
```
README.md
```
de la US, archivos
```
TK-XXX
```
, ADRs o
```
technical-docs/
```
durante la implementacion.
Continuar cuando se detecta un conflicto en la documentacion sin notificar al usuario primero.
Escribir
```
Skipped
```
u otro estado no definido en
```
progress.md
```
; estados validos:
```
Pending
```
,
```
In Progress
```
,
```
Done
```
.
Lanzar preguntas como prosa libre cuando el cliente expone herramienta de preguntas estructuradas.
Aceptar como confirmacion una respuesta ambigua ("ok", "dale") sin opciones explicitas; si hay duda, repreguntar.

无中间用户确认的情况下，一次实现多个TK。
工作树未清理时未通知用户就直接编码。
无明确指示的情况下，在
```
main
```
或非
```
feature/US-XXX-[短名称]
```
分支上实现。
跳过队列展示和确认步骤直接编写代码。
默认将Draft状态的任务视为可执行。
无明确确认的情况下开始下一个TK（即使用户已在步骤2中批准整个队列）。
用户未接受最终测试阶段时就在任务周期内执行测试套件。
在最终测试阶段未委托给**
```
quality-specialist
```
**就自行编写测试用例。
忽略
```
progress.md
```
或使用非
```
TK-XXX
```
的标识符。
会话中做出未记录在TK文档中的决策时，省略
```
额外决策
```
部分。
实现UI文件时未使用
```
ui-specialist
```
代理。
实现带Figma参考的UI时未使用Figma MCP。
实现过程中修改US的
```
README.md
```
、
```
TK-XXX
```
文件、ADRs或
```
technical-docs/
```
。
发现文档冲突时未先通知用户就继续执行。
在
```
progress.md
```
中使用
```
Skipped
```
或其他未定义状态；有效状态为：
```
Pending
```
、
```
In Progress
```
、
```
Done
```
。
用户提供结构化提问工具时，使用自由文本提问。
将模糊回复（如“ok”、“行”）视为确认而不提供明确选项；若存在疑问需再次询问。

Notas

注意事项

Handoffs del ciclo

流程交接

Posicion: implementacion - entre

story-plan

story-integrate


Entrada	US `Estado: Ready` ; TK del alcance con `Estado: Ready` ; rama `feature/US-XXX-[nombre-corto]` activa o creada desde la rama base acordada con el usuario.
Salida	Codigo commiteado; `progress.md` con cada TK del alcance en `Done` ; working tree limpio.
Siguiente paso	`git-commit` si hay cambios pendientes => `git-pr` (opcional, abrir desde `feature/US-XXX-` antes de mergear) => `story-integrate`* cuando `progress.md` este integro en `Done` .
Regreso desde plan	TK en Draft o conflicto tecnico => volver a `story-plan` para completar o corregir el TK antes de continuar.
Regreso desde integrate	TK no `Done` detectada al intentar mergear => completar la implementacion aqui y actualizar `progress.md` antes de reintentar.

当前阶段：实现 - 位于

story-plan

与

story-integrate

之间。


输入	状态为 `Ready` 的US；范围内状态为 `Ready` 的TK；已激活或从约定基准分支创建的 `feature/US-XXX-[短名称]` 分支。
输出	已提交的代码；范围内每个TK均标记为 `Done` 的 `progress.md` ；干净的工作树。
下一步	若有待提交变更则执行 `git-commit` => （可选）从 `feature/US-XXX-` 分支执行 `git-pr` 后再合并 => 当 `progress.md` 所有任务均为 `Done` 时执行* `story-integrate` **。
从plan返回	TK处于Draft状态或存在技术冲突 => 返回至 `story-plan` 完成或修正TK后再继续。
从integrate返回	尝试合并时发现未标记为 `Done` 的TK => 在此完成实现并更新 `progress.md` 后再重试。

Estados de

progress.md

progress.md

的状态

Estados validos por tarea: Pending
, In Progress
, Done
. No usar

Skipped

ni otros valores.

Situacion	Que hacer
Posponer una TK	Mantener `Pending` y registrar el motivo en `Notas` .
Sacar una TK del alcance	Parar; alinear con `story-define` o `story-plan` ; eliminar la entrada de `progress.md` si ya no aplica.
TK completada	`Done` .

任务的有效状态：Pending
、In Progress
、Done
。不得使用

Skipped

或其他值。

场景	处理方式
推迟某个TK	保持 `Pending` 状态并在 `备注` 中记录原因。
将某个TK移出范围	停止执行；与 `story-define` 或 `story-plan` 对齐；若不再适用则从 `progress.md` 中删除该记录。
TK已完成	标记为 `Done` 。

Orden de implementacion

实现顺序

Respetar orden numerico

TK-001

TK-002

, ... salvo dependencias obvias en el texto de las tareas. Si hay conflicto de orden, preguntar al usuario antes de implementar.

遵循

TK-001

、

TK-002

...的数字顺序，除非任务文本中存在明显依赖关系。若顺序存在冲突，需先询问用户再实现。

Relacion con otros skills

与其他Skill的关系

story-plan especifica el formato y contenido de los TK; este skill los consume (solo TK
```
Ready
```
).
story-define define la US y sus criterios de aceptacion (
```
BR-XX
```
,
```
SC-XX
```
).
quality-specialist escribe tests en el cierre cuando el usuario acepta la fase final.
story-integrate cierra la US tras este skill; requiere
```
progress.md
```
completo en
```
Done
```
y working tree limpio.
git-commit prepara commits antes del handoff a integrate.
MCP de Figma: obligatorio para tareas de UI con referencia Figma.

story-plan指定TK的格式和内容；此Skill仅使用（仅
```
Ready
```
状态的TK）。
story-define定义US及其验收标准（
```
BR-XX
```
、
```
SC-XX
```
）。
quality-specialist在用户同意最终测试阶段时编写测试用例。
story-integrate在此Skill完成后结束US；要求
```
progress.md
```
所有任务均为
```
Done
```
且工作树干净。
git-commit在移交至integrate前准备提交。
Figma MCP： 带Figma参考的UI任务必须使用。