Communitygithub.com

CodeSoul-co/theta-skill

ポータブルなTHETAエージェントワークフロースキル

theta-skill とは?

このスキルは、THETAトピックモデリングワークフローをAIエージェントに提供するポータブルスキルです。意図の明確化から結果解釈までをガイドし、ユーザーの言語(中国語または英語)に自動的にマッチします。読み取り専用の検査と、環境やファイルを変更する操作を明確に区別し、後者には明示的な確認を要求する安全プロトコルが組み込まれています。クラウド埋め込みはゼロショットワークフローに限定され、コスト確認後にのみ使用可能です。Claude Code、Cursor、Codexなどのエージェントランタイムで利用でき、リポジトリのクローン、環境セットアップ、トレーニング実行、結果ファイルの生成といった操作はすべて、標準フォーマットによる確認を経てから実行されます。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add CodeSoul-co/theta-skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

THETA ワークフロー

このポータブルエージェントワークフロースキルを使用して、ユーザーを意図の明確化から結果解釈までのTHETAトピックモデリング作業へと導きます。ユーザーの言語に合わせて、中国語のリクエストには中国語で、英語のリクエストには英語で応答します。Codex固有のAPIを想定しないでください。コアワークフローは、ファイルの読み取り、確認の要求、確認された場合の通常のシェルコマンドの実行、およびバンドルされた読み取り専用のPythonプリフライトヘルパーの使用に依存します。

コア安全プロトコル

読み取り専用の検査と、ファイル、環境、コスト、計算、またはgit状態を変更する操作を区別します。

読み取り専用の検査とアドバイスには、追加の確認は必要ありません。

  • README、ドキュメント、スクリプト、設定テンプレート、結果ファイルを読む。
  • リポジトリ構造、ファイルの存在、Pythonバージョン、condaの存在、.envの存在、モデルパスの存在、gitステータス、利用可能なコマンドを確認する。
  • データセットのスキーマ、行数、列名、欠損テキスト、重複テキスト、テキスト長、時刻列、共変数列を検査する。
  • モデル、パラメータ、実験計画、コマンドラインを推奨する。
  • 既存のメトリクス、トピックワード、トピックテーブル、可視化、チューニングの提案を要約する。

実行前に明示的なユーザー確認が必要な操作:

  • THETAリポジトリのクローンまたはプル、ブランチの切り替え、コミット、マージ、またはプッシュ。
  • conda環境の作成、依存関係のインストール、または scripts/env_setup.sh の実行。
  • .env の作成または編集。チャット内でAPIキーを表示、保存、またはエコーしないでください。
  • クラウド埋め込みプロバイダーの設定または使用。クラウドAPI呼び出しはコストが発生し、テキストを外部サービスに公開する可能性があります。
  • Qwen、SBERT、またはその他のローカルモデルのダウンロード。
  • データセットの変更、クリーニング、変換、または書き込み。デフォルトでは新しい派生ファイルを作成することを優先し、元のデータを決して変更しないでください。
  • THETAまたはベースライントレーニング、マルチモデル比較、チューニングスイープ、大規模ローカルモデル、GPU負荷の高いジョブ、または結果を書き込むコマンドの実行。
  • レポートファイルの生成、出力の上書き、キャッシュの削除、モデルの削除、データの削除、結果ディレクトリのクリーンアップ。

確認が必要な場合は、次の形式を使用します:

我准备执行以下操作:

操作:
<简要操作>

命令:
<命令,如果有>

影响的文件或目录:
<路径>

可能的资源消耗:
<本地计算 / GPU / 存储 / API 费用 / 无>

是否会覆盖已有文件:
<是 / 否>

请确认是否继续。

英語ユーザーの場合は、対応する英語形式を使用します:

I am preparing to perform the following action:

Action:
<brief action>

Command:
<command, if any>

Affected files or directories:
<paths>

Potential resource usage:
<local compute / GPU / storage / API cost / none>

Will this overwrite existing files:
<yes / no>

Please confirm whether to continue.

确认、可以、继续、执行、yes、proceed、run it などの明示的な確認があった場合にのみ続行します。回答があいまいな場合は、ユーザーの言語でもう一度尋ねてください。

完全な確認フロー、例、確認テーブルについては、中国語の場合は references/confirmation-flow.zh.md、英語の場合は references/confirmation-flow.en.md を参照してください。インテーク質問については、references/user-questions.md を参照してください。

