El AI

Cómo precipitar un conjunto de flujos de trabajo en su propia habilidad de Codex: de cero a subir GitHub

Si tiene que volver a enviar la misma solicitud a AI cada semana, este artículo es para usted. Por ejemplo, cada viernes, le dices a Codex: primero ordenar [...]

Catálogo de artículos

Si tiene que volver a enviar la misma solicitud a AI cada semana, este artículo es para usted.

Por ejemplo, todos los viernes, le dirías a Codex:

Primero organice los resultados de esta semana, luego refine los problemas y las experiencias y finalmente enumere las acciones de la próxima semana. No invente datos, cada acción debe tener un estándar de finalización.

Es la primera vez que escribe de esta manera, se llama palabra de advertencia.

Pero si escribe de esta manera todas las semanas, ya hay un conjunto de flujos de trabajo fijos detrás de eso.

Organice este conjunto de flujos de trabajo en una carpeta para que el Codex sepa cuando se encuentre con tareas similares en el futuro:

  • ¿Cuándo debería hacerse cargo?
  • qué pasos deben seguirse;
  • ¿Qué estándares debe cumplir la salida?

Eso es la habilidad.

La esencia de la habilidad es precipitar el método de hacer las cosas en tu mente en un sistema que se puede ejecutar repetidamente.

Este artículo te mostrará el proceso completo utilizando el ejemplo de "Revisto Semanal":

Encuentra el flujo de trabajo → Desmontar el flujo de trabajo → Crear una habilidad → Prueba → Subir GitHub

No necesitas saber programar primero.


Primero, entienda: ¿Qué es la habilidad?

Puedes imaginar a Codex como un nuevo compañero de trabajo altamente competente.

Escribirá código, organizará datos y analizará datos, pero no sabe cuáles son sus hábitos de trabajo:

  • En qué circunstancias se inicia una tarea;
  • Lo que generalmente haces primero y lo haces después;
  • ¿Qué reglas no pueden ser violadas?
  • ¿Qué tipo de resultado se completa?

Skill es como una copia que le das a este nuevo colega:

Manual de trabajo + proceso estándar + kit de herramientas

Una habilidad suele resolver cuatro cosas:

  1. Cuándo usar¿Qué tareas deben desencadenarlo?
  2. ¿Cómo ejecutar?Después de recibir la tarea de acuerdo con el proceso.
  3. ¿Qué puedes llamar?Si se necesitan scripts, plantillas, materiales de referencia.
  4. ¿Qué es eso?¿Qué criterios deben cumplir los resultados finales?

Las promesas ordinarias solo resuelven la tarea una vez.

La habilidad consiste en fijar una clase de tareas.

El mensaje le dice a AI:

Ayúdame a hacer algo esta vez.

Skill le dice a AI:

¿Qué debes hacer si te encuentras con este tipo de cosas en el futuro?


¿Qué tareas vale la pena hacer como habilidad?

No hagas una habilidad de inmediato al ver una palabra.

Primero hazte cuatro preguntas:

  • ¿Se repetirá esto?
  • ¿La entrada y la salida son estables?
  • ¿Hay un paso fijo en el medio?
  • ¿Es necesario reinterpretar una IA?

Si tres de las respuestas son "sí ", generalmente vale la pena precipitar.

Tarea adecuada para hacer habilidades:

  • Recopilar y planificar semanalmente;
  • De acuerdo con las reglas fijas para escribir X largo artículo;
  • Ejecutar una lista de verificación antes del lanzamiento del producto;
  • Revisión de los elementos de riesgo en el contrato;
  • Responder al servicio al cliente de acuerdo con las especificaciones de la marca;
  • Convertir las actas de la reunión en listas de tareas;
  • Procesamiento por lotes de datos de formato fijo.

No es adecuado para la habilidad:

  • tareas temporales únicas;
  • Problemas que se pueden describir en una sola frase;
  • Creación que depende totalmente de la inspiración;
  • "Ayúdame a manejar todo " es un objetivo sin fronteras.

Muchas personas quieren hacer su primera habilidad:

Asistente de Operaciones de Contenido.

Esto es lo más fácil de fracasar.

Cuanto mayor sea el rango, más borroso será el disparador y más inestable será el resultado.

Una buena habilidad no es omnipotente, sino que hace una cosa específica de manera estable.


No cree archivos, desmonte su flujo de trabajo primero

Antes de crear una habilidad, escriba una tarjeta de flujo de trabajo:

工作流名称:

什么时候启动:

用户会提供什么:

执行步骤:
1.
2.
3.

最后输出什么:

什么结果算合格:

信息不足时怎么办:

Por ejemplo:

工作流名称:
把一周零散记录整理成复盘

什么时候启动:
用户提出周报、每周复盘、一周总结、工作回顾时

用户会提供什么:
完成事项、问题、数据、下周计划

执行步骤:
1. 提取事实和数据
2. 分类成果、问题、经验
3. 合并重复信息
4. 转换成下周行动
5. 检查是否存在编造

最后输出什么:
结构化周复盘和行动计划

什么结果算合格:
不虚构数据,每个行动都有完成标准

信息不足时怎么办:
标记待补充,最多提出3个问题,不猜测

Este paso es importante.

Debido a que la descripción de la habilidad, el proceso de ejecución y los estándares de calidad, básicamente provienen de esta tarjeta.

Si ni siquiera puede escribir esta tarjeta claramente, su flujo de trabajo no se ha estabilizado.

No envases el caos en una habilidad.

Piensa en tu propio método primero.


Creación de habilidades: comienza con la versión más pequeña

