kact 0.14.2

資料だけの変更です（ツールの名前と引数は変わりません。オーサリング API も同じ版 10）。

• 保存前の検査（起動 check_create / check_edit / check_delete）を config と sql の章に書きました（kSQL アクション本体の 2026-11-09 の変更）。保存（追加・編集・一覧のインライン編集）と削除の直前に読むだけの SQL を流し、ASSERT で止まったら、その文を画面に出して保存（削除）を取り消します。締め処理中の月に実績を足させない、のような用途です。
  • 書ける文は DECLARE / SET / 一時テーブル / ASSERT / EXIT だけ（書く文は kact_check が pCheckWrite の error で知らせます）
  • ほかの起動と同じ行にしない（check:mixed）。入力項目・ループは持てず、confirm と writeLimit は見ません
  • 保存する前の画面の値はパラメーターの計算式で渡します（一覧のインライン編集では自動計算の項目が古い値です）
  • 「実行を許す人」は見ず、全員に効きます。検査ができなかったとき（権限・通信など）も保存を止めます
  • 規則は本体の zip の検査なので、check_* を使う設定は、この機能を入れた kSQL アクションの zip で検査してください
• sql の章: 0.14.1 で足した節「読む前に件数を数えて止める」が箇条書きの途中に入り、元の箇条「何度流しても同じ結果になる形で書く」がその節の下に見えていたのを、元の位置に戻しました（中身は同じ）。

ファイル

ファイル	sha256
ksql-action-authoring-0.14.2.mcpb（Claude Desktop）	40d6bb1ee55472489b1279e433a6c5f858c40654d162e190e4f56f2e5584b8f2
ksql-action-authoring-plugin-0.14.2.zip（Claude Code）	7bfc3fa280b088c5b94579d5b76dc22a531932fe2f9a039c8a7d9df5d26bb9cb

要るもの

• kSQL アクションプラグイン Ver.1 以降の zip（オーサリング API 版 1〜10）。check_* を使うなら、保存前の検査を入れた zip
• Claude Desktop（.mcpb の拡張機能）または Claude Code

入れ方

• Claude Desktop: .mcpb をダブルクリック
• Claude Code: /plugin marketplace update rex0220-ksql-action → /plugin install ksql-action@rex0220-ksql-action（初めては /plugin marketplace add rex0220/ksql-action-authoring）

kact 0.14.1

資料だけの変更です（ツールの名前と引数は変わりません。オーサリング API も同じ版 10）。

• ASSERT / EXIT のメッセージに {@名前} で変数の値を入れられることを sql と config の章に書きました（kSQL アクション本体の 2026-11-09 の変更）。SET の値・配列・共通の文・打ち間違いは、kact_check が pMessagePlaceholder の error で知らせます（本体の zip の検査なので、ツールの版に依りません）。
• 読む前に件数を数えて止める形（ASSERT (SELECT COUNT(*) …) <= 10000, @m_…）を sql の章に足しました。件数を 1 回聞くだけでレコードを読まないこと、上限は数で書くこと（文字列と比べると実行時に止まる）を書いています。
• 失敗したときに画面に出る文（何が起きたか・書いた件数・どうすればよいか）を limits の章に足しました。
• limits の readMax は「合計」ではなく1 回の読み取りごと、tempTableMax は出来た表 1 つの行数、と直しました（エンジン 3.93.0 の決まり）。

ファイル

ファイル	sha256
ksql-action-authoring-0.14.1.mcpb（Claude Desktop）	7fbda64c82c2875732b29d616a64842797946a8a645a764362a85a896cbca525
ksql-action-authoring-plugin-0.14.1.zip（Claude Code）	1be19b175c8d3cc86622f3e7f262592bf04a2a66409ab5a42aaacb801d6429b9

要るもの

• kSQL アクションプラグイン Ver.1 以降の zip（オーサリング API 版 1〜10）
• Claude Desktop（.mcpb の拡張機能）または Claude Code

入れ方

• Claude Desktop: .mcpb をダブルクリック
• Claude Code: /plugin marketplace update rex0220-ksql-action → /plugin install ksql-action@rex0220-ksql-action（初めては /plugin marketplace add rex0220/ksql-action-authoring）

