Back to Details

specsfy-01-inbox

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Registrar uma entrada na Inbox

在Inbox中记录条目

Modo de interação

交互模式

Modo de interação: 
sem perguntas
. Não formule perguntas nesta skill. Registre pontos ausentes para uma etapa posterior sem interromper a captura.
Registre imediatamente o texto recebido em 
specs/inbox/
. Trate a Inbox como uma entrada durável anterior ao backlog: ela preserva intenção e organiza sinais úteis, mas não decide requisitos nem autoriza implementação.
交互模式：
无提问
。在此skill中请勿提出问题。记录缺失要点留待后续处理，不要中断捕获流程。
立即将收到的文本记录到
specs/inbox/
目录下。将Inbox视为backlog之前的持久化输入：它保留意图并整理有用信号，但不决定需求也不授权实施。

Não interromper a captura

不中断捕获

  • Não faça perguntas, mesmo quando a ideia estiver vaga, contraditória ou incompleta.
  • Não peça confirmação antes de escrever.
  • Não bloqueie a captura por duplicata, falta de contexto ou incerteza.
  • Registre lacunas em 
    Pontos a revisar no futuro
    ; não tente resolvê-las com o usuário nesta etapa.
  • Depois de salvar, informe somente o caminho, um resumo breve do que foi processado e o próximo passo opcional. Não inicie o próximo passo automaticamente.
  • 即使想法模糊、矛盾或不完整，也请勿提问。
  • 写入前请勿要求确认。
  • 不要因重复、缺乏上下文或不确定性而阻止捕获。
  • 将漏洞记录在
    待后续复查要点
    中；请勿在此阶段尝试与用户解决这些问题。
  • 保存后，仅告知文件路径、已处理内容的简短摘要以及可选的下一步操作。不要自动启动下一步。

Preservar e pré-processar

保留与预处理

  1. Faça uma verificação silenciosa de credenciais, tokens, chaves privadas e dados pessoais sensíveis evidentes. Se encontrar algum, não grave o arquivo nem faça perguntas; informe que a política de privacidade exige remover o dado sensível e reenviar a ideia.
  2. Use como texto original todo o input que expressa a ideia. Preserve sua formulação integral, sem “corrigi-la” ou substituir palavras.
  3. Derive silenciosamente um título curto, concreto e fiel. Gere o slug a partir dele.
  4. Separe a análise nas categorias:
    • Declaração: conteúdo explicitamente presente no texto original;
    • Inferência: interpretação plausível, sempre identificada como tal;
    • A revisar: lacuna, conflito ou decisão que poderá ser revista depois.
  5. Extraia somente quando houver evidência:
    • resumo em uma frase;
    • problema ou oportunidade;
    • pessoas afetadas ou beneficiadas;
    • resultado ou valor esperado;
    • sinais de escopo, regra, restrição, canal ou solução mencionada;
    • riscos, dependências e relações evidentes;
    • possíveis direções de backlog ou spec, sem promovê-las.
  6. Use 
    Não identificado no texto original.
    quando não houver base. Não invente stakeholder, prioridade, prazo, regra, solução ou critério de aceite.
  1. 静默检查明显的凭证、令牌、私钥和敏感个人数据。如果发现此类数据，请勿保存文件也不要提问；告知用户隐私政策要求移除敏感数据后重新提交想法。
  2. 将所有表达想法的输入作为原始文本。完整保留其表述，不要“修正”或替换词汇。
  3. 静默生成一个简短、具体且忠实的标题，并据此生成slug。
  4. 将分析分为以下类别：
    • 声明： 原始文本中明确存在的内容；
    • 推断： 合理的解读，需明确标注为推断；
    • 待复查： 后续可能需要复查的漏洞、冲突或决策。
  5. 仅在有依据时提取以下内容：
    • 一句话摘要；
    • 问题或机会；
    • 受影响或受益的人员；
    • 预期结果或价值；
    • 提及的范围、规则、限制、渠道或解决方案的信号；
    • 明显的风险、依赖关系和关联；
    • backlog或spec的可能方向，但不要推进它们。
  6. 若无依据，使用
    原始文本中未识别到。
    。不要虚构利益相关者、优先级、期限、规则、解决方案或验收标准。

