Estándares de Desarrollo

Estándares de Desarrollo / 开发要求与编码规范

Un skill, un flujo de trabajo, dos idiomas de recurso. / 一个技能、一套流程、两种资源语言。

Revisión de recursos emparejada / 双语资源配对修订：2026-10-05.9. Esto identifica el paquete de recursos, no la aprobación del proyecto o la verificación superada. / 仅标识资源包，不代表项目批准或验证通过。

Selección de idioma / 语言选择

• Elige el idioma de las instrucciones según la preferencia explícita del usuario; de lo contrario, usa zh-CN para solicitudes en chino y en para solicitudes en inglés. Para otros idiomas, usa los recursos en inglés y responde en el idioma del usuario. No inferir el idioma a partir de metadatos de la interfaz o del idioma de los archivos fuente. 规则语言优先遵循用户明确偏好，否则中文请求选 zh-CN、英文请求选 en；其他语言使用英文资源并以用户语言沟通。不根据界面配置或源文件语言推断用户偏好。
• Para la conversación, sigue el idioma solicitado por el usuario; de lo contrario, su solicitud actual. Para cada documento, usa su idioma solicitado explícitamente; de lo contrario, la convención de documentación existente del proyecto; de lo contrario, el idioma de la conversación. Usa la plantilla correspondiente; para otros idiomas adapta una plantilla en inglés. No traduzcas archivos no relacionados ni renombres identificadores de código como efecto secundario. 对话优先遵循用户指定语言，否则跟随当前请求；每份文档优先遵循明确指定的语言，再遵循项目已有文档语言约定，最后跟随对话语言。使用相应模板，其他语言可基于英文模板调整；不顺带翻译无关文件或重命名代码标识符。
• Antes del trabajo de la tarea, lee exactamente una línea base correspondiente a continuación, luego solo sus referencias relevantes para la tarea. Un idioma de documento solicitado puede diferir del idioma de instrucción; no cargues ambos conjuntos completos de recursos solo por esa razón. 开始任务工作前读取下方一种语言的核心规范，再按需加载其中相关参考。文档目标语言可与规则语言不同，不因此加载两套完整资源。

Línea base / 核心规范	Cuándo leer / 读取条件
Estándares en chino	Idioma de instrucción chino / 规则语言为中文
Estándares en inglés	Idioma de instrucción inglés o de respaldo / 规则语言为英文或使用英文回退

Invariantes compartidos / 共同约束

