owner-clone-ai-mcp 1.28.2 → 1.29.1

package/domains/skills.js

@@ -35,8 +35,24 @@ const tools = [
 ■ スキルとは
 プロンプトテンプレート・ナレッジ・AIパートナー・ワークフローを組み合わせた再利用可能なタスクレシピ。
 
+■ スキル種別 skill_type【まず最初に決める・重要】
+◆ standard（標準・デフォルト）: prompt_template に手順を書く従来型。手順・参照ナレッジIDを明示する。
+◆ agent_goal（ゴール型・自律エージェント）: 「ゴール（達成すべき目的/KPI）」だけを与え、
+  Claude Code 等の実行AIが自分で計画を立て、アカウント内のナレッジ・AIパートナー・スキルを
+  自分で探索・活用してゴールを達成する。手順を細かく書く必要はない。
+  - goal（agent_goal時必須）: 達成すべきゴール本文。例「{{product}}を売るセールスレターを作成しナレッジ保存」。
+  - agent_preset_ids（空=全AIパートナーが候補）: 使ってよいAIパートナーIDの候補プール。
+    実行AIが各ステップで最適なものを load_agent で自動選択し人格を切替えて使う（該当なしのステップは使わない）。
+  - knowledge_folder_ids / knowledge_item_ids（空=全ナレッジ対象）: 参照範囲のヒント。
+  - ref_skill_ids（空=全スキルが候補）: 実行AIが活用してよいスキルの候補（UUID・個別指定）。
+  - ref_skill_folder_ids: スキルカテゴリ（skill_folders）単位での候補指定。配下の全スキルを候補に含める（ref_skill_idsと合算）。
+  - 出力: agent_goal は【必ずナレッジ保存】（成果物を create_knowledge）。output_knowledge_folder_id で保存先指定可。
+  - スコープはソフト制限（プロンプトで伝える指示・完全なブロックではない）。
+  - agent_goal は prepare_skill 専用（invoke_skill＝サーバー実行は不可）。
+  - 「ゴールを与えて自律達成させたい/手順は任せたい」なら agent_goal、「決まった手順で毎回同じ処理」なら standard。
+
 ■ 作成後の実行方法
-作成後は prepare_skill で実行します。
+作成後は prepare_skill で実行します（agent_goal も prepare_skill）。
 サーバーはDBからコンテキストを取得するのみで、AI処理はClaude Code自身が実行します。
 
 ■ prompt_template の書き方【実行モードによって異なる・重要】
@@ -130,9 +146,14 @@ allowed_plan_ids でプランを絞り込めます（[] または省略 = 全プ
             required: ['name'],
           },
         },