kact 0.14.0

「何を確かめて、何を確かめていないか」を、毎回の結果ではっきり返すようにしました。
あわせて、取り込む前に、古いファイルで新しい設定を消してしまう事故を防げるようにしました。

検査ごとの状態（kact_check の summary.checks）

これまでは、ツールに確かめられなかったものは警告の文の中でしか分かりませんでした。
findings が空だと「全部確かめて問題なし」に見えてしまいます。

summary.checks に、検査ごとの状態を返します。

状態	意味
passed	見て、問題が無かった
warning	見て、保存はできるが動きが意図と違いうる（例: 選択肢の定義に無い値で 0 件になる）
failed	見て、保存できない問題があった
not_checked	見ていない。理由つき（控えが無い・設定画面の［保存する］にしかできない検査など）

summary.nextStep には次にすることを 1 文で返します。
「設定ファイルを作れる」と「設定画面で保存できる」は別なので、見ていないものがあればそう言います。
findings はこれまでどおり返ります。

設定ファイルの出どころ（source）と、取り込む前の読み直し

kact_pull が、取り込んだ設定ファイルに出どころを残します。

• アプリから直に読んだとき: 接続・アプリ・環境・kintone の版・保存されていた設定の digest・日時
• ダウンロードしたファイルからのとき: 元のファイルと、その digest

取り込みは全置換なので、AI が読んだ後に誰かが設定画面で直していると、
このファイルを取り込んだ時点でその直しが黙って消えます。
kact_check に checkSource: true を付けると、kintone から読み直して digest を比べ、
直されていれば source-changed で知らせます（次にすることは「取り込まないでください」）。

• source は取り込みでは捨てられるので、置いても設定画面の取り込みは壊れません
• 秘密の値は入れません（接続は名前とホストだけ）
• 比べる鍵は digest です（kintone の版は「アプリの設定」全体の版で、項目を直しただけでも変わるため）

別のアプリのファイルに書かない

kact_update_action / kact_update_common / kact_delete_action に app（直すつもりのアプリ）を
渡せるようにしました。ファイルのアプリと違えば、書かずに app-mismatch を返します。
kact_actions も、そのファイルがどのアプリのものかと出どころを返します。

そのほか

• kact_check の説明の「プラグイン本体と同じ規則」を「読み取りで分かる範囲は」に直しました
• kact_pull（app）と kact_check（checkSource）は kintone に読みに行くので、外部に触れる印（openWorldHint）を付けました

入れ方

Claude Desktop: ksql-action-authoring-0.14.0.mcpb をダウンロードしてダブルクリック。

Claude Code:

/plugin marketplace update rex0220-ksql-action
/plugin install ksql-action@rex0220-ksql-action

要るもの

kSQL アクションプラグイン	Ver.1 以降。kact_pull の app と checkSource にはオーサリング API 版 10 以降の zip と、ドメインでAPIラボが有効であることが要ります

sha256

d076e6ec57b1151d4fc14e36d7fc0813a1efafe20de6460b036781d62d5fd31d  ksql-action-authoring-0.14.0.mcpb
89d5a0875b89243df57d7f8b44c6be749350d75b7f9534947dec3fefce00429b  ksql-action-authoring-plugin-0.14.0.zip

kact 0.13.0

設定を直すときの往復が減りました。

今の設定を、アプリ番号から直に読めます

これまでは、既存の設定を直すたびに利用者へ

設定画面の［設定をダウンロード］で取って、作業フォルダーに置いてください

とお願いする必要がありました。kact_pull に app（アプリ番号）を渡せば、
kintone から直に読めます。

{ "app": 1001 }   // これまでの { "from": "inbox/..." } の代わり

• 既定は動作テスト環境（設定画面が編集しているほう）。運用環境を読むなら production: true
• どのアプリから読んだかをアプリ名つきで返します
• これは「APIラボ」（検討中の新機能）の口です。 ドメインで有効になっていないと使えません
  （アップデートオプションの「検討中の新機能」）。使えないときはこれまでどおり from で進めてください
