start

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Start

开始

Ocho tiempos, de un clon recién bajado a alguien hablando con su cerrador.
八个步骤,从刚克隆代码到用户能与自己的Cerrador进行对话。

Primero el estado, antes de preguntar nada

先查看状态,再进行任何询问

Buscá
.wca-estado.json
en la raíz. Es lo primero que hacés. Son tres casos y no dos, los mismos que separa el paso 1 de
blueprint/20-entrevista.md
: que el archivo exista no quiere decir que esto sea una reanudación.
Si existe y
fase
no es
arranque
ni
entorno
, es una reanudación. Decilo, pasá al procedimiento de
/seguir
y seguí desde la fase que trae el estado. Nada que ya esté contestado ahí se vuelve a preguntar.
Si existe y
fase
dice
arranque
o
entorno
, sigue siendo este arranque, cortado a la mitad: el archivo lo escribió el tiempo 0 o el tiempo 2 de acá abajo, que son las dos primeras fases que escriben el estado. Seguí por el tiempo que sigue al que quedó anotado y no vuelvas a preguntar lo que ya está. La traducción de esa palabra al archivo que hay que abrir es la columna «
fase
en el estado» de
blueprint/00-mapa.md
.
Si no existe, la cadena arranca en tres archivos, en este orden:
  1. blueprint/00-mapa.md
    — el índice y el contrato de reanudación. Es el que manda
    CLAUDE.md
    , y el único que traduce cada
    fase
    del estado al archivo que hay que abrir.
  2. blueprint/00-contrato.md
    — el desempate: nombres, orden, rutas y dueños. No se lee entero.
  3. blueprint/05-arranque.md
    — la fase 0, el tiempo 0 de acá abajo.
El paso 1 de
blueprint/00-mapa.md
vuelve a buscar el estado. Ya lo buscaste: no lo repitas, decí que salió
SIN ESTADO
y seguí.
在根目录中查找
.wca-estado.json
文件,这是你要做的第一件事。共有三种情况,而非两种,与
blueprint/20-entrevista.md
的步骤1中划分的情况一致:文件存在并不意味着这是一个续建任务。
如果文件存在且
fase
字段的值不是
arranque
entorno
,则属于续建任务。告知用户这一点,切换到
/seguir
流程,并从状态记录的阶段开始执行。已回答过的问题无需再次询问。
如果文件存在且
fase
字段的值为
arranque
entorno
,则说明当前仍处于初始搭建流程中,只是中途中断:该文件由下方的步骤0或步骤2生成,这两个是最先写入状态的阶段。从记录的阶段的下一个步骤继续执行,无需重复询问已完成的内容。阶段名称对应需打开的文件可参考
blueprint/00-mapa.md
中的“
fase
en el estado”列。
如果文件不存在,则按以下顺序从三个文件开始流程:
  1. blueprint/00-mapa.md
    — 索引与续建协议。该文件由
    CLAUDE.md
    指定,是唯一能将状态中的每个
    fase
    映射到对应需打开文件的文档。
  2. blueprint/00-contrato.md
    — 用于明确规则:名称、顺序、路径和负责人。无需全文阅读。
  3. blueprint/05-arranque.md
    — 阶段0,即下方的步骤0。
blueprint/00-mapa.md
的步骤1会再次查找状态文件。你已经完成了查找,无需重复操作,告知用户状态为
SIN ESTADO
并继续执行即可。

Los ocho tiempos

八个步骤

