fskill-creator は何をしますか？
目的
作成（create）と移行（migrate）のパスを統一し、自己完結的でレビュー可能、テスト可能な関数型エージェントスキルディレクトリを生成します。メインのスキルはルーティング、ブループリントの正規化、共有アーティファクトの生成、ランタイム機能の提供、ファイル書き込み、検証を担当し、サブスキルはそれぞれの入力形式に対する事前分析のみを行います。
このスキルは、ユーザーが「関数型スキルを生成する」「関数型スキルを作成する」「既存の関数型スキルに関数を追加する」「既存のレガシースキルディレクトリを関数型スキルに移行する」リクエストを行った場合に使用します。
原則
- メインの
SKILL.mdは、共有の作成/移行/拡張/検証ワークフローのみをオーケストレーションします。 - 作成と移行は 2 つの事前パスであり、最初に統一された
skill_blueprintに収束する必要があります。 - 関数固有の動作は
functions/*.mdに配置します。作成/移行固有の事前動作はsub-skills/*/functions/*.mdに配置します。 - 共有語彙、ポリシー、スキーマは
references/*.mdに配置します。 - 決定論的な解析、フォーマット、検証、機械的な変換は
scripts/に配置します。 - レポート、ユニットテスト、ビューア、テストケースの機能はメインスキルで一度だけ管理し、
add_runtime_capabilitiesによってターゲットスキルにベンダリングします。 - ユーザーが指定したドメイン制約は保存します。移行パスでは、レガシーな動作の証拠も保存する必要があります。
- ユーザーが直接の変更を承認していない場合、生成されたファイルは提案として扱う必要があります。
サブスキル
| サブスキル | 使用タイミング | 責務 | 出力 |
|---|---|---|---|
sub-skills/create | ユーザーが新しいスキルの概要を提供する、または既存の関数型スキルを拡張したい場合 | 要件、ターゲットパス、入出力、制約、ビューアの選択を正規化する | create_context |
sub-skills/migrate | ユーザーがレガシースキルディレクトリ、モノリシックなスキルコンテンツ、または移行リクエストを提供する場合 | レガシースキルパッケージを読み込み、保存すべき動作を特定し、関数の境界と証拠を提案する | migration_context |
サブスキルは最終的なターゲットスキルファイルを直接書き込みません。それらの出力は、共有アーティファクトパイプラインに入る前に normalize_skill_blueprint を通過する必要があります。
参照
| リソース | 読み込みタイミング | 目的 |
|---|---|---|
shared_glossary | オンデマンド | 安定した用語とクロスレーン共通フィールドのセマンティクス。 |
script_rules | スクリプトの設計または作成前 | 決定論的な作業が scripts/ に属するかどうかの判断ルール。 |
sub-skills/create | 作成パス | ユーザーの概要から create_context を形成する。 |
sub-skills/migrate | 移行パス | レガシースキルディレクトリから migration_context を形成する。 |
外部入力
| フィールド | ソース | 説明 |
|---|---|---|
task_mode | ユーザーまたは導出 | create、migrate、enhance、validate のいずれか。存在しない場合は resolve_task_mode で推論される。 |
skill_request | ユーザー | スキル作成または拡張のための要件記述。 |
legacy_skill_dir | ユーザーまたはリポジトリ | SKILL.md とオプションの付随ファイルを含む、既存のレガシースキルディレクトリへのパス。 |
legacy_skill_path | ユーザーまたはリポジトリ | legacy_skill_dir の非推奨のエイリアス。SKILL.md への直接パスである場合もあり、その場合は親ディレクトリに解決される。 |
legacy_skill_content | ユーザー | パスにアクセスできない場合に提供されるレガシースキルマークダウン。 |
target_skill_path | ユーザーまたは導出 | 関数型スキルを配置するディレクトリ。 |
skill_name | ユーザーまたは導出 | オプションのターゲットスキル名。 |
existing_skill_files | リポジトリ | オプションの既存の関数型スキルファイル。 |
migration_constraints | ユーザー | 移行中に保持する必要があるファイル名、トーン、プラットフォームルール、または動作。 |
known_testcases | ユーザーまたはリポジトリ | 既存の例、トレース、または期待される動作。 |
existing_scripts | リポジトリ | レガシースキルに関連するヘルパースクリプト。 |
include_report | ユーザー | ターゲットスキルにレポートログランタイムを生成するかどうか。デフォルトは true。 |
include_unittest | ユーザー | ターゲットスキルにユニットテスト/テストケースランナーを生成するかどうか。デフォルトは true。 |
script_runtime | 環境 | このスキル自身の Node.js スクリプトを実行できるかどうか。 |
report_mode | ユーザー | off、local、remote のいずれか。デフォルトは off。 |
ビューアは機能フラグに従って生成されます。include_report=true の場合は tools/log_viewer.mjs、include_unittest=true の場合は tools/tester_viewer.mjs が生成されます。
実行パイプライン
| ステップ | 関数 | 目的 | 入力 | 出力 |
|---|---|---|---|---|
| 1 | resolve_task_mode | リクエストが作成、移行、拡張、検証のいずれのパスを通過すべきかを決定する。 | task_modeskill_requestlegacy_skill_dirlegacy_skill_pathlegacy_skill_contentexisting_skill_files | task_context |
| 2A | sub-skills/create::collect_create_brief | 作成/拡張パス: ユーザーの概要を正規化する。 | skill_requesttarget_skill_pathskill_name | create_context |
| 2B | sub-skills/migrate::load_legacy_skill + map_existing_behavior + propose_function_split + extract_shared_references | 移行パス: レガシースキルパッケージを読み込み、動作と移行証拠を抽出する。 | legacy_skill_dirlegacy_skill_pathlegacy_skill_contentmigration_constraintsinclude_reportinclude_unittestscript_runtime | migration_context |
| 3 | normalize_skill_blueprint | 作成/移行/拡張入力を統合ブループリントに収束させる。 | task_contextcreate_contextmigration_contexttarget_skill_pathinclude_reportinclude_unittest | skill_blueprint |
| 4 | design_skill_structure | ブループリントに基づいて関数パイプライン、参照、スクリプト、テストケース、ファイルレイアウトを設計する。 | skill_blueprintexisting_skill_filesscript_rules | skill_structurescript_plantool_plan |
| 5 | draft_skill_artifacts | SKILL.md、関数契約、参照、スクリプト仕様、テストケースの提案を作成する。 | skill_blueprintskill_structurescript_plan | skill_artifacts |
| 6 | add_runtime_capabilities | include フラグに従って、レポートログ、ランタイムラッパー、ユニットテストランナー、ビューア、スモークテストをプロビジョニングする。 | skill_blueprint.include_reportskill_blueprint.include_unittestskill_artifacts | runtime_artifactsskill_artifacts |
| 7 | assemble_skill_files | ターゲットスキルディレクトリのファイルを生成または更新する。 | target_skill_pathskill_structureskill_artifactsruntime_artifactsscript_runtime | file_plancreated_filesupdated_files |
| 8 | validate_skill | 関数型スキル構造、ランタイム機能、テストケース、移行動作の保存を検証する。 | target_skill_pathfile_planskill_blueprintreport_mode | validation_result |
出力範囲
このスキルは、レガシースキルを読み取り、target_skill_path の下に関数型スキルファイルを作成または変更することがあります。ユーザーが明示的に削除を要求しない限り、元のレガシースキルを削除しないでください。ユーザーが明示的にプロジェクトレベルの統合を要求しない限り、無関係なリポジトリファイルを変更しないでください。