specsfy-progress

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Informar progresso geral

汇报整体进度

Modo de interação

交互模式

Modo de interação:

sem perguntas

. Não formule perguntas nesta skill. Apresente a projeção observada e o próximo handoff aplicável.

Leia o estado exclusivamente de

specs/<estado>/*/spec.md

. O relatório é uma projeção da fonte da verdade, nunca uma segunda fonte de estado.

交互模式：

无提问

。在本skill中请勿提出问题。展示观察到的预测结果和适用的下一个交接任务。

仅从

specs/<estado>/*/spec.md

读取状态。报告是对真实数据源的预测，绝非状态的二次数据源。

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-progress → $<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-progress — 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.

完成本步骤或检测到其他步骤的工作时，通知

Pendência detectada: <描述> — ação: resolvendo nesta etapa

（检测到待处理项：<描述> — 操作：在本步骤中解决），并在属于自身范围时进行处理。当需要移交责任时，通知

Transição automática: $specsfy-progress → $<目标> — motivo: <原因> — resultado esperado: <预期结果>

（自动转换：$specsfy-progress → $<目标> — 原因：<原因> — 预期结果：<预期结果>），并立即加载目标skill，无需请求确认或重复命令。继续当前对话。在本步骤完成必要修正后，通知

Retomada automática: $<目标> → $specsfy-progress — pendência resolvida: <结果>

（自动恢复：$<目标> → $specsfy-progress — 待处理项已解决：<结果>）并立即恢复本步骤。每次交接后重新评估状态以避免循环。交接无需请求确认；敏感操作仍需特定授权。

Executar

执行

Na raiz do repositório:

bash

node .agents/skills/specsfy-progress/scripts/progress.mjs .

Para integração com outras ferramentas:

bash

node .agents/skills/specsfy-progress/scripts/progress.mjs . --json

Para uma única especificação:

bash

node .agents/skills/specsfy-progress/scripts/progress.mjs . --slug <slug>

Para observar o custo de contexto de uma spec:

bash

node .agents/skills/specsfy-progress/scripts/analyze_context.mjs \
  specs/<estado>/<NNNN>-<slug>/spec.md --json

Para projetar pendências documentais junto com o progresso:

bash

node .agents/skills/specsfy-setup/scripts/monitor_context.mjs \
  --project . --check

node .agents/skills/specsfy-documentator/scripts/build_documentation.mjs \
  --project . --check

Trate

PENDING

como blocker da entrega e anuncie o handoff indicado pelo monitor. Retome esta skill depois que a auxiliar atualizar o documento ou que a avaliação sem impacto estiver registrada e reconhecida. Se o segundo comando indicar documentação ausente ou desatualizada, anuncie o handoff para

$specsfy-documentator

, reconstrua

docs/

e retome a projeção.

Sem

--usage-json

, o resultado é sempre rotulado

estimated

e documenta a heurística. Métricas fornecidas explicitamente são

measured

; nunca apresente estimativa como uso real.

在仓库根目录下：

bash

node .agents/skills/specsfy-progress/scripts/progress.mjs .

用于与其他工具集成：

bash

node .agents/skills/specsfy-progress/scripts/progress.mjs . --json

针对单个规格：

bash

node .agents/skills/specsfy-progress/scripts/progress.mjs . --slug <slug>

用于观察spec的上下文成本：

bash

node .agents/skills/specsfy-progress/scripts/analyze_context.mjs \
  specs/<estado>/<NNNN>-<slug>/spec.md --json

用于预测文档待处理项及进度：

bash

node .agents/skills/specsfy-setup/scripts/monitor_context.mjs \
  --project . --check

node .agents/skills/specsfy-documentator/scripts/build_documentation.mjs \
  --project . --check

将

PENDING

视为交付阻塞项，并通知监控器指示的交接任务。在辅助工具更新文档或无影响评估已记录并确认后，恢复本skill。如果第二个命令显示文档缺失或过时，通知交接至

$specsfy-documentator

，重建

docs/

并恢复预测。

若无

--usage-json

参数，结果始终标记为

estimated

并记录启发式方法。明确提供的指标为

measured

；切勿将预测当作实际使用情况展示。

Interpretar

解读