/start
no trae procedimiento propio salvo el arranque y el cierre. Abre el archivo que toca, lo sigue, y no pasa al siguiente hasta que se cumpla lo que ahí dice «Tenés que ver».
Los archivos son los mismos que recorre
/armar-cerrador
, en el mismo orden:
/start
no tiene una cadena aparte. Lo que agrega alrededor es el arranque —el estado y los tres archivos de acá arriba—, el corte del tiempo 5 y el cierre del tiempo 7. Y cambia una sola cosa adentro: el orden del tiempo 3, explicado ahí mismo.
  • 0 · El terreno
    blueprint/05-arranque.md
    , después de los dos archivos de arriba. Mide sistema, Python en el rango de
    PINES.md
    , Claude Code, y que el árbol sea un clon de git y no un ZIP. No instala nada. Cierra diciendo qué va a costar y cuánto va a tardar.
  • 1 · El destino
    blueprint/05-arranque.md
    . Dónde va a vivir, local o Railway, y por dónde entran los mensajes:
    demo
    ,
    meta
    o
    zernio
    .
  • 2 · El entorno
    blueprint/10-entorno.md
    . El
    .venv
    , las dependencias y la clave.
  • 3 · La entrevista
    blueprint/20-entrevista.md
    y
    blueprint/25-playbook.md
    , en este orden y no en otro:
    • Q1 a Q3 — tramo 1 de
      blueprint/20-entrevista.md
      : qué vende el negocio, con qué nombre firma el agente, y el tratamiento con el que le habla a un cliente (
      ,
      vos
      o
      usted
      ).
    • Q5 a Q9 — tramo 2 del mismo archivo: catálogo con precios, rango de precio, disponibilidad, palabras de escalación y canal interno. Cuando el tramo 2 termina vuelve a quien lo llamó: acá, a este mismo tiempo 3, que sigue con Q4.
    • Q4
      blueprint/25-playbook.md
      : las objeciones y el tono.
    Por qué Q4 va última. El playbook llena
    {producto}
    y
    {precio}
    con lo que contestaron Q5, y
    {horario_1}
    con lo que contestaron Q7. Corrido antes, esos tres huecos quedan abiertos, y el cerrador que se muestra en el corte del tiempo 5 no puede decir un precio ni ofrecer un horario.
    Por qué el tramo 2 corre acá y no otro día. El «Próximo archivo» del tramo 1 salta directo al playbook, y
    /start
    se aparta de eso a propósito. Esa línea está escrita para
    /armar-cerrador
    , donde Q5 a Q9 las abre
    /configurar
    cualquier otro día. Acá van seguidas porque ninguna de las cinco pide una cuenta ajena: las cinco salen de la cabeza de quien instala. Las que sí piden consolas ajenas son Q10 a Q12, y entran en el tiempo 6.
  • 4 · La construcción
    blueprint/30-generacion.md
    , y de ahí, en ese orden,
    blueprint/31-proveedores.md
    ,
    blueprint/32-multimodal.md
    ,
    blueprint/33-agenda.md
    ,
    blueprint/34-crm.md
    y
    blueprint/35-panel-api.md
    . Sale el árbol de
    agente/
    .
  • 5 · Que ande
    blueprint/40-pruebas.md
    y
    blueprint/90-auditoria.md
    . La suite en verde, la compuerta en
    pass
    y el simulador corrido.
  • 6 · El destino, ahora de verdad
    blueprint/50-despliegue.md
    . Local: uvicorn y un túnel. Railway: el CLI, las variables y el alta del webhook. Q10 a Q12 entran acá, no antes. Ese archivo cierra con «Próximo archivo:
    blueprint/60-bandeja.md
    », y ése no es un tiempo de
    /start
    : es el comando
    /bandeja
    , y corre después del cierre. La cadena termina en el tiempo 7.
  • 7 · El cierre — acá abajo.
/start
命令除了初始启动和收尾环节外,没有独立的流程。打开对应的文件并执行,直到满足文件中“Tenés que ver”(需确认)的条件后,再进入下一个步骤。
所使用的文件与
/armar-cerrador
流程的文件完全相同,顺序也一致:
/start
没有独立的文件序列。它额外添加的内容包括初始启动环节(状态检查和上述三个文件)、步骤5的中断点以及步骤7的收尾环节。仅调整了一个内容:步骤3的执行顺序,具体说明见下文。
  • 0 · 环境检查 — 在查看上述两个文件后,打开
    blueprint/05-arranque.md
    。检查系统环境、Python版本是否符合
    PINES.md
    的要求、是否具备Claude Code,以及代码是否为git克隆版本而非ZIP压缩包。此步骤不进行任何安装操作。结束时告知用户搭建成本和预计耗时。
  • 1 · 部署目标 — 打开
    blueprint/05-arranque.md
    。确定部署位置:本地或Railway,以及消息接入渠道:
    demo
    meta
    zernio
  • 2 · 环境配置 — 打开
    blueprint/10-entorno.md
    。配置
    .venv
    虚拟环境、安装依赖并设置密钥。
  • 3 · 配置访谈 — 按以下顺序打开
    blueprint/20-entrevista.md
    blueprint/25-playbook.md
    ,不得调整顺序:
    • Q1至Q3
      blueprint/20-entrevista.md
      的第一部分:业务售卖的产品、Agent使用的签名名称,以及与客户沟通时的称呼方式(
      vos
      usted
      )。
    • Q5至Q9 — 同一文件的第二部分:带价格的产品目录、价格范围、可用性、升级话术和内部渠道。完成第二部分后,回到当前步骤3,继续执行Q4。
    • Q4 — 打开
      blueprint/25-playbook.md
      :设置异议处理话术和沟通语气。
    为何Q4放在最后。Playbook会用Q5的回答填充
    {producto}
    {precio}
    变量,用Q7的回答填充
    {horario_1}
    变量。如果提前执行Q4,这三个变量将处于未填充状态,导致步骤5中断点展示的Cerrador无法告知价格或提供时间安排。
    为何第二部分在此处执行而非其他时间。第一部分的“下一个文件”指向直接跳转到Playbook,但
    /start
    流程特意调整了这一顺序。该跳转逻辑是为
    /armar-cerrador
    流程设计的,在该流程中Q5至Q9由
    /configurar
    命令在其他时间执行。在此处连续执行是因为这五个问题无需借助外部账户,安装人员仅凭自身知识即可回答。需要外部控制台的Q10至Q12将在步骤6中执行。
  • 4 · 构建Agent — 打开
    blueprint/30-generacion.md
    ,然后按顺序打开
    blueprint/31-proveedores.md
    blueprint/32-multimodal.md
    blueprint/33-agenda.md
    blueprint/34-crm.md
    blueprint/35-panel-api.md
    。完成后将生成
    agente/
    目录结构。
  • 5 · 功能验证 — 打开
    blueprint/40-pruebas.md
    blueprint/90-auditoria.md
    。确保测试套件全部通过、网关状态为
    pass
    ,并运行模拟器。
  • 6 · 正式部署 — 打开
    blueprint/50-despliegue.md
    。本地部署:使用uvicorn和隧道;Railway部署:使用CLI、配置环境变量并注册webhook。Q10至Q12在此步骤执行,不得提前。该文件结尾标注“下一个文件:
    blueprint/60-bandeja.md
    ”,但这不属于
    /start
    流程的步骤,而是
    /bandeja
    命令的内容,将在收尾环节后执行。
    /start
    流程在步骤7结束。
  • 7 · 收尾环节 — 内容见下文。

