Back to Details

specsfy-07-implement

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Implementar as tarefas e criar o código

执行任务并创建代码

Modo de interação

交互模式

Modo de interação: 
perguntas
. Antes de formular qualquer pergunta, leia e aplique o 
Contrato de perguntas numeradas
de 
.specsfy/Spec.md
.
Execute a seção 
14. Tarefas
de 
spec.md
em ordem de dependência, mantendo a fonte única, testes, código, evidências e checkboxes coerentes.
交互模式：问答。 在提出任何问题之前，请阅读并应用
.specsfy/Spec.md
中的
编号问题协议
。
按依赖顺序执行
spec.md
的
14. 任务
章节，保持单一源、测试、代码、证据和复选框的一致性。

Orquestrar a conversa

对话编排

Ao concluir esta etapa ou detectar trabalho de outra etapa, anuncie 
Pendência detectada: <descrição> — ação: resolvendo nesta etapa
e resolva-a quando pertencer ao próprio escopo. Quando houver troca de responsabilidade, anuncie 
Transição automática: $specsfy-07-implement → $<destino> — motivo: <motivo> — resultado esperado: <resultado>
e carregue imediatamente a skill de destino, sem pedir confirmação nem repetir o comando. Continue na mesma conversa. Depois de uma correção necessária a esta etapa, anuncie 
Retomada automática: $<destino> → $specsfy-07-implement — pendência resolvida: <resultado>
e retome-a imediatamente. Reavalie o estado após cada handoff para evitar ciclos. Não peça confirmação para o handoff; ações sensíveis continuam exigindo autorização específica.
完成本阶段或检测到其他阶段的工作时，声明
检测到待处理项：<描述> — 操作：在本阶段解决
，并在属于自身范围时进行处理。当需要移交责任时，声明
自动转换：$specsfy-07-implement → $<目标> — 原因：<原因> — 预期结果：<结果>
，并立即加载目标skill，无需请求确认或重复命令。继续当前对话。在对本阶段进行必要修正后，声明
自动恢复：$<目标> → $specsfy-07-implement — 已解决待处理项：<结果>
，并立即恢复执行。每次移交后重新评估状态，避免循环。移交无需请求确认；敏感操作仍需特定授权。

Gate inicial

初始校验门

  1. Leia 
    specs/planned/<NNNN>-<slug>/spec.md
    , evidências indexadas em 
    research/
    , instruções do repositório e código relevante. Não procure 
    tasks.md
    , 
    plan.md
    , 
    research.md
    ou 
    data-model.md
    .
  2. Exija 
    Formato: Specsfy/2.0
    , 
    Status: Planned
    ou 
    Implementing
    , 
    Definition Gate: Passed
    e 
    Plan Gate: Passed
    .
  3. Execute os validadores contra 
    specs/<estado>/<NNNN>-<slug>/spec.md
    . Se um gate falhar por tarefa, predecessor TDD ou RED ausente em um plano antes aprovado, anuncie a pendência e retorne automaticamente para 
    $specsfy-05-tasks
    ; não altere produção. Essa skill reabre o Ato II, chama TDD/BDD e retoma esta implementação depois de validar novamente o plano. Para outra falha, carregue automaticamente a skill responsável pelo gate.
  4. Execute a suite base relevante. Registre falhas preexistentes e não as atribua à nova mudança.
  5. Antes da primeira alteração de produção, defina 
    Status: Implementing
    , 
    Delivery Gate: In Progress
    e execute 
    specsfy transition <id> in-progress
    .
  6. Selecione trabalho pronto com:
bash
node .agents/skills/specsfy-07-implement/scripts/next_task.mjs specs/<estado>/<NNNN>-<slug>/spec.md
Se não houver tarefa pronta, diferencie 
concluído
de 
bloqueado por dependência
.
  1. 阅读
    specs/planned/<NNNN>-<slug>/spec.md
    、
    research/
    中索引的证据、仓库说明和相关代码。无需查找
    tasks.md
    、
    plan.md
    、
    research.md
    或
    data-model.md
    。
  2. 要求满足
    格式：Specsfy/2.0
    、
    状态：Planned
    或
    Implementing
    、
    定义校验门：已通过
    和
    计划校验门：已通过
    。
  3. 对
    specs/<状态>/<NNNN>-<slug>/spec.md
    执行验证器。如果校验门因任务、前置TDD或已批准计划中缺少RED而失败，声明待处理项并自动返回至
    $specsfy-05-tasks
    ；请勿修改生产环境。本技能会重新开启第二阶段，调用TDD/BDD，并在重新验证计划后恢复本实现流程。若为其他失败，自动加载负责该校验门的skill。
  4. 执行相关基础测试套件。记录预先存在的失败，勿将其归因于新变更。
  5. 在首次修改生产环境前，设置
    状态：Implementing
    、
    交付校验门：进行中
    ，并执行
    specsfy transition <id> in-progress
    。
  6. 使用以下命令选择就绪任务：