Informe os denominadores de specs, gates, tarefas e itens de checklist.
Mostre o ato atual e a próxima skill responsável, ambos derivados do
```
Status
```
.
Diferencie especificação concluída, trabalho em progresso e blocker real.
Mostre o próximo par
```
TNNN/ITEM
```
pronto quando existir.
Trate um gate
```
Failed
```
, inconsistência de checklist ou dependência sem caminho pronto como blocker. Um gate
```
In Progress
```
isolado não é falha.
Trate documentação obrigatória apontada por
```
monitor_context.mjs
```
como blocker, mesmo que todos os checkboxes estejam marcados.
Trate
```
docs/
```
ausente ou desatualizado segundo
```
$specsfy-documentator
```
como blocker da entrega.
Se uma spec existente exigir mudança de comportamento ou plano, anuncie a pendência e carregue automaticamente
```
$specsfy-update-spec
```
. Retome a projeção depois que a atualização percorrer os atos invalidados.
Se nenhuma spec existir, preserve o código 2. Capturas em
```
specs/inbox/
```
e itens em
```
specs/backlog/
```
não contam como progresso normativo. Quando o pedido também exigir avançar uma captura existente, anuncie a pendência e carregue
```
$specsfy-02-backlog
```
; quando já houver intenção e definição suficientes, carregue
```
$specsfy-03-specify
```
.

说明specs、gates、任务和检查清单的总数。
展示当前阶段和负责的下一个skill，二者均源自
```
Status
```
。
区分已完成的规格、进行中的工作和实际阻塞项。
若存在，展示下一个就绪的
```
TNNN/ITEM
```
对。
将
```
Failed
```
状态的gate、检查清单不一致或无就绪路径的依赖视为阻塞项。单独的
```
In Progress
```
状态gate不算失败。
将
```
monitor_context.mjs
```
指出的必填文档视为阻塞项，即使所有复选框已勾选。
将
```
$specsfy-documentator
```
检测到的
```
docs/
```
缺失或过时视为交付阻塞项。
若现有spec需要更改行为或计划，通知待处理项并自动加载
```
$specsfy-update-spec
```
。在更新完成失效步骤后恢复预测。
若不存在任何spec，保留代码2。
```
specs/inbox/
```
中的捕获项和
```
specs/backlog/
```
中的项不算作标准进度。当请求还要求推进现有捕获项时，通知待处理项并加载
```
$specsfy-02-backlog
```
；当已有足够意图和定义时，加载
```
$specsfy-03-specify
```
。

Preservar a fonte

保留数据源

Não edite specs, checkboxes, testes ou código durante a consulta.
Não conte
```
spec.md
```
dentro de
```
research/
```
; a descoberta é exatamente
```
specs/<estado>/*/spec.md
```
.
Não invente progresso a partir de commits, arquivos ou memória do chat.
Para atualizar estado, anuncie e carregue automaticamente a skill responsável na mesma conversa. Retome automaticamente o progresso depois da atualização.

查询期间请勿编辑specs、复选框、测试或代码。
请勿统计
```
research/
```
内的
```
spec.md
```
；仅统计
```
specs/<estado>/*/spec.md
```
中的内容。
请勿从提交记录、文件或聊天记忆中虚构进度。
如需更新状态，通知并在当前对话中自动加载负责的skill。更新完成后自动恢复进度汇报。

Relatar

报告

Entregue primeiro o resumo global, depois specs que exigem atenção, blockers e próximo trabalho. Quando houver etapa acionável, anuncie e execute a transição automaticamente. Use a saída JSON sem reinterpretar nomes de campos quando o usuário pedir automação ou dados estruturados.

先交付全局摘要，再展示需要关注的specs、阻塞项和下一步工作。当存在可执行步骤时，通知并自动执行转换。当用户请求自动化或结构化数据时，直接使用JSON输出，无需重新解释字段名。

Especialistas sob demanda

按需专家

Leia references/specialists.md somente para propor contexto para a próxima tarefa. Carregue automaticamente a skill base ou o especialista já instalado que seja responsável; instalação exige autorização específica.

仅为下一步任务提供上下文时读取references/specialists.md。自动加载已安装的负责基础skill或专家；安装需特定授权。