埋め込みルール

クラウド埋め込みは、zero_shot ワークフローでのみ、かつAPIコスト、プロバイダー、キーの存在、データ流出リスクを確認した後にのみ使用します。

supervised、unsupervised、または微調整が必要なワークフローでは、ローカル埋め込みとローカルのQwen互換モデルパスが必要です。ユーザーが微調整可能なモードでクラウド埋め込みを要求した場合は、THETAがそのパスにはローカルモデルが必要であることを説明し、代わりにローカル設定を提案します。

推奨ワークフロー

  1. リクエストがTHETAトピックモデリングに属するかどうかを特定します。このルーティング判断には確認は必要ありません。
  2. 環境設定、データ変換、またはトレーニング計画の前に、使用可能なTHETAリポジトリが存在するかどうかをすぐに確認します。README.md、.env.example、scripts/、src/models/run_pipeline.py を確認します。この読み取り専用チェックには確認は必要ありません。
  3. THETAリポジトリが存在しない場合、最初のアクションは https://github.com/CodeSoul-co/THETA.git のクローンを確認することです。リポジトリが存在するまで、環境の設定、依存関係のインストール、.env の作成、データセットの検査、またはトレーニングコマンドの生成を行わないでください。
  4. リポジトリが存在した後、ユーザーの言語で必要なタスクの質問のみを行います:データセットパス、テキスト列、言語、時刻列、共変量、ターゲット結果、リソース制約。
  5. 環境、.env の状態、データセットを読み取り専用で検査します。確定的なプリフライトが有用な場合は scripts/inspect_theta_env.py を使用します。
  6. データと目標に基づいてモデルファミリーとパラメータを推奨します。
  7. コマンドを実行せずにレビュー用に生成します。
  8. 変更、コストがかかる、長時間実行、GPU負荷が高い、またはファイルを書き込むコマンドを実行する前に、標準形式を使用して明示的な確認を得ます。
  9. 実行後、出力を読み、トピックの品質、重複、一貫性、多様性、排他性、および次のチューニング手順について説明します。
  10. 追加のチューニング実験の実行、レポートファイルの書き込み、出力の上書き、または何かの削除の前に、再度確認します。

呼び出し動作

エージェントがこのスキルを使用する場合、SKILL.md を読み取るか、skills/theta-workflow/ ディレクトリをロードするか、$theta-workflow のような名前付き呼び出しによって、現在のワークスペースを最初の候補THETAリポジトリとして扱います。現在のワークスペースがTHETAでない場合は、ユーザーが指定したパスを検査します。使用可能なリポジトリが見つからない場合は、クローン確認ステップで停止します。リポジトリゲートが満たされるまで、データセットの質問をしたり、環境設定を提案したりしないでください。

適切な最初のユーザープロンプト:

Use the THETA Workflow skill in skills/theta-workflow to help me run THETA topic modeling on a policy-text dataset.
使用 skills/theta-workflow 里的 THETA Workflow skill 帮我跑一个政策文本主题建模流程。

ランタイムが名前付きスキル構文をサポートしている場合、$theta-workflow も受け入れ可能です。

参照ルーティング

  • 完全なエンドツーエンドの決定フローについては references/workflow.md を読んでください。
  • THETAコマンドを生成する前に references/commands.md を読んでください。現在のリポジトリエントリポイントと確認要件がリストされています。
  • 出力ファイルを解釈したりチューニングを推奨するときは references/result-analysis.md を読んでください。
  • データセット、言語、目標、リソース、または出力の設定についてユーザーに尋ねるときは references/user-questions.md を読んでください。
  • 詳細な中国語の確認表現や例が必要な場合は references/confirmation-flow.zh.md を読んでください。
  • 詳細な英語の確認表現や例が必要な場合は references/confirmation-flow.en.md を読んでください。

プリフライトスクリプト

このスクリプトは読み取り専用の検査にのみ実行します:

python skills/theta-workflow/scripts/inspect_theta_env.py \
  --dataset path/to/data.csv \
  --text-column content \
  --mode zero_shot

構造化出力が必要な場合は --json を追加します。このスクリプトはファイルの書き込み、依存関係のインストール、APIの呼び出し、トレーニングの開始を行ってはなりません。

関連スキル