Qué se pregunta y qué se decide

需询问与可自主决定的内容

Lo del negocio se frena y se pregunta: catálogo, precios, horarios, tono, cuándo pasa a un humano. Eso no lo podés saber. Lo técnico lo decidís vos y lo declarás: qué elegiste y en qué archivo se cambia. Nada de menús para lo que tiene una sola respuesta correcta.
业务相关内容需暂停流程并询问用户:产品目录、价格、时间安排、沟通语气、何时转接人工等。这些信息你无法自行知晓。技术相关内容可由你自主决定并告知用户:你选择的方案以及对应的修改文件。对于只有唯一正确答案的内容,无需提供选项菜单。

El corte está al final del tiempo 5

中断点位于步骤5结束时

Ahí parás y mostrás. Quien instala habla con su cerrador en el simulador sin una sola credencial de WhatsApp. Todo lo caro y lo lento vive después de esa línea.
Con Q5 a Q9 ya contestadas en el tiempo 3, lo que se ve ahí dice precios del catálogo y ofrece horarios reales. Ése es el corte que vale mostrar: si el tramo 2 quedó sin correr, el simulador abre igual y el cerrador no tiene con qué contestar cuánto sale.
Antes de seguir al tiempo 6, preguntá si quiere seguir hoy o dejarlo ahí. Dejarlo ahí es una respuesta válida:
/seguir
lo retoma cualquier otro día.
在此处暂停并向用户展示效果。安装人员可在模拟器中与自己的Cerrador对话,无需任何WhatsApp凭证。所有成本高、耗时长的操作都在该中断点之后。
由于步骤3中已完成Q5至Q9的回答,此时展示的Cerrador能告知产品目录价格并提供真实时间安排。这是值得展示的中断点:如果未执行第二部分,模拟器仍可打开,但Cerrador无法回答价格相关问题。
在进入步骤6之前,询问用户是否要继续执行或暂停。暂停是有效的选择:后续可通过
/seguir
命令恢复流程。

Tiempo 7 · El cierre

步骤7 · 收尾环节

Al terminar, en pocas líneas:
  • Qué quedó andando, con el comando exacto para volver a levantarlo.
  • Qué falta, y qué paso deja sin correr cada cosa que falta.
  • Qué supuestos le tocaron: los de
    SUPUESTOS.md
    que aplicaron, por identificador.
  • El próximo comando:
    /bandeja
    para resolver los borradores de a uno,
    /soltar
    cuando quiera que conteste solo.
Y decilo con todas las letras: el default es
borrador
. El agente redacta, muestra y espera. Nadie del otro lado recibe nada hasta que lo suelte.
流程结束时,用简短的内容说明以下几点:
  • 已运行的内容,并提供重启所需的精确命令。
  • 未完成的内容,以及每项未完成内容对应的未执行步骤。
  • 所采用的假设:列出
    SUPUESTOS.md
    中已应用的假设及其编号。
  • 下一步命令:使用
    /bandeja
    逐个处理草稿,使用
    /soltar
    让Agent自动回复消息。
明确告知用户:默认模式为
borrador
(草稿模式)
。Agent会撰写回复内容、展示给用户并等待确认。在用户确认发送前,对方不会收到任何消息。