• **プラグイン本体が Ver.1 の新しい zip（オーサリング API 版 10 以降）**であることも要ります
• kintone には書き込みません。 取り込みはこれまでどおり利用者が設定画面で行います

区分と一覧ごとの出し方を、ツールから直せます

kact_update_common を足しました。共通設定（論理アプリ・時間帯・上限・ログアプリ・
パネルと区分）を直します。アクションと共通の文には触りません。

これまで panel を書けるのは kact_save_config だけでしたが、そちらは
共通の文（messages）がある設定を丸ごと断っていたので、
共通の文を使っているアプリでは panel も上限もログアプリも一切直せませんでした。

あわせて kact_actions が今の共通設定を返すようになりました（common）。
区分の定義と一覧ごとの出し方も、ここで読めます（読めないと直しようがないため）。

• 渡したキーだけを差し替えます。入れ子（panel など）は丸ごと置き換えです
  （半端に重ねると、消したつもりの行が残って「設定したのに出ない」になります）
• 一覧ごとの出し入れは区分ごとです。ボタン 1 つだけ別の一覧に出したいなら、その区分を分けます
• panel.views に "*"（ほかの一覧すべて）の行が無い設定では、新しい一覧は行を足さないと何も出ません

資料

• **アプリは「探す前に聞く」**ようにしました。これまでは「番号が分からないときは kact_apps」と
  書いていたため、利用者に聞く前に一覧を取りに行き、候補を黙って絞ることがありました。
  名前でも番号でもよいと聞き、分からないと言われたときだけ候補を出し、どう絞ったかを言って選ばせます。
• 資料の例に出てくるアプリ番号を、そのまま設定に書かないことも明記しました。
• 既存の設定を直すときは、どのアプリの、どの設定ファイルかを先に確かめます
  （作業フォルダーのいちばん新しいファイルから決めない）。

入れ方

Claude Desktop: ksql-action-authoring-0.13.0.mcpb をダウンロードしてダブルクリック。

Claude Code:

/plugin marketplace update rex0220-ksql-action
/plugin install ksql-action@rex0220-ksql-action

要るもの

kSQL アクションプラグイン	Ver.1 以降。kact_pull の app にはオーサリング API 版 10 以降の zip が要ります
kintone	app を使うには、ドメインでAPIラボ（アップデートオプションの「検討中の新機能」）が有効であること

sha256

c4921a8d48ba1053de20ac0f1716ce8536b767c2de699b259448a822252bb7cd  ksql-action-authoring-0.13.0.mcpb
a767f97909547dbca1932617344d0eba21138f1b7c9b78e440a26eb27fc2badb  ksql-action-authoring-plugin-0.13.0.zip

kact 0.12.0

共通の文（$m_…）を使う式を kact_try で試せるようになりました。

これまでは、messages に正しく定義した文でも

$m_done → getVal FIELD CODE NOT FOUND: $m_done

で落ちていました。試し計算のときだけ共通の文を渡しておらず、$m_… という擬似項目が
1 つも無い状態で評価していたためです（検査〈kact_check〉は 0.11.1 で直していましたが、
試し計算に同じ穴が残っていました）。

使い方

file（設定ファイル）と、式ごとの slot（どの口に書く式か）を渡します。

{
  "app": 1001,
  "file": "settings/kact-1001.json",
  "formulas": [
    { "formula": "REPLACE($m_done, \"{n}\", $result_total)", "slot": "resultMessage" }
  ],
  "result": { "$result_total": 12 }
}
// → "12 件を書き込みました"

• 文は設定ファイルから読みます（文そのものは返りません）。lang で ja / en / zh を切り替えられます。
• slot を書くと、その口で本当に使える擬似項目だけで評価します
  （$m_… は execNgMessage / resultMessage / optionLabelsFormula の 3 つだけ、
  $result_* は resultMessage だけ、$val / $lno はパラメーターの式だけ）。
  kact_try では通るのに kact_check が拒む式を作れないようにするためです。
• 使えない口に値を渡したときは、入れずに slot-not-allowed でどこなら書けるかを返します（黙って落としません）。
• slot を書かない式はこれまでどおりです（$m_… は入らず、slot-missing で知らせます）。

入れ方