bash
node .agents/skills/specsfy-07-implement/scripts/next_task.mjs specs/<estado>/<NNNN>-<slug>/spec.md
若无就绪任务，区分“已完成”和“因依赖阻塞”状态。

Executar uma tarefa

执行任务

  1. Confirme ID, tipo, referências, dependências, arquivos e resultado verificável; marque 
    PREP
    imediatamente após essa confirmação.
  2. Para 
    [TEST]
    , siga 
    $specsfy-06-tdd-bdd
    : leia o Gherkin de referência na spec e use-o para desenhar o teste TDD; adicione marcadores e observe RED válido. Nunca crie ou execute 
    .feature
    . Em PHP, use Pest; em Node, use somente o runner confirmado pelo usuário.
  3. Para 
    [CODE]
    , confirme o predecessor TDD concluído cobrindo os mesmos IDs, com RED registrado na seção 11. Sem isso, pare e não altere produção. Anuncie a pendência e retorne automaticamente para 
    $specsfy-05-tasks
    , que reabre o plano, chama 
    $specsfy-06-tdd-bdd
    e retoma esta skill depois do novo 
    Plan Gate: Passed
    .
  4. Escreva a menor mudança de produção que torna o teste TDD verde.
  5. Depois de alterar produção e antes de marcar 
    EXECUTE
    , monitore o contexto:
bash
node .agents/skills/specsfy-setup/scripts/monitor_context.mjs \
  --project . --check
Para stack pendente, faça handoff a 
$specsfy-aux-stack
; para persistência, a 
$specsfy-aux-database
; para regra confirmada, a 
$specsfy-aux-rules
. Revise 
PROJECT.md
em toda mudança de aplicação. Se não houver impacto material na história, finalidade, capacidades ou limites, registre a avaliação na evidência da tarefa e repita com 
--acknowledge-project-no-change
. Não marque a tarefa enquanto o monitor retornar 
PENDING
. 6. Depois de cada tarefa 
[CODE]
, anuncie 
Transição automática: $specsfy-07-implement → $specsfy-documentator —    motivo: implementação alterou o sistema — resultado esperado: docs/    reconstruído e atual
e carregue 
$specsfy-documentator
. Reconstrua a documentação a partir de todo o código existente, execute seu 
--check
e retome esta skill somente quando a documentação estiver atual. 7. Para 
[DOC]
ou 
[OPS]
, produza a evidência específica pedida. 8. Marque 
EXECUTE
somente quando a entrega e a documentação exigida existirem nos caminhos declarados. 9. Execute o teste TDD focal, a suite relacionada e checks estáticos; marque 
VERIFY
somente com o resultado esperado. 10. Refatore somente com tudo verde. 11. Registre comando, resultado e IDs nas seções 11–13 e então marque 
EVIDENCE
. Quando houver 
Evidence Contract: 1
, grave também o comentário JSON 
specsfy:evidence
no bloco da tarefa e execute:
bash
node .agents/skills/specsfy-07-implement/scripts/verify_evidence.mjs \
  specs/<estado>/<NNNN>-<slug>/spec.md . --task TNNN
