AIは

ワークフローを独自のCodexスキルに変換する方法:0からGitHubにアップロードするまで

毎週同じリクエストをAIに再送信する場合は、この記事はあなたのためです。例えば毎週金曜日にコーデックスに言います“まず整理してください”

記事の目次

毎週同じ段落をAIに再送信する場合は、この記事はあなたのためです。

毎週金曜日、あなたはコーデックスにこう言います。

今週の結果を整理し、問題や経験を洗練し、来週の行動をリストアップします。データを作らず、すべてのアクションに完了基準が必要です。

最初に書いたのは、ヒントワードです。

しかし、毎週これを書く場合は、その背後に固定されたワークフローがあります。

このワークフローをフォルダに整理して、Codexが後で同様のタスクに遭遇したときに知らせます。

  • いつ引き継ぐべきか。
  • どのようなステップを踏むか。
  • 輸出に必要な基準は?

これがスキルです。

スキルの本質は、頭の中で物事を行う方法を、繰り返し実行できるシステムに凝縮することです。

この記事では、プロセス全体を説明するために、“ウィークリー”を例として使用します。

ワークフローの検索→ワークフローの分解→スキルの作成→テスト→ GitHubのアップロード

最初に計画する必要はありません。


まず、スキルとは何ですか?

Codexは有能な新しい同僚と考えることができます。

コードを書き、データを整理し、データを分析しますが、あなたの仕事習慣を知りません。

  • 特定のタスクを開始する場合
  • 普段は何をするか、次に何をするか。
  • 違反できないルール。
  • どのような結果が完成しますか?

スキルは、この新しい同僚に与えるもののようなものです。

ジョブディスクリプション+標準プロセス+ツールキット

スキルは通常4つのことを解決する:

  1. いつ使うのかどのタスクがトリガーされますか?
  2. 実装方法は?タスクを受け取った後にどのようなプロセスに従うか。
  3. 何を呼ぶか?スクリプト、テンプレート、リファレンスが必要かどうか。
  4. 完成したもの。最終的なアウトプットが満たすべき基準。

通常手がかり詞はタスクを一度だけ解決する。

スキルはタスクのセットを固定することです。

略称はAI。

今回は何かお手伝い。

スキルはAIに言った。

このようなことが起こったらどうしますか?


スキルに値するタスクは何ですか?

ヒントを見てすぐにスキルを取らないでください。

4つの質問から始めましょう

  • これは繰り返されるのか?
  • 入出力は安定していますか?
  • 中間に固定ステップはありますか?
  • 別のAI、再解釈が必要ですか?

3つの答えが“はい”の場合、通常は落ち着く価値があります。

スキルに適したタスク:

  • 毎週のスケジュールとスケジュール;
  • 固定ルールに従ってX文を書く。
  • 製品リリース前のチェックリストの実施
  • 契約のリスク項目のレビュー;
  • ブランド基準に従った対応;
  • 会議の議事録をタスクリストに変換する。
  • 固定形式のデータを一括処理します。

スキルに適していません

  • 一時的な一時的任務
  • 1つの単語で記述できる問題;
  • インスピレーションに完全に依存する創造。
  • “すべてを手伝ってください”という境界のない目標です。

多くの人が最初のスキルでやりたいこと:

コンテンツ運用アシスタント。

失敗するのが一番簡単です。

範囲が大きいほど、トリガーがぼやけてしまい、結果が不安定になります。

良いスキルは全能ではなく、特定のことを安定させることです。


ファイルを作成しないで、ワークフローを分解します。

スキルを作成する前にワークフローカードを作成します。

工作流名称:

什么时候启动:

用户会提供什么:

执行步骤:
1.
2.
3.

最后输出什么:

什么结果算合格:

信息不足时怎么办:

例えば:

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

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

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

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

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

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

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

このステップは非常に重要です。

スキルの説明、実行プロセス、品質基準は、基本的にこのカードから来ています。

このカードを書くことさえできない場合は、ワークフローが安定していません。

混乱をスキルに包まないでください。

まず自分の方法を考えてください。


スキルの作成:最小限のバージョンから始める

最も簡単なスキルは、必要なもの:

weekly-review/
└── SKILL.md

もう少しで完全に:

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

各ディレクトリは異なる責任を負う:

  • SKILL.md::トリガー条件、プロセス、標準を記述する。
  • agents/openai.yaml::表示情報の定義;
  • scripts/繰り返し実行されるコードの保存;
  • references/背景情報の保存;
  • assets/テンプレートと素材を保存します。

最初に空のディレクトリを作成しないでください。

スキルはコンテキストを占有します。

本当に必要なものだけを保存する。


コーディングにスキルを与えましょう。

Skill名の推奨:

  • 小文字の英語
  • 数字は、
  • ハイフン。

例えば:

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

コードにスキル作成子を使用させます:

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

Skill 名称:
weekly-review

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

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

生成後のこと:

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

注意点:

ファイルの作成は始まりに過ぎません。

Skillの使い方を決めたのはSKILL.mdです。


SKILL.mdを書く:焦点は導入ではなく、実装方法を規定することです。

SKILL.mdは通常2つの部分から構成される。

1. YAMLヘッダー:トリガーするタイミングを決定する

例えば:

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

記述は重要です。

答えなければなりません

2つの問題:

  • このスキルは何ですか?
  • ユーザーはいつ使うべきか?

書かないでください

帮助用户复盘

曖昧すぎます。

書くべきです

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

2. Markdown:AIに実行方法を教える

推奨構造:

# Skill名称

目标说明

## 工作流程

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

## 信息不足时

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

## 输出格式

固定栏目

## 质量标准

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

例えば:

## 工作流程

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

## 质量标准

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

覚えなさい:

スキルは知識ベースではありません

これは実装マニュアルです。

30行で明確に言えば、300行を書くな。


七、検証、テスト、再インストール

最初の確認:

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

主な検査の検証:

  • 文書構造;
  • YAMLフォーマット;
  • 名前が存在するか
  • 存在の説明;
  • 命名規則に従っているかどうか。

しかし、スキルは役に立ちません。

実際のテストには3つのケースが必要です。

1.明示的呼び出し

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

テストは正しく実行されます。

2.自然な表現です

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

説明がトリガーできるかどうかをテストします。

3.不十分な情報

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

テストは混乱するかどうか。

良いスキルはタスクを完了するだけではない。

いつ言うべきか分かります。

情報不足、補足が必要です。


GitHubにアップロードしてスキルを長期的な資産にする

スキルは基本的にコード資産です。

GitHubで利用できること:

  • バージョンを保存する。
  • 複数の機器の同期;
  • チームとの共有;
  • 継続的な最適化

提出前のチェック:

アップロードしない:

  • APIキー;
  • トークン;
  • コードコード;
  • 顧客情報;
  • 社内ルールです。

その後、

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

後に修正。

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

最後に、今日最初のスキルを取得します。

チャット記録を開きます。

過去1 ヶ月間にAIに2回以上説明したタスクを探します。

最初にコードを書くな。

まず、ワークフローカードを完成させる:

  • 開始するとき;
  • ユーザーが提供するもの;
  • ステップの実行;
  • 何を輸出するか
  • 完成したもの
  • 情報不足とは?

スキルクリエイターに渡します。

初版は完璧である必要はない

最初に実行し、実際の結果に基づいて最適化します。

スキルのコアはたった一言です。

“私は毎回再解釈しなければならない”を“後で何をすべきか知っている”に変えてください。