Claude Desktop: ksql-action-authoring-0.12.0.mcpb をダウンロードしてダブルクリック。

Claude Code:

/plugin marketplace update rex0220-ksql-action
/plugin install ksql-action@rex0220-ksql-action

要るもの

kSQL アクションプラグイン	Ver.1 以降（オーサリング API 版 1〜9）。file を使うには版 7 以降の zip が要ります

sha256

df6f54a412b2b2d4d78fdb4b81e9b69fdcc5f329add313d05d8570eb16e08a57  ksql-action-authoring-0.12.0.mcpb
cbec13706d35c6bb97eec34c674887f9459fa3e3b111012256e4cbea590ed812  ksql-action-authoring-plugin-0.12.0.zip

kact 0.11.3

0.11.2 で足した「領域（ゲストスペース）の検査」が、いちばん肝心な場合に効いていませんでした。

通常領域のアプリからゲストスペースのアプリを論理アプリに登録しても、
エラー（binding-area）ではなく「確かめられなかった」（binding-area-unknown）にしかなりませんでした。
突き合わせの鍵を接続の profile にしていたためです。接続のファイルの profile は
ホストとゲストスペースの組なので、ゲストスペースのアプリは必ず別の profileになり、
「接続先が違うから比べられない」に落ちていました。

鍵を host（ドメイン）に直しました。 同じドメインなら profile が違っても領域を比べます。
違うドメインの同じアプリ番号は別のアプリなので、これまでどおり比べません。

0.11.2 をお使いの方へ: 領域の取り違えは設定画面の［保存する］が必ず止めるので、
間違った設定が実機に入ることはありません（ツールが先に気づけなかっただけです）。

0.11.2 のそのほかの中身は v0.11.2 のノート を見てください。

入れ方

Claude Desktop: ksql-action-authoring-0.11.3.mcpb をダウンロードしてダブルクリック。

Claude Code:

/plugin marketplace update rex0220-ksql-action
/plugin install ksql-action@rex0220-ksql-action

要るもの

kSQL アクションプラグイン	Ver.1 以降（オーサリング API 版 1〜9）。zip の場所を設定します

sha256

128d2eefa23871a4284883a27455433f35ac6ae4487973b00db6288ba128b3a0  ksql-action-authoring-0.11.3.mcpb
822334bee05832b8da9e5412073e506427851cf96dbd3aee0755801f824b0f2b  ksql-action-authoring-plugin-0.11.3.zip

kact 0.11.2

検査が黙って抜けていたところを塞ぎました。 kact_check が ok なのに
設定画面の［保存する］で断られる設定を作れる道が、いくつも残っていました。

設定画面で断られる設定を、作る前に止めます

• 設定が大きすぎないかを測るようになりました（config-too-large）。これまでは
  JSON ファイルの生の大きさしか見ておらず、kintone の壁（圧縮後 256 KB）とは別のものでした。
  設定画面と同じやり方（圧縮してから測る）にそろえています。
  あわせて、kintone が受け付ける大きな設定をツールだけが断っていたのも直しました。
• 論理アプリが自アプリと違う領域（ゲストスペース）にあると止めます（binding-area）。
  業務アプリに選べるのは自アプリと同じ領域のアプリだけで、設定画面の保存でも断られます。
  kact_fields の控えから通信せずに見ます（古い控えには領域が入っていないので、
  そのときは binding-area-unknown で「確かめていない」と言います。取り直すと確かめられます）。
• ログアプリに自アプリを指定していると止めます（log-app-self）。

「確かめていないこと」を黙らなくなりました

findings が空だと「検査して問題なし」と読まれます。ツールにできない検査は、できないと言います。

• ログアプリそのものは確かめていません（log-app-unverified）。設定画面の［保存する］は
  ログアプリに実際に 1 件書いて診断します（項目の型が配布テンプレートと合うか・
  設定を保存する人が読み書きできるか・job_key に「値の重複を禁止する」があるか）。
  ツールは読み取りしかしないので、取り込んだ後にここで断られることがあります。
• 同じアプリ番号の項目定義の控えがほかにもあるときに知らせます（fields-ambiguous）。
  接続先が違えば、同じアプリ番号は別のアプリです。黙って新しいほうを選ばなくなりました。