Quando uma execução completa produzir atestação schema 2, verifique novamente com 
--attestation PATH
. Exija commit compatível, binding da mesma spec/tarefa, refs e comandos idênticos, checks realmente aprovados e SHA-256 atual de cada arquivo. Atestação de 
--self-test
não prova entrega. 12. Faça uma micro-retrospectiva: aplique uma melhoria segura encontrada ou registre “nenhuma melhoria necessária” com justificativa; então marque 
IMPROVE
. 13. Na seção 14 de 
specs/<estado>/<NNNN>-<slug>/spec.md
, altere o pai de 
- [ ]
para 
- [x]
somente quando os cinco itens estiverem concluídos. 14. Execute 
validate_tasks.mjs
, recalcule a próxima tarefa e confira o próximo item retornado por 
next_task.mjs
.
Atualize os itens conforme o trabalho acontece; não os marque em lote no encerramento. Tarefas 
[P]
podem ser agrupadas apenas quando não tocam os mesmos arquivos ou estado. Se a execução revelar dependência oculta, torne-a explícita na seção 14.
  1. 确认ID、类型、参考资料、依赖项、文件和可验证结果；确认后立即标记
    PREP
    。
  2. 对于
    [TEST]
    任务，遵循
    $specsfy-06-tdd-bdd
    ：阅读spec中的参考Gherkin，并用其设计TDD测试；添加标记并确保有效的RED状态。请勿创建或执行
    .feature
    文件。在PHP中使用Pest；在Node中仅使用用户确认的测试运行器。
  3. 对于
    [CODE]
    任务，确认覆盖相同ID的前置TDD已完成，且第11章节中已记录RED状态。若无此条件，停止操作且勿修改生产环境。声明待处理项并自动返回至
    $specsfy-05-tasks
    ，该技能会重新开启计划，调用
    $specsfy-06-tdd-bdd
    ，并在新的
    计划校验门：已通过
    后恢复本技能。
  4. 编写最小的生产环境变更，使TDD测试转为绿色。
  5. 修改生产环境后，在标记
    EXECUTE
    前，监控上下文：
bash
node .agents/skills/specsfy-setup/scripts/monitor_context.mjs \
  --project . --check
若有栈待处理，移交至
$specsfy-aux-stack
；若涉及持久化，移交至
$specsfy-aux-database
；若涉及已确认规则，移交至
$specsfy-aux-rules
。每次应用变更时查看
PROJECT.md
。若对项目的历史、目的、能力或限制无实质性影响，在任务证据中记录评估结果，并使用
--acknowledge-project-no-change
重复执行。监控返回
PENDING
时，请勿标记任务。 6. 完成每个
[CODE]
任务后，声明
自动转换：$specsfy-07-implement → $specsfy-documentator — 原因：实现变更了系统 — 预期结果：docs/已重建并更新
，并加载
$specsfy-documentator
。基于现有所有代码重建文档，执行其
--check
命令，仅在文档更新后恢复本技能。 7. 对于
[DOC]
或
[OPS]
任务，生成要求的特定证据。 8. 仅当交付成果和所需文档存在于指定路径时，标记
EXECUTE
。 9. 执行聚焦的TDD测试、相关套件和静态检查；仅在达到预期结果时标记
VERIFY
。 10. 仅在所有测试通过时进行重构。 11. 在第11–13章节记录命令、结果和ID，然后标记
EVIDENCE
。当存在
证据协议：1
时，还需在任务块中写入JSON注释
specsfy:evidence
，并执行：
bash
node .agents/skills/specsfy-07-implement/scripts/verify_evidence.mjs \
  specs/<estado>/<NNNN>-<slug>/spec.md . --task TNNN
当完整执行生成schema 2的证明时，使用
--attestation PATH
再次验证。要求兼容的提交、同一spec/任务的绑定、相同的参考资料和命令、实际通过的检查以及每个文件的最新SHA-256。
--self-test
的证明无法作为交付依据。 12. 进行微型回顾：应用发现的安全改进，或记录“无需改进”并说明理由；然后标记
IMPROVE
。 13. 在
specs/<状态>/<NNNN>-<slug>/spec.md
的第14章节中，仅当五个项全部完成时，将父项从
- [ ]
改为
- [x]
。 14. 执行
validate_tasks.mjs
，重新计算下一个任务，并确认
next_task.mjs
返回的下一项。
随工作进展更新项目；勿在结束时批量标记。
[P]
任务仅在不涉及相同文件或状态时可分组执行。若执行过程中发现隐藏依赖，需在第14章节中明确说明。

Controlar mudança de escopo

范围变更控制

Pare quando a implementação exigir comportamento não descrito, contradizer um 
AC
ou mudar interface pública, dados, segurança ou fora de escopo. Anuncie a pendência e carregue automaticamente 
$specsfy-update-spec
. Essa skill preserva o pedido, decide se precisa refinar a pessoa, atualiza a fonte normativa, reabre somente os gates afetados e percorre validação, tarefas e TDD/BDD. Retome esta skill somente com os gates novamente aprovados. Atualize na ordem:
text
specs/<estado>/<NNNN>-<slug>/spec.md (seções 1–13) → tarefas (seção 14) → testes → código → evidências na mesma spec
Correções internas reversíveis podem ser decididas no código e registradas no relato sem reabrir a especificação.
当实现需要未描述的行为、与
AC
矛盾、变更公共接口、数据、安全或超出范围时，停止操作。声明待处理项并自动加载
$specsfy-update-spec
。该技能会保留请求，决定是否需要人员细化，更新规范源，仅重新开启受影响的校验门，并执行验证、任务和TDD/BDD流程。仅在校验门再次通过后恢复本技能。按以下顺序更新：
text
specs/<状态>/<NNNN>-<slug>/spec.md（第1–13章节）→ 任务（第14章节）→ 测试 → 代码 → 同一spec中的证据
可逆的内部修正可在代码中决定，并在报告中记录，无需重新开启规范。