• Para el desarrollo formal, primero aprueba los requisitos, luego el diseño completo del módulo/arquitectura para el alcance de implementación actual; los proyectos nuevos también requieren confirmación explícita de la pila tecnológica. La aprobación parcial cubre solo el alcance identificado; las dependencias necesarias también deben ser aprobadas, no incluidas implícitamente. No implementes ni crees andamios antes de que se superen las puertas de aprobación aplicables. Reutiliza aprobaciones auténticas y aplicables; nunca las fabriques. 正式开发先确认需求，再确认本次实施范围的完整模块架构；新项目还须明确确认技术栈。部分确认仅覆盖指定范围，必要依赖也须已确认，不自动扩大批准。适用门槛未通过前不实施或初始化工程；复用真实有效确认，不伪造批准。
• Durante el diseño de la arquitectura, los módulos complejos requieren diagramas de arquitectura y los flujos de trabajo complejos requieren diagramas de flujo, guardados con el diseño y consistentes con las descripciones del módulo/interfaz. La falta de diagramas requeridos deja ese alcance incompleto; los diagramas no reemplazan los contratos ni agregan una etapa de aprobación. Los diseños simples y las tareas de solo lectura/ligeras no requieren rellenar diagramas de todo el proyecto. 架构设计阶段，复杂模块必须用架构图、复杂流程必须用流程图表示，随设计文档保存并与模块/接口说明一致。缺少必需图示时对应范围设计不完整；图不替代契约、不新增审批。简单设计及只读/轻量任务不要求补画全项目图。
• Cuando se requiera diseño de interfaz, entrega tres prototipos visuales HTML genuinamente distintos, visibles en el navegador, para los mismos requisitos de alcance y pantallas representativas, priorizando la estética, el diseño, la tipografía y la jerarquía visual. El HTML/CSS estático es suficiente; JavaScript y las demostraciones interactivas son opcionales a menos que se soliciten explícitamente. Proporciona entradas y resultados reales de verificación de renderizado, registra las compensaciones y la selección del usuario antes de la implementación formal. El trabajo de diseño aislado no omite las puertas de requisitos/pila/arquitectura ni autoriza servicios en vivo. Reutiliza selecciones válidas y aplicables; las revisiones de solo lectura y las reparaciones que preservan el diseño establecido no fuerzan la reselección. 涉及界面设计时，基于相同范围需求和代表性页面交付 3 套有实质差异、浏览器可查看的 HTML 视觉原型，重点关注美观、布局、排版及视觉层级。静态 HTML/CSS 示意页面即可，JS 与轻量交互默认可选；用户明确要求交互演示时按指定范围实现。提供入口及真实渲染检查结果，记录取舍和用户选择后再正式实施。隔离设计不绕过需求/技术栈/架构门槛，也不授权真实服务操作；复用有效且适用的既有选择，只读评审及保持既定设计的修复不强制重选。
• Al comenzar la codificación, verifica si la implementación de alcance utiliza una base de datos. Si es así, genera y guarda su diseño antes del código relacionado con la base de datos: propón una nueva base de datos o inspecciona y reutiliza/actualiza el diseño existente, por defecto en docs/database-design.md. Sin base de datos, no hay documento de base de datos. Esto es un entregable de codificación, no un requisito previo de aprobación de arquitectura ni una etapa de aprobación adicional. Las salvaguardas aplicables de cambio de alcance y operación de datos aún se aplican; el trabajo de solo lectura no autoriza ediciones. 开始编码时检查本次实现是否使用数据库；涉及时，数据库相关代码前必须输出并保存设计，默认 docs/database-design.md：新库给出方案，已有库先核对并复用/更新现有设计。不使用数据库则不生成该文档。它是编码阶段交付物，不是架构批准的前置附件，不增加审批阶段；仍遵守范围变更和数据操作安全要求，只读工作不授权编辑。
• Cada cambio completo de código del proyecto, incluyendo correcciones de errores y refactorizaciones, debe incrementar la versión del producto afectado bajo su esquema establecido. Actualiza la fuente de versión real y las entradas sincronizadas requeridas antes de la entrega, informando valores antiguos/nuevos y ubicaciones. Cuenta un cambio completo, no cada edición de archivo o reintento. El trabajo puramente de documentación/solo lectura no desencadena un aumento de versión; los esquemas poco claros o conflictos de autoridad requieren aclaración. Los aumentos de versión no autorizan el lanzamiento ni eximen los requisitos de compatibilidad. 每次完整的项目代码变更，包括 Bug 修复和重构，都必须按既有规则递增受影响产品版本；交付前更新真实版本入口及必要同步项，报告旧值、新值和位置。按完整变更计数，不按文件编辑或重试次数；纯文档/只读工作不触发产品升版，规则不明或授权冲突时先澄清。升版不授权发布，也不豁免兼容要求。
• Las reparaciones localizadas de bajo riesgo calificadas restauran la intención clara; las refactorizaciones que preservan el comportamiento calificadas retienen el comportamiento observable, los errores y los efectos secundarios. Ambas se mantienen dentro del alcance autorizado sin nuevas características, cambios de contrato/límites ni efectos de alto riesgo. Expresa el objetivo, la evidencia, el alcance y el plan de verificación; no fuerces el rellenado histórico de documentación del producto ni la aprobación redundante. Aclara la ambigüedad y escala el trabajo afectado cuando el alcance o el riesgo aumenten. 合格低风险局部修复恢复明确预期，行为保持重构保留可观察行为、异常和副作用；均限于授权范围，不新增功能、改变契约/边界或涉及高风险。简述目标、依据、范围和验证方式，不追补历史产品文档或重复审批；有歧义先澄清，范围或风险扩大时升级受影响流程。
• Para productos cliente/Servidor, los cambios del Servidor deben preservar los protocolos, interfaces, semántica de campos y flujos de trabajo principales de los Agentes de productos antiguos sin actualizaciones forzadas de Agentes. Se requiere el alcance de compatibilidad del usuario/proyecto y evidencia real de Agentes antiguos para las interacciones afectadas. La incompatibilidad, la verificación fallida o faltante bloquean la fusión y el lanzamiento, no solo una advertencia. Agente aquí es un cliente de software, no un LLM. 对客户端/Server 产品，服务端改动须保持低版本产品 Agent 的协议、接口、字段语义及核心流程，不强制升级 Agent。涉及交互时遵循用户/项目兼容范围并提供实际低版本证据；不兼容、验证失败或缺失阻断合并发布。Agent 指软件客户端，不是大模型。
• Preserva el alcance del usuario, las reglas del repositorio y las instrucciones de mayor prioridad. Las solicitudes de solo lectura no autorizan ediciones. La aprobación no otorga permisos de commit, push, PR, despliegue, datos de producción o escritura externa no relacionados. Informa evidencia real y trabajo no verificado; la auto-revisión no es una revisión independiente. 遵守用户范围、仓库规则及更高优先级指令；只读请求不授权编辑，批准不授予无关提交、推送、PR、部署、生产数据或外部写入权限。按实际证据报告未验证项，自审不冒充独立审查。