• 動作テスト環境の控えが、運用環境の控えを上書きしなくなりました（APP<番号>-preview.json と
  別のファイルにします）。これまでは preview: true で取ると黙って入れ替わっていました。

直した不具合

• 「残っているだけで効かない式」で保存できなくなっていました。 渡し方を「グループごと」から
  変えた後の groupFormula や、使っていない loop が残っていると、検査が止めていました
  （設定画面は見ません）。エラーが 1 つあると kact_update_action は何も書けなくなるので、
  設定を編集できない状態になっていました。
• ループのアクションで $result_runs などが「無い項目」になっていました。
• 選択肢の定義に無い値の検査（0.10.0 で足したもの）が、一度も動いていませんでした。
  形の違う値を渡していたため、黙って何もしていませんでした。
• kact_update_action の差分に、記録の範囲（eventLog）の変更が出ていませんでした。
  ログアプリの変更も「あり → あり」としか出ませんでした。
• kact_save_config が messages（共通の文）を黙って書けていました。 資料は
  「ツールからは足せない」と書いているのに、渡せば通っていました。messages-not-writable で断ります。
• 古い zip でも「対応している」と名乗れてしまう口がありました。（API の版 3 と版 8）。
  口が欠けていると、kact_explain がその場で落ちたり、選択肢の検査が黙って効かなくなったりします。

資料

• m_ 始まりは、パラメーターと入力項目の名前にも使えません（［メッセージ］の共通の文のために予約）。
• キーの配列（source: "keys"）には計算式が必須です（空だと何も渡りません）。
• kact_check は「設定画面の保存とまったく同じ規則」ではありません。 書き込みを伴う検査
  （ログアプリへの試し書き・論理アプリの存在）は設定画面にしかできません。表にしました。
• @NOW() の書き方、一覧の区分（views[].sections）、パネルを省いたときの既定、
  SET にサブクエリを書けないこと、保存できない選択の例を直しました。

入れ方

Claude Desktop: ksql-action-authoring-0.11.2.mcpb をダウンロードしてダブルクリック。

Claude Code:

/plugin marketplace add rex0220/ksql-action-authoring
/plugin install ksql-action@rex0220-ksql-action

すでに入れている場合は /plugin marketplace update rex0220-ksql-action の後に入れ直してください。

要るもの

kSQL アクションプラグイン	Ver.1 以降（オーサリング API 版 1〜9）。zip の場所を設定します
Claude Desktop	拡張機能（.mcpb）が使える版
Claude Code	プラグイン（marketplace）が使える版

sha256

0ab8dfe752df18cc9f6cca7eaa38fc80d4899d32c4e74553d0617c93c212fe25  ksql-action-authoring-0.11.2.mcpb
a7fec881e677549a34c8f2137b49882309b42de5b11379100f4e96b5c7599845  ksql-action-authoring-plugin-0.11.2.zip

kact 0.11.1

共通の文（$m_…）を使う設定が、ひとつも保存できませんでした。 その直しをまとめた版です。

何が起きていたか

0.10.0 で対応したはずの共通の文（設定画面のツールバーの［メッセージ］で足して、execNgMessage や resultMessage から $m_… で呼ぶ文）は、オーサリングツールからは使えない状態でした。

messages に正しく定義したコードでも、こう言われて保存できません。

execNgMessage（実行条件 NG のメッセージ）: 「$m_no_amount」という項目も関数も無い

式を検査するときに共通の文を渡しておらず、$m_… という擬似項目が 1 つも無い状態で見ていたためです。あわせて、NG のメッセージと選択肢のラベルの検査が、設定画面とは違う文脈を使っていました。

0.11.1 で、設定画面と同じように書けます。

そのほかの直し

• アクションのコードを変えたとき（kact_update_action の replaceCode）、返りの changes にコードの変更が出ていませんでした。コードはロックキーとログの名前なので、いちばん重い変更が見えていませんでした。
• 検査の指摘に手がかりを足しました。 _result_*（0.9.0 で $result_* に変えた古い名前）・$val / $lno・$m_… を書いて「項目も関数も無い」と言われたとき、何の話かが分かります。

資料