Criar o arquivo

创建文件

Execute uma única vez:
bash
node <diretório-da-skill>/scripts/capturar_inbox.mjs \
  --input "<texto original integral>" \
  --title "<título derivado>" \
  --summary "<resumo>" \
  --problem "<problema ou oportunidade>" \
  --people "<pessoas afetadas>" \
  --value "<resultado ou valor>" \
  --signals "<sinais extraídos>" \
  --risks "<riscos ou dependências>" \
  --directions "<direções futuras possíveis>" \
  --review "<pontos a revisar futuramente>" \
  [--root <raiz>]
O script usa 
.specsfy/templates/custom/Inbox.md
quando presente e recorre a 
.specsfy/templates/Inbox.md
caso contrário. Ele cria 
specs/inbox/AAAA-MM-DD-HHMMSS-<slug>.md
e nunca sobrescreve uma captura existente. Se o template estiver ausente, relate a instalação incompleta; não crie um template paralelo dentro da skill.
执行一次即可：
bash
node <diretório-da-skill>/scripts/capturar_inbox.mjs \
  --input "<texto original integral>" \
  --title "<título derivado>" \
  --summary "<resumo>" \
  --problem "<problema ou oportunidade>" \
  --people "<pessoas afetadas>" \
  --value "<resultado ou valor>" \
  --signals "<sinais extraídos>" \
  --risks "<riscos ou dependências>" \
  --directions "<direções futuras possíveis>" \
  --review "<pontos a revisar futuramente>" \
  [--root <raiz>]
如果存在
.specsfy/templates/custom/Inbox.md
，脚本会使用该文件，否则会使用
.specsfy/templates/Inbox.md
。它会创建
specs/inbox/AAAA-MM-DD-HHMMSS-<slug>.md
，且绝不会覆盖已有的捕获内容。如果模板缺失，请告知安装不完整；不要在skill内创建并行模板。

Orquestrar a conversa

对话编排

Esta skill é uma exceção deliberada ao handoff automático do framework: capturar é o resultado final do pedido e precisa ocorrer sem perguntas nem transições. Após escrever, apenas sugira um destes próximos passos:
  • manter a entrada na Inbox;
  • usar 
    $specsfy-02-backlog
    para refiná-la ou aprofundá-la.
Somente carregue outra skill se o mesmo pedido também ordenar explicitamente esse trabalho. Nesse caso, anuncie 
Transição automática: $specsfy-01-inbox → $<destino> — motivo: <motivo> — resultado esperado: <resultado>
depois de a captura estar segura.
此skill是框架自动交接机制的一个刻意例外：捕获是请求的最终结果，必须在无提问、无过渡的情况下完成。写入完成后，仅建议以下下一步操作之一：
  • 将条目保留在Inbox中；
  • 使用
    $specsfy-02-backlog
    来细化或深入处理它。
只有当同一请求明确要求进行此项工作时，才加载另一个skill。在这种情况下，确保捕获完成后，发布通知：
自动过渡：$specsfy-01-inbox → $<目标> — 原因：<原因> — 预期结果：<结果>
。

Limites

限制条件

  • Não pesquisar duplicatas antes de salvar.
  • Não alterar nem apagar capturas anteriores.
  • Não transformar inferência em declaração do usuário.
  • Não criar 
    specs/backlog/
    , qualquer pasta de estado de spec, tarefas, research, testes ou código.
  • Não usar a ideia como fonte normativa de comportamento.
  • 保存前不检查重复项。
  • 不修改或删除之前的捕获内容。
  • 不要将推断转换为用户的声明。
  • 不要创建
    specs/backlog/
    、任何spec状态文件夹、任务、研究、测试或代码。
  • 不要将该想法作为行为的规范来源。