Mantenimiento de traducción / 翻译维护

Término / 术语	Significado / 含义
Requerido / 必须	Obligación aplicable, no una sugerencia / 适用时须满足，不是建议
No debe / 不得	Acción prohibida / 禁止的操作
Recomendado / 建议	Preferido, con adaptación justificada permitida / 优先采用，可按依据调整
Aprobado / 已确认	Aprobación auténtica del contenido y alcance identificados / 真实确认指定内容与范围
Verificado / 已验证	Las comprobaciones relevantes realmente pasaron, no aprobación ni despliegue / 相关检查实际通过，不等于批准或部署

references/zh-CN y assets/zh-CN son las fuentes de reglas/plantillas en chino; los archivos en emparejados son traducciones, no políticas independientes. Actualiza los archivos correspondientes, enlaces, READMEs y escenarios de comportamiento afectados juntos; avanza la revisión emparejada del paquete en este punto de entrada, ambos READMEs y encabezados de recursos. Una revisión coincidente no es prueba de equivalencia semántica. Mantén los términos anteriores, modos de tarea, restricciones de seguridad y estándares de evidencia equivalentes. El cambio de idioma por sí solo no invalida aprobaciones ni autoriza trabajo. Si se descubre una discrepancia, repórtala y consulta solo la fuente china afectada; no selecciones silenciosamente una traducción más débil. Si la fuente no se puede verificar, revela la incertidumbre y no afirmes que la puerta afectada se superó. Las instrucciones de mayor prioridad siempre controlan.

references/zh-CN 和 assets/zh-CN 是中文规则/模板源，同名 en 文件是译文，不是独立政策。修改时同步对应文件、链接、README 及受影响行为场景，并更新入口、两份 README 和资源头部的配对修订标识；标识一致不证明语义等价。保持上表术语、任务模式、安全约束和证据标准等价。仅切换语言不使批准失效或授予实施权限。发现差异时报告并仅核对受影响中文源，不静默选择更宽松译文；源文无法核验时说明不确定性，不声称相关门槛已通过。更高优先级指令始终优先。