• UPDATE にも WHERE が必須だと書いていませんでした（DELETE だけ書いてありました）。
• 選択肢は、利用者が表示名で言ってくることがあります。kact_fields が返す値に無ければ表示名を疑い、確かめてから書いてください。計算式の口に書いても静的な検査は出ません。
• 「金額が入っているときだけ」の例が 金額 > 0 でしたが、これは 0 円も弾きます。「空でない」は 金額 <> "" です。
• もとからエラーのある設定には、アクションを 1 つも足せません（検査は設定全体に掛かるため）。先に設定画面で直してから取り直してください。
• kact_update_action は、同じコードの行があれば渡したキーだけを重ねます（「足りないキーは既定値で埋まる」と書いていたので、1 項目だけ直すと残りが消えると読めました）。
• UPSERT のキーに選択肢は使えないことと、ステータス別の集計の例。

---

配布物

ファイル	sha256
ksql-action-authoring-0.11.1.mcpb	4db32b4a5f11d86bf869a8c89a7bce24c102492bc272003019c79df721946d14
ksql-action-authoring-plugin-0.11.1.zip	a1c8983c2d0091d2fbc34a89e42b0d96ddeccca7d2a147bcce7f002d5e2088a0

要るもの

• kSQL アクションプラグイン Ver.1 以降の zip（アプリに入れたものと同じ版。試用版でよい）。zip が無いと何も動きません
• Claude Desktop（.mcpb）または Claude Code（プラグイン。1 行で入れるには 2.1.275 以降）
• Node.js は、サポートが続いている系列（22 以降）の最新の修正版を勧めます
• オーサリング API の版は 1〜9 に対応します（古い zip でも動きます）

入れ方

• Claude Desktop: ksql-action-authoring-0.11.1.mcpb をダウンロードしてダブルクリック。設定で、作業フォルダー・プラグインの zip・kintone の接続のファイルを選びます
• Claude Code: /plugin install ksql-action --marketplace rex0220/ksql-action-authoring（2.1.275 より前は /plugin marketplace add rex0220/ksql-action-authoring → /plugin install ksql-action@rex0220-ksql-action）。そのあと /config で、プラグインの zip と kintone の接続のファイル。作業フォルダーは Claude Code を起動したフォルダーです
• すでに入れている方は /plugin marketplace update rex0220-ksql-action → /plugin update ksql-action

kact 0.11.0

検査の指摘が読める文になりました。

これまでと、これから

設定の検査でひっかかったときに出るのが、これまではこれだけでした。

pInputTypeMismatch  min / text

コードと値が素で並ぶだけなので、何がいけないのか分かりませんでした。これからは、プラグインの設定画面に出るのと同じ文が出ます。

@min: 数値で宣言した変数（DECLARE @min = 0）には「数値」の入力項目を当ててください
（今は「文字列」）。文字は数値に変換されず、そのまま条件に使われます

入力項目の種類も、コードの text ではなく設定画面と同じ「文字列」で出ます。

文はプラグイン本体が持っているものをそのまま使います。このツールの中に文を写していないので、設定画面と 1 字も違いませんし、本体を直せばこちらも直ります。

要るもの

オーサリング API の版 9（kSQL アクションプラグイン Ver.1 以降）の zip でこの文が出ます。古い zip でもこれまでどおり動きます（文が素のままになるだけで、検査の結果は変わりません）。

---

配布物

ファイル	sha256
ksql-action-authoring-0.11.0.mcpb	05ea7d4d1195c30b0bf42ac96689700ab06da1eb578aebf63001b80cf7cc962a
ksql-action-authoring-plugin-0.11.0.zip	11b6aacf5a2e47e10f3d698f5ae89ea528adbd835553402c2869654418300579

要るもの（そのほか）

• kSQL アクションプラグイン Ver.1 以降の zip（アプリに入れたものと同じ版。試用版でよい）。zip が無いと何も動きません
• Claude Desktop（.mcpb）または Claude Code（プラグイン。1 行で入れるには 2.1.275 以降）
• Node.js は、サポートが続いている系列（22 以降）の最新の修正版を勧めます

入れ方