Una de las habilidades más sencillas que solo requiere:

weekly-review/
└── SKILL.md

Un poco más completo:

weekly-review/
├── SKILL.md
├── agents/
│   └── openai.yaml
├── scripts/
├── references/
└── assets/

Cada directorio se encarga de algo diferente:

  • SKILL.mdCondiciones, procesos y criterios de activación de escritura;
  • agents/openai.yamlDefinir la información de presentación;
  • scripts/Almacenar el código de ejecución repetida;
  • references/Mantenimiento de la información de fondo;
  • assets/Guardar las plantillas y los materiales.

No crea un montón de directorios vacíos en el principio.

La habilidad ocupa el contexto.

Mantenga sólo lo que realmente se necesita.


Deje que Codex te ayude a desarrollar tus habilidades

Se recomienda usar el nombre de la habilidad:

  • Minúsculas en inglés;
  • Número;
  • El guión.

Por ejemplo:

weekly-review
x-article-writer
release-checker
contract-risk-check

A continuación, haga que Codex utilice el creador de habilidades:

请使用 skill-creator,把下面的工作流制作成一个 Skill。

Skill 名称:
weekly-review

工作流:
[粘贴工作流卡片]

要求:
1. 创建在当前项目中;
2. 只生成必要文件;
3. 完成后验证;
4. 告诉我如何测试和安装。

Después de la generación:

weekly-review/
├── SKILL.md
└── agents/
    └── openai.yaml

Nota:

La generación de archivos es solo el comienzo.

Es SKILL.md lo que realmente decide si Skill funciona bien.


VI. Escrita SKILL.md: el punto no es introducir, sino estipular el modo de ejecución

SKILL.md

1. YAML Heads: Decidir cuándo se activa

Por ejemplo:

---
name: weekly-review
description: 将一周零散记录整理成结构化复盘和下周行动计划。当用户提到周报、每周复盘、一周总结、工作回顾,或要求从流水账中提炼成果、问题、经验和下一步行动时使用。
---

Descripción es importante.

Debería responder:

Dos preguntas:

  • ¿Qué hace esta habilidad?
  • ¿Cuándo deben usarlos los usuarios?

No sólo escriba:

帮助用户复盘

Demasiado vago.

Debería escribirse:

当用户需要整理周报、复盘、总结流水账时使用

2. Markdown: decirle a la IA cómo hacerlo

Estructura recomendada:

# Skill名称

目标说明

## 工作流程

1. 收集输入
2. 提取事实
3. 分类整理
4. 输出结果

## 信息不足时

- 不允许猜测
- 缺少数据时标记待补充

## 输出格式

固定栏目

## 质量标准

- 必须包含什么
- 禁止出现什么

Por ejemplo:

## 工作流程

1. 提取事实:识别完成事项、数据、问题。
2. 分类整理:归入成果、问题、经验。
3. 制定行动:转换成下一步任务。
4. 检查输出:避免空话和虚构。

## 质量标准

- 区分事实和推断。
- 每个行动必须有完成标准。
- 避免“持续优化”等无意义表达。

Recuerda:

La habilidad no es una base de conocimiento.

Es un manual de ejecución.

Si puedes escribir 30 líneas, no escribas 300.


Verificación, prueba y reinstalación

Primero verifique:

请使用 skill-creator 验证 ./weekly-review。
如果发现格式问题,请直接修复。

Verificación de verificación primaria:

  • Estructura del documento;
  • El formato YAML
  • El nombre existe o no;
  • Descripción de si existe;
  • El nombramiento cumple con la regla.

Sin embargo, la verificación no significa que la habilidad sea fácil de usar.

Las pruebas reales requieren tres clases de casos:

1. Llamada explícita

请使用 $weekly-review 整理下面的记录。

La prueba se realizó correctamente.

2. Expresión natural

帮我把这些流水账整理成周报。

Prueba si la descripción se activa.

3. Información insuficiente.

这周主要做支付功能,帮我复盘一下。

Prueba si es desordenado.

Una buena habilidad no es solo completar tareas.

También sabe cuándo decir:

La información es insuficiente y debe ser complementada.


Subir GitHub y hacer de Skill su activo a largo plazo

Las habilidades también son esencialmente activos de código.

Subir a GitHub puede:

  • Guardar la versión;
  • Sincronización multi-dispositivo;
  • Compartir con el equipo;
  • Optimización continua.

Comprobar antes de enviar:

No subir:

  • API clave;
  • Token;
  • contraseña;
  • Datos del cliente;
  • reglas internas de la empresa.

Y luego:

git init -b main
git add .
git commit -m "feat: add weekly review skill"
git remote add origin <仓库地址>
git push -u origin main

Modificaciones posteriores:

git add .
git commit -m "improve skill workflow"
git push

Por último, haz tu primera habilidad hoy

Abre tu historial de chat.

Encuentre una tarea que haya repetido explicando a la IA más de dos veces en el último mes.

No primero escribas el código.

Primero complete una tarjeta de flujo de trabajo:

  • cuándo se inicia;
  • lo que ofrece el usuario;
  • Ejecutar los pasos;
  • ¿Qué exportar?
  • ¿Qué se ha completado?
  • ¿Qué hacer si la información es insuficiente?

Luego se lo entrega al creador de habilidades.

La primera edición no tiene que ser perfecta.

Deje que se ejecute primero y luego optimice en función de los resultados reales.

El núcleo de la habilidad es una sola frase:

Cambiar el "Tengo que volver a explicar cada vez " en" más tarde sabrá qué hacer ".