estheryo/nocobase-blog-writer

Escritura de Blogs para NocoBase (Sección AI & No-Code)

Esta habilidad proviene del análisis y lectura detallada de los 147 artículos (2024–2026, versiones en inglés y chino) de la sección «AI & No-Code» del blog oficial. El objetivo es escribir artículos SEO que parezcan indistinguibles de los escritos por humanos y que se puedan publicar directamente.

Utiliza los artículos de 2026 como modelo; los de 2024 son el anti-ejemplo. En la misma sección, el estilo cambió drásticamente en dos años:

Indicador (inglés)	2024	2026
Adjetivos vacíos (seamless, robust, comprehensive, powerful, streamline, leverage…) por cada 1000 palabras	6.35	0.33
Mediana de extensión	1.986 palabras	2.706 palabras
Artículos con tabla comparativa	38%	63%
Artículos con FAQ	0	21/43 artículos

Lo mismo ocurre con la versión en chino: en 2024, palabras como «potente», «flexible», «sin fisuras», «fácil» y «eficiente» eran omnipresentes; en 2026 casi han desaparecido.

Cuatro reglas fundamentales

1. No inventar ningún hecho. El poder de persuasión de esta sección proviene de información real: discusiones reales de Reddit/HN/X (con enlaces), estrellas de GitHub verificadas el mismo día, precios públicos de la web oficial y funciones documentadas en los productos. Antes de escribir, verifica (GitHub API, web oficial, documentación, WebSearch). Si no se encuentra algo, márcalo como 【Pendiente de verificar: …】 para que lo revise un humano. Nunca inventes publicaciones, citas, números o casos de clientes. Aquí es donde la IA comete errores más fácilmente, y una sola invención puede arruinar la credibilidad de todo el artículo.
2. Primero lo concreto, luego lo abstracto. Cada afirmación debe ir seguida de un ejemplo concreto: un objeto de negocio real (cliente, contrato, orden de trabajo, factura), un rol real (ventas, finanzas, jefe de proyecto), un proceso real (Lead → Opportunity → Quotation → Closed deal). Sustituye los adjetivos genéricos por «qué puede hacer, para quién y en qué escenario».
3. Escribe sobre la competencia con moderación y justicia. Primero explica objetivamente en qué son buenos los demás, luego señala las diferencias y limitaciones; al recomendar NocoBase, adjunta condiciones («Si tu objetivo es X, puedes empezar por NocoBase»). No uses términos como «el mejor», «número 1» u otras autodenominaciones.
4. Distinguir entre NocoBase 3 y NocoBase 2. En los artículos, «NocoBase» se refiere por defecto a NocoBase 3, es decir, «plataforma de desarrollo orientada a agentes» según la web oficial: el Agent escribe código en Core, y Studio se encarga de la gobernanza. NocoBase 2 es «plataforma de desarrollo AI + sin código»: configuración visual, con empleados IA. Las capacidades, la terminología, los enlaces y los precios de las dos versiones son diferentes. Al escribir sobre temas como sin código, construcción visual o empleados IA, especifica claramente «NocoBase 2». Las reglas están en la sección 2 de references/nocobase-facts.md.

Flujo de trabajo

1. Definir la tarea

Antes de empezar a escribir, confirma los siguientes puntos. Si el usuario solo da el tema, infiere valores predeterminados razonables, preséntalos en dos o tres líneas para que el usuario los confirme, y continúa. No hagas una retahíla de preguntas.

• Palabra clave principal e intención de búsqueda: ¿Qué busca el lector y qué problema quiere resolver?
• Tipo de artículo: A. Recopilación de herramientas de código abierto / B. Alternativas y comparativas / C. Tutorial de construcción / D. Explicación de conceptos (ver tabla más abajo)
• Público objetivo: Desarrolladores, responsables de TI, equipos de negocio, consultores/integradores
• Idioma: Inglés, chino, o ambas versiones (la estructura debe ser coherente en ambos idiomas, pero los títulos y el fraseo deben estar localizados; consulta references/voice.md)
• Ángulo y versión de NocoBase: ¿Qué problema específico del lector resuelve NocoBase en este artículo? ¿Qué capacidades se utilizan? ¿Se escribe sobre NocoBase 3 (por defecto) o NocoBase 2 (temas de sin código, empleados IA)? La redacción de productos, la terminología y los enlaces deben basarse en references/nocobase-facts.md
• Material de apertura: Una discusión real de la comunidad o un fenómeno del sector; si no lo hay, búscalo (Reddit, Hacker News, X, Google Trends)