• Claude Desktop: ksql-action-authoring-0.11.0.mcpb をダウンロードしてダブルクリック。設定で、作業フォルダー・プラグインの zip・kintone の接続のファイルを選びます
• Claude Code: /plugin install ksql-action --marketplace rex0220/ksql-action-authoring（2.1.275 より前は /plugin marketplace add rex0220/ksql-action-authoring → /plugin install ksql-action@rex0220-ksql-action）。そのあと /config で、プラグインの zip と kintone の接続のファイル。作業フォルダーは Claude Code を起動したフォルダーです
• すでに入れている方は /plugin marketplace update rex0220-ksql-action → /plugin update ksql-action

kact 0.10.1

0.10.0 で入れた「選択肢に定義に無い値を書いていたら知らせる」が動いていませんでした。直した版です。0.10.0 をお使いの方は入れ替えてください。

選択肢の検査が鳴っていませんでした

kact_check と保存が、項目定義の控えを渡し間違えていました。渡すべきは「アプリ番号 → 項目定義」なのに、「項目コード → 定義」（自アプリのぶん）を渡していたため、検査が選択肢を 1 つも見つけられず、注意（choice-unknown）が一度も出ませんでした。わざと定義外の値を書いた設定 5 本でも、黙ったままでした。

控えを集める口を 1 つにまとめ、検査・保存・実行計画の 3 か所が同じ形を使うようにしました。choice-unknown の試験も足しました（これまで 1 件もなく、だから気づけませんでした）。

これで、kintone の「言語ごとの名称」で選択肢に表示名を付けている項目に表示名のほうを書いてしまったとき（エラーにならず 0 件になる、いちばん気づきにくい間違い）に注意が出ます。SQL には kact_fields が返す既定の名称を書いてください。

プラグインの設定画面の ［SQL を検査］は 0.10.0 でも正しく動いていました。 この不具合はオーサリングツール側だけです。

資料の直し 2 件と注意 1 つ

実際に設定を作ってみて（試用シナリオ S5）見つけた分です。

• 「グループごと」の例が、そのままでは保存できませんでした（params に対応する DECLARE が無く、種類も廃止済みの書き方のままでした）。予約名だけを使うなら params は空でよいことも書きました
• UPDATE … APPLY の親の SET に、ほかのアプリを読むサブクエリは書けません。 保存は通るのに、実行計画と実行で落ちます（SET の右辺はサブクエリの中まで親アプリの項目として確かめられるため）。書ける形（先に SET @cnt = (SELECT …) で変数に取る）を資料に足しました
• 注意 wListApplyLoop: 一覧の「1 件ずつ」で、テーブルを全置換する APPLY を書いているときに知らせます（選んだ件数ぶん同じ親を上書きして、最後の 1 件しか残りません）

試験は 114 → 116 件です。

---

配布物

ファイル	sha256
ksql-action-authoring-0.10.1.mcpb	6332975cf83b16740f738c4850af7856374644f7bec89483a6af05b7c554a136
ksql-action-authoring-plugin-0.10.1.zip	03f72bb2e5135b2c9dab338b753109f59b6410ecc657f18b32f8781db2139b2e

要るもの

• kSQL アクションプラグイン Ver.1（オーサリング API の版 8）以降の zip（アプリに入れたものと同じ版。試用版でよい）。zip が無いと何も動きません
• Claude Desktop（.mcpb）または Claude Code（プラグイン。1 行で入れるには 2.1.275 以降）
• Node.js は、サポートが続いている系列（22 以降）の最新の修正版を勧めます

入れ方

• Claude Desktop: ksql-action-authoring-0.10.1.mcpb をダウンロードしてダブルクリック。設定で、作業フォルダー・プラグインの zip・kintone の接続のファイルを選びます
• Claude Code: /plugin install ksql-action --marketplace rex0220/ksql-action-authoring（2.1.275 より前は /plugin marketplace add rex0220/ksql-action-authoring → /plugin install ksql-action@rex0220-ksql-action）。そのあと /config で、プラグインの zip と kintone の接続のファイル。作業フォルダーは Claude Code を起動したフォルダーです
• すでに入れている方は /plugin marketplace update rex0220-ksql-action → /plugin update ksql-action