Gate de conclusão

完成校验门

Quando todas as tarefas da seção 14 estiverem marcadas:
  1. execute a suite completa disponível, lint, tipos e build;
  2. execute a rastreabilidade de testes;
  3. compare cada 
    AC
    , 
    FR
    , 
    NFR
    e item da Definition of Done com evidência atual;
  4. procure tarefas abertas, placeholders, testes pulados e falhas conhecidas;
  5. execute novamente 
    monitor_context.mjs --project . --check
    e resolva toda documentação pendente;
  6. carregue 
    $specsfy-documentator
    , reconstrua 
    docs/
    e exija que o 
    build_documentation.mjs --project . --check
    passe;
  7. não declare conclusão se alguma evidência estiver ausente;
  8. altere 
    Delivery Gate
    para 
    Passed
    somente com rastreabilidade completa, defina 
    Status: Reviewing
    e execute 
    specsfy transition <id> review
    . 
    $specsfy-04-validate
    conclui o aceite e move a spec para 
    completed
    .
Depois do gate final, projete o resumo de entrega sem criar arquivo:
bash
node .agents/skills/specsfy-07-implement/scripts/render_delivery.mjs \
  specs/<estado>/<NNNN>-<slug>/spec.md --format markdown
Use 
--preview
enquanto a entrega estiver aberta. Publicar o texto em PR, commit ou ferramenta externa exige pedido explícito; o script escreve somente em stdout.
Leia 
references/completion-gates.md
para o fechamento.
当第14章节的所有任务均已标记完成时：
  1. 执行可用的完整测试套件、lint、类型检查和构建；
  2. 执行测试可追溯性检查；
  3. 将每个
    AC
    、
    FR
    、
    NFR
    和完成定义项与当前证据进行对比；
  4. 查找未完成任务、占位符、跳过的测试和已知失败；
  5. 再次执行
    monitor_context.mjs --project . --check
    ，解决所有待处理文档；
  6. 加载
    $specsfy-documentator
    ，重建
    docs/
    ，并要求
    build_documentation.mjs --project . --check
    通过；
  7. 若有证据缺失，请勿声明完成；
  8. 仅在可追溯性完整时，将
    交付校验门
    设为
    已通过
    ，设置
    状态：Reviewing
    ，并执行
    specsfy transition <id> review
    。
    $specsfy-04-validate
    会完成验收并将spec移至
    completed
    状态。
完成最终校验门后，生成交付摘要但不创建文件：
bash
node .agents/skills/specsfy-07-implement/scripts/render_delivery.mjs \
  specs/<estado>/<NNNN>-<slug>/spec.md --format markdown
交付未完成时使用
--preview
。仅在明确请求时，将文本发布至PR、提交或外部工具；脚本仅输出至stdout。
请阅读
references/completion-gates.md
了解收尾流程。

Relatar

报告

Informe tarefas concluídas, arquivos alterados, comandos e resultados, cobertura de IDs, falhas preexistentes, próxima tarefa pronta ou o gate final. Ao final, anuncie e carregue automaticamente 
$specsfy-progress
para conferir a visão global derivada da fonte. Em falha, anuncie a pendência, carregue automaticamente a skill responsável quando necessário e deixe a tarefa aberta até a correção e retomada.
报告已完成任务、修改的文件、命令和结果、ID覆盖情况、预先存在的失败、下一个就绪任务或最终校验门状态。结束时，声明并自动加载
$specsfy-progress
以确认源自单一源的全局视图。若失败，声明待处理项，必要时自动加载负责的skill，并保持任务开放直至修正和恢复。

Especialistas sob demanda

按需专家

Leia references/specialists.md antes de executar uma tarefa cuja tecnologia ou risco não esteja coberto pelo contexto local. Instale somente com autorização no projeto consumidor.
在执行本地上下文未覆盖技术或风险的任务前，请阅读references/specialists.md。仅在获得消费项目授权后进行安装。