-        knowledge_item_ids:         { type: 'array', items: { type: 'string' }, description: '参照するナレッジのID一覧（UUID文字列。list_knowledge_itemsで確認）' },
-        knowledge_folder_ids:       { type: 'array', items: { type: 'string' }, description: '参照するナレッジフォルダID一覧（UUID文字列。list_knowledge_foldersで確認）。フォルダ内のナレッジを実行時に動的取得' },
-        preset_id:                  { type: 'integer', description: 'AIパートナーのID（整数。list_agent_presetsで返されるidをそのまま渡す）。指定するとそのAIパートナーのシステムプロンプト・ナレッジ検索モードが使われる。省略時はユーザーのClaude APIキーで実行（未設定の場合エラー）' },
+        skill_type:                 { type: 'string', enum: ['standard', 'agent_goal'], description: 'スキル種別。standard=手順型（デフォルト）。agent_goal=ゴール型（自律エージェント）。agent_goalにすると goal が必須・prepare_skill専用（invoke_skill不可）になる' },
+        goal:                       { type: 'string', description: '【agent_goal時必須】達成すべきゴール本文。実行AIが分解・計画し、ナレッジ・AIパートナー・スキルを自分で使って達成する。例「{{product}}を売るセールスレターを作成しナレッジ保存」。{{param}}も使用可' },
+        agent_preset_ids:           { type: 'array', items: { type: 'integer' }, description: '【agent_goal向け】使ってよいAIパートナーID（整数）の候補プール。空=全パートナーが候補。実行AIが各ステップで最適なものを load_agent で自動選択・切替して使う。list_agent_presetsで確認' },
+        ref_skill_ids:              { type: 'array', items: { type: 'string' }, description: '【agent_goal向け】実行AIが活用してよいスキルの候補ID（UUID・個別指定）。空=全スキルが候補。list_skillsで確認。ref_skill_folder_idsと併用可（合算）' },
+        ref_skill_folder_ids:       { type: 'array', items: { type: 'string' }, description: '【agent_goal向け】スキルカテゴリ（skill_folders）ID（UUID）。配下の全スキルを候補に含める。list_skill_foldersで確認。ref_skill_idsとの合算で候補が決まる。空=カテゴリ指定なし' },
+        knowledge_item_ids:         { type: 'array', items: { type: 'string' }, description: '参照するナレッジのID一覧（UUID文字列。list_knowledge_itemsで確認）。standard=実行時に動的取得。agent_goal=参照範囲ヒント（空=全ナレッジ対象）' },
+        knowledge_folder_ids:       { type: 'array', items: { type: 'string' }, description: '参照するナレッジフォルダID一覧（UUID文字列。list_knowledge_foldersで確認）。standard=フォルダ内ナレッジを実行時に動的取得。agent_goal=参照範囲ヒント（空=全ナレッジ対象）' },
+        preset_id:                  { type: 'integer', description: 'AIパートナーのID（整数。list_agent_presetsで返されるidをそのまま渡す）。指定するとそのAIパートナーのシステムプロンプト・ナレッジ検索モードが使われる。省略時はユーザーのClaude APIキーで実行（未設定の場合エラー）。※agent_goalでは agent_preset_ids（複数）を使う' },
         workflow_id:                { type: 'string', description: 'ワークフローのID（UUID。list_workflowsで確認）。指定するとワークフローエンジンに委譲（preset_idより優先される）' },
         output_target:              { type: 'string', enum: ['text', 'knowledge', 'both'], description: '出力先: text=テキスト返却のみ, knowledge=ナレッジ保存のみ, both=両方。デフォルト: text' },
         output_knowledge_folder_id: { type: 'string', description: 'ナレッジ保存先フォルダID（UUID。list_knowledge_foldersで確認）。output_targetがknowledgeまたはbothのときのみ有効。省略時はフォルダなし' },
@@ -179,6 +200,11 @@ is_admin_published / allowed_plan_ids はAdmin権限がある場合のみ反映
         category_id:                { type: 'string', description: 'スキルカテゴリID（UUID）。null を渡すとルート（カテゴリなし）に移動。list_skill_categoriesで確認' },
         is_admin_published:         { type: 'boolean', description: '【Admin専用】全ユーザーへの公開状態を変更する。falseにすると非公開に戻す' },
         allowed_plan_ids:           { type: 'array', items: { type: 'string' }, description: '【Admin専用】公開対象プランIDのリスト。[] を渡すと全プラン公開に戻す' },
+        skill_type:                 { type: 'string', enum: ['standard', 'agent_goal'], description: 'スキル種別。standard=手順型、agent_goal=ゴール型（自律エージェント）。agent_goalにする場合は goal を必ず設定。詳細はcreate_skill参照' },
+        goal:                       { type: 'string', description: '【agent_goal時必須】達成すべきゴール本文。実行AIが計画してナレッジ・AIパートナー・スキルを自分で使い達成する' },
+        agent_preset_ids:           { type: 'array', items: { type: 'integer' }, description: '【agent_goal向け】使ってよいAIパートナーID（整数）の候補プール。空=全候補。各ステップで実行AIが load_agent で自動選択。配列全体を置き換える' },
+        ref_skill_ids:              { type: 'array', items: { type: 'string' }, description: '【agent_goal向け】活用してよいスキルの候補ID（UUID・個別指定）。空=全候補。配列全体を置き換える。ref_skill_folder_idsと併用可' },
+        ref_skill_folder_ids:       { type: 'array', items: { type: 'string' }, description: '【agent_goal向け】スキルカテゴリ（skill_folders）ID（UUID）。配下の全スキルを候補に含める。list_skill_foldersで確認。配列全体を置き換える' },
       },
       required: ['id'],
     },