2. Investigación

• Comprobar duplicados primero: Busca la palabra clave principal y sinónimos (por ejemplo, retool, appsmith, crm, ticket) en references/existing-posts.md. Si ya existe un artículo antiguo sobre el mismo tema, sigue las reglas al principio de ese archivo (normalmente se sugiere reescribir la URL original) e inclúyelo en las notas de entrega. Si no se verifica, el artículo nuevo competirá con el antiguo por el ranking.
• Busca la palabra clave principal en WebSearch y observa qué cubren y qué falta en los artículos mejor posicionados. Nosotros debemos complementar lo que no explican bien (escenarios reales, costes, permisos y mantenimiento a largo plazo).
• Encuentra material de apertura: prioriza discusiones reales de la comunidad; las fuentes alternativas cuando Reddit no esté disponible se encuentran en references/article-types.md en «Apertura general».
• Verifica uno por uno los productos que se van a mencionar: web oficial, documentación, página de precios, repositorio de GitHub, estrellas (usa https://api.github.com/repos/<propietario>/<repositorio> para obtener stargazers_count, escríbelo como 22.7k y anota la fecha de consulta en las notas de entrega).
• Selecciona de 8 a 15 artículos antiguos relacionados de references/internal-links.md para enlaces internos.

3. Esquema

Sigue el esqueleto del tipo de artículo correspondiente en references/article-types.md para el esquema, usando los títulos H2/H3 fijos que allí se indican. Si el artículo supera las 2.000 palabras, muestra primero el esquema al usuario para que lo revise.

4. Redacción

Escribe según references/voice.md. Antes de escribir, lee la sección «Comparación de reescritura» de ese archivo; es más rápido que leer las reglas.

Las frases de ejemplo en los archivos de referencia están extraídas de artículos ya publicados; se aprende la estructura y el tono, no las copies textualmente en el nuevo artículo. Si lo haces varias veces, todo el blog terminará pareciendo la misma plantilla.

5. Autoevaluación

1. Ejecuta python3 scripts/check_article.py <artículo.md> (la ruta del script es relativa al directorio de esta habilidad) y modifica según las indicaciones: palabras vacías, párrafos demasiado largos, longitud del título y la descripción, módulos faltantes.
2. Revisa la lista de references/seo-checklist.md.
3. Lee solo las tres primeras frases y las dos últimas. Pregúntate: ¿Suena como si lo hubiera escrito alguien que ha hecho esto antes? ¿Hay alguna frase que podría aplicarse a cualquier otro producto simplemente cambiando el nombre? Si es así, cámbiala para que solo sea relevante para este artículo.

6. Entrega

Genera un archivo Markdown con el siguiente formato:

---
title: <Título SEO, 50–60 caracteres>
slug: <palabras-clave-en-minúsculas-con-guiones>
description: <Meta description, 120–155 caracteres>
primary_keyword: <palabra clave principal>
secondary_keywords: [<2–5 palabras>]
category: AI & No-Code
author: <Autor, con el mismo formato que en la web oficial, ej. Deng Lijia, Yuan Tianqi, Zhang Lu>
---

# <H1, puede diferir del título, pero debe contener la palabra clave principal>

<Cuerpo del artículo>

Después del cuerpo, incluye una sección de «Notas de entrega» (no se publicará) que incluya:

• Lista de capturas de pantalla pendientes: nombre del archivo en inglés descriptivo (ej. nocobase-crm-opportunity-board.png) + texto alternativo
• Todos los elementos 【Pendiente de verificar】, así como la fecha de consulta de las estrellas de GitHub y los precios
• Si se necesitan ambas versiones, sugerencias de título y description para el otro idioma

Cuatro tipos de artículos

Tipo	Patrón de título (ejemplo real)	Escenario de uso
A. Recopilación de herramientas de código abierto	Top 8 Open Source AI Assistant Tools by GitHub Stars / After Claude Code: 6 Open-Source Tools You Should Know	Un tema de tendencia, herramientas de IA populares o proyectos con muchas estrellas bajo un tema de GitHub
B. Alternativas y comparativas	How to Choose a Smartsheet Alternative: 7 Tools Compared / NocoBase vs Baserow: Flexible Databases vs Enterprise Systems	El lector ya usa o está evaluando un producto y busca alternativas o ayuda para la selección
C. Tutorial de construcción	How to Build a Production-Ready CRM with AI and NocoBase / How to Design an IT Asset Management System: Data Model, Lifecycle, and Workflows	Demostrar «AI + NocoBase» desde la necesidad hasta la puesta en producción con un sistema de negocio concreto
D. Explicación de conceptos	What Is AI No-Code? A Practical Guide to No-Code Platforms in the AI Era	Nuevos conceptos y tendencias; el lector quiere entenderlos primero antes de elegir herramientas

El esqueleto completo, los subtítulos fijos (en inglés y chino) y la redacción de cada tipo se encuentran en references/article-types.md.

Puntos clave sobre el tono (detalles en references/voice.md)

• Párrafos cortos: La mediana de palabras en inglés es de aproximadamente 20; un párrafo tiene de 1 a 3 frases; en los puntos de inflexión, usa una sola frase como párrafo (But code is not the same as an application.). La media de palabras por frase es de aproximadamente 15.
• Persona: Para acciones editoriales usa «we» (we selected, we came across); para dirigirte al lector, usa «you»; en las introducciones narrativas en primera persona, se puede usar «I».
• Lenguaje moderado: better suited to, relatively, should still confirm whether…; no uses seamless, robust, powerful, comprehensive, game-changer, unlock, empower, delve, In today's fast-paced world, In conclusion.
• En chino: no uses términos como «empoderar», «apoyar», «sin fisuras», «potente», «fácil», «crear», «todo en uno», «reducir costes y aumentar eficiencia», «en resumen»; para ejemplos, usa «por ejemplo».
• Emojis solo para marcar funciones: 💬 explicación de la sección, 💡 lectura adicional, 🎉 anuncio de producto, 🚀 experiencia en línea, ⭐/❤️ compartir al final; no los uses como decoración en el cuerpo.
• Guiones largos con moderación: en inglés, no más de 1 por cada 1000 palabras; sustitúyelos por comas, dos puntos o puntos.

Posición de NocoBase en el artículo

• La frase de explicación de la sección (la línea con 💬) se coloca después de la escena inicial y antes del primer H2 del cuerpo. El texto original está en references/nocobase-facts.md.
• En los artículos de recopilación y comparación, NocoBase aparece primero y con mayor profundidad, pero la estructura de los subtítulos es coherente con la de los demás productos; no se le da un formato especial.
• Al hablar de NocoBase, céntrate en capacidades y escenarios específicos, no uses eslóganes. Para NocoBase 3, lo habitual: componentes listos para que el Agent solo escriba la parte de negocio, estructura de proyecto y normas de desarrollo unificadas, los cambios son código (revisables y reversibles), business agents, Studio, autogestionado. Para NocoBase 2, lo habitual: construcción visual, lienzo de flujo de trabajo, empleados IA. La lista completa está en la sección 6 de references/nocobase-facts.md.
• Utiliza la terminología oficial: en el cuerpo en inglés, «agent» en minúsculas, «business agent» (NocoBase 2 lo llama «AI employee»); en chino, escribe «Agent» y «business Agent», no «agente inteligente» ni «proxy».
• En las FAQ, de 1 a 2 preguntas deben recomendar NocoBase según el escenario de uso; la última pregunta puede ser directamente sobre NocoBase (por ejemplo, «¿Es NocoBase solo para empresas?»).

Archivos de referencia

Archivo	Cuándo leerlo
references/article-types.md	Antes de hacer el esquema, lee la sección correspondiente al tipo
references/voice.md	Antes de escribir; antes de reescribir el borrador de otra persona
references/seo-checklist.md	Al definir el título, slug y description; en la autoevaluación antes de la entrega
references/nocobase-facts.md	Al escribir sobre NocoBase, poner CTA y enlaces a productos
references/existing-posts.md	Primer paso de la investigación: comprobar si hay artículos antiguos con la misma palabra clave
references/internal-links.md	Al seleccionar enlaces internos y la sección «Related reading» al final
scripts/check_article.py	Ejecutar antes de cada entrega