@@ -374,12 +400,21 @@ const handlers = {
     const paramStr = params.length
       ? params.map(p => `  - ${p.name}${p.required ? '（必須）' : '（任意）'}: ${p.description || ''}${p.default_value ? ` [デフォルト: ${p.default_value}]` : ''}`).join('\n')
       : '  なし';
+    const isGoal = s.skill_type === 'agent_goal';
     return [
       `ID: ${s.id}`,
       `コマンド名: ${s.name}`,
       `表示名: ${s.display_name}`,
       `説明: ${s.description || 'なし'}`,
-      `プロンプトテンプレート:\n${s.prompt_template || 'なし'}`,
+      `スキル種別: ${isGoal ? 'agent_goal（ゴール型・自律エージェント／prepare_skill専用）' : 'standard（手順型）'}`,
+      ...(isGoal ? [
+        `ゴール: ${s.goal || '（未設定）'}`,
+        `AIパートナー候補(agent_preset_ids): ${(s.agent_preset_ids || []).length ? (s.agent_preset_ids || []).join(', ') : '空（全パートナーが候補・各ステップで自動選択）'}`,
+        `スキル候補(個別 ref_skill_ids): ${(s.ref_skill_ids || []).length ? (s.ref_skill_ids || []).join(', ') : '空'}`,
+        `スキル候補(カテゴリ ref_skill_folder_ids): ${(s.ref_skill_folder_ids || []).length ? (s.ref_skill_folder_ids || []).join(', ') : '空'}${!(s.ref_skill_ids || []).length && !(s.ref_skill_folder_ids || []).length ? '（個別・カテゴリ共に空＝全スキルが候補）' : ''}`,
+      ] : [
+        `プロンプトテンプレート:\n${s.prompt_template || 'なし'}`,
+      ]),
       `パラメータ:\n${paramStr}`,
       `ナレッジ指定アイテム数: ${(s.knowledge_item_ids || []).length}件`,
       `ナレッジ指定フォルダ数: ${(s.knowledge_folder_ids || []).length}件`,
@@ -401,7 +436,9 @@ const handlers = {
       knowledge_item_ids, knowledge_folder_ids, preset_id, workflow_id,
       output_target, output_knowledge_folder_id, output_knowledge_category,
       is_shared, category_id, is_admin_published, allowed_plan_ids,
+      skill_type, goal, agent_preset_ids, ref_skill_ids, ref_skill_folder_ids,
     } = args;
+    const isGoal = skill_type === 'agent_goal';
     const data = await callApi('/skills', {
       method: 'POST',
       body: JSON.stringify({
@@ -411,13 +448,18 @@ const handlers = {
         knowledge_folder_ids: knowledge_folder_ids || [],
         preset_id: preset_id || null,
         workflow_id: workflow_id || null,
-        output_target: output_target || 'text',
+        output_target: output_target || (isGoal ? 'both' : 'text'),
         output_knowledge_folder_id: output_knowledge_folder_id || null,
         output_knowledge_category: output_knowledge_category || 'other',
         is_shared: is_shared === true,
         folder_id: category_id || null,
         is_admin_published: is_admin_published === true,
         allowed_plan_ids: allowed_plan_ids || [],
+        skill_type: isGoal ? 'agent_goal' : 'standard',
+        goal: isGoal ? (goal || null) : null,
+        agent_preset_ids: agent_preset_ids || [],
+        ref_skill_ids: ref_skill_ids || [],
+        ref_skill_folder_ids: ref_skill_folder_ids || [],
       }),
     });
     return [
@@ -426,7 +468,9 @@ const handlers = {
       `コマンド名: ${data.name}`,
       `表示名: ${data.display_name}`,
       ``,
-      `実行方法: invoke_skill に id="${data.id}" と params を渡して起動できます。`,
+      isGoal
+        ? `種別: ゴール型（自律エージェント）。実行方法: prepare_skill に id="${data.id}" を渡すと、ゴール達成のための自律エージェント指示書が返ります（invoke_skillは不可）。`
+        : `実行方法: prepare_skill（Claude Code等の自律実行）または invoke_skill（サーバー実行）に id="${data.id}" を渡して起動できます。`,
     ].join('\n');
   },
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "owner-clone-ai-mcp",
-  "version": "1.28.2",
+  "version": "1.29.1",
   "description": "MCP server for Owner Clone AI — exposes knowledge and agent presets to Claude Code",
   "main": "index.js",
   "bin": {