[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7F35W7NEQEK4NAWS2AP3SFR":3,"skill-same:01M7F35W7NEQEK4NAWS2AP3SFR":55},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7F35W7NEQEK4NAWS2AP3SFR","cli-design",null,"cli-design で CLI を設計・変更・実装する手順。「〜を管理する CLI を設計して」「〜する1コマンドのツールの仕様を作って」「notes に期限の項目を足して」「note list に絞り込みのオプションを追加して」「このコマンドを消して」「この仕様をリリースして」「この設計を Go で実装して」「実装が仕様どおりか確かめて」のように、この基盤で CLI の仕様（specs\u002F\u003Cname>\u002Fcli.json）を作る・変える・実装する依頼では、依頼の大小にかかわらず必ず使う。依頼をパターンに振り分け、生成器（make new・make command・make field）から始め、make check と完了前チェックリストで確かめてから報告する。","yukihito-jokyu\u002Fpattern","yukihito-jokyu","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F119581059?v=4","01M7F33N4TWR8HY2X3NV7CADSY","yukihito jokyu","01M7F33N5HYZZGF8V8K8W46GRC",0,"MIT","https:\u002F\u002Fgithub.com\u002Fyukihito-jokyu\u002Fpattern\u002Fblob\u002Fmain\u002Fpatterns\u002Fdesign\u002Fcli\u002Fcli-design\u002F.claude\u002Fskills\u002Fcli-design\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: cli-design\ndescription: cli-design で CLI を設計・変更・実装する手順。「〜を管理する CLI を設計して」「〜する1コマンドのツールの仕様を作って」「notes に期限の項目を足して」「note list に絞り込みのオプションを追加して」「このコマンドを消して」「この仕様をリリースして」「この設計を Go で実装して」「実装が仕様どおりか確かめて」のように、この基盤で CLI の仕様（specs\u002F\u003Cname>\u002Fcli.json）を作る・変える・実装する依頼では、依頼の大小にかかわらず必ず使う。依頼をパターンに振り分け、生成器（make new・make command・make field）から始め、make check と完了前チェックリストで確かめてから報告する。\n---\n\n# cli-design の設計手順\n\nこの基盤では、CLI の「外から見える形」（コマンド、位置引数、オプション、出力、終了コード、環境変数）を、言語に依存しない仕様 `specs\u002F\u003Cname>\u002Fcli.json` として設計する。実装はこの仕様と、生成されたリファレンス `specs\u002F\u003Cname>\u002Fcli.md` に従って、各言語の標準ライブラリで行う。\n\nこのスキルは次の資料と一緒に使う。パスは基盤のルートからの相対パスである。\n\n- `docs\u002Fdesign\u002Frules.md`：ルールの全文。`\u003C接頭辞>-\u003C番号>` のルールIDで参照する\n- `.claude\u002Fskills\u002Fcli-design\u002Freferences\u002Fpatterns.md`：パターンごとの手順と、作るファイルの一覧\n- `.claude\u002Fskills\u002Fcli-design\u002Freferences\u002Fstdlib-mapping.md`：仕様を各言語の標準ライブラリで実装する対応表\n- 見本：`specs\u002Fnotes\u002F`（サブコマンドを持つ CLI）、`specs\u002Fcount-words\u002F`（サブコマンドを持たない CLI）、`tools\u002Fclispec\u002Ftests\u002Ffixtures\u002F`（見本の実装）\n\n既存の仕様と rules.md が食い違ったら rules.md に従い、食い違いを報告に書く。\n\n配布用の`ci.json`と`.ci\u002F`はZIPを検証する入口であり、設計するCLIの実装の置き場ではない（STR-01、ADR 0008）。\n\n## 1. 依頼をパターンに振り分ける\n\n| 依頼に含まれること | patterns.md の節 |\n|---|---|\n| 何かを記録・管理する新しい CLI（操作が2つ以上） | 1 |\n| 1回の変換・集計・出力だけを行う新しい CLI（操作が1つ） | 2 |\n| 既存の CLI への新しい対象（名詞）や操作（動詞）の追加 | 3 |\n| 既存の対象への新しい属性（項目）の追加 | 4 |\n| 既存のコマンドへの絞り込み・標準のオプション・環境変数の追加、説明の文の変更 | 5 |\n| コマンド・オプション・項目の削除、名前や型の変更、必須の追加 | 6 |\n| 版の確定・公開・リリース | 7 |\n| 仕様の実装、実装が仕様どおりかの確認 | 8 |\n| 検査ツールの Python・uv の版を上げる | 9 |\n\n- 複数の行に当たる場合は、表の上から順に全部行う（例：項目を足して絞り込みも足す → 4 → 5）\n- どの行にも当たらない場合（設定ファイル、対話の入力、色、3段のサブコマンド、ルールの変更など）は、実装しない。必要なパターンとルールを提案として報告する（PROC-04）。見本に無い形をその場で発明すると、作者ごとに違う形が生まれるからである\n\n## 2. 依頼から決まらない値\n\n推測で決めない。聞ける状況ならユーザーに聞く。聞けない状況ならこの表の既定値で決め、報告の3に書く。\n\n| 決めること | 何に響くか | 既定値 |\n|---|---|---|\n| CLI 名 | `name`、ディレクトリ、環境変数の接頭辞 | 依頼が指定した名前。無ければ、サブコマンドを持つ CLI は依頼に最初に出る名詞の英語の複数形（`notes`）、持たない CLI は `\u003C動詞>-\u003C目的語の複数形>`（`count-words`）（NAM-02） |\n| 操作が1つか2つ以上か | 構成（STR-05） | 依頼が対象を記録・管理するなら2つ以上、入力を1回変換・集計して出すだけなら1つ |\n| 名詞 | `path`、型の名前 | 依頼の対象を表す英語の単数形の1語（`bookmark`）。2語の対象は主となる1語（「読書リストの本」→ `book`） |\n| 名詞ごとの動詞 | コマンド | 依頼が「管理する」とだけ言うなら `create`・`list`・`view`・`edit`・`delete` の5つ。操作を列挙していれば、その操作に当たる標準の動詞だけ（NAM-04 の表）。表に無い操作は英小文字1語の動詞 |\n| 識別子 | `id` か `name` | 依頼が「名前で指定する」「名前は重複しない」と書いていれば `name`（`KEY=name`）、それ以外は `id` |\n| 項目 | 型の `fields` | 依頼に出る属性だけ。`id`・`name`・`created_at`・`updated_at` は生成器が足す |\n| 項目の型 | `TYPE=` | 日付 → `date`（名前は `\u003C意味>_date`）、日時 → `timestamp`（`\u003C意味>_at`）、件数・番号 → `integer`、金額・割合 → `number`、はい・いいえ → `boolean`、依頼が選択肢を列挙した値 → `enum`、それ以外（URL、メモ、名前）→ `string`（CODE-02） |\n| 項目が複数の値か | `LIST=1` | 依頼が複数持つと書いた属性（タグ、ラベル）だけ。名前は複数形 |\n| 項目が空を許すか | `NULLABLE=1` | 依頼が「任意」「省略できる」「後で設定する」と書いた属性、または既存の CLI に足す属性で依頼が既定値を決めていないもの |\n| `create` の必須の値の既定値 | `required`・`default` | 依頼が既定値を書いていればその値（`\"required\": false`）、無ければ必須（`\"required\": true`、`\"default\": null`）（NAM-07） |\n| 絞り込みのオプション | `list` の `--\u003C項目>` | 依頼が「〜で絞り込む」「〜だけを表示する」と書いた項目だけ。値が一致するものなら `--\u003C項目>`、範囲（「〜以降」「〜まで」「〜より前」「期間」「〜以上」「〜以下」）なら片側だけを求められても `--\u003C項目>-from` と `--\u003C項目>-to` の2つ組（`date`・`integer`・`number` の項目だけ。NAM-07） |\n| 件数の上限と並び順 | `list` の `--limit`・`--sort` | 生成器が足す値のまま（20、識別子の順） |\n| 確認が要る操作 | `-f\u002F--force` | 一度に複数件を消す・変える操作にだけ付ける。1件の `delete` には付けない（STATE-01） |\n| 環境変数 | `env` | データの置き場（生成器が足す）だけ。オプションの既定値を変える環境変数は、依頼が求めたときだけ |\n| サブコマンドを持たない CLI の入出力 | 位置引数、`-o\u002F--output` | 読むファイルは `file` 型の位置引数 `file`（複数なら `variadic`）。依頼が結果をファイルに書くことを求めたときだけ `-o\u002F--output` を置き、求めていなければ stdout に書く。`-` は stdin・stdout |\n| サブコマンドを持たない CLI の出力の型の名前 | `types` | 1行が表すものを snake_case で（単語の出現回数の行なら `word_count`） |\n| 自由な summary | ヘルプの文面 | 英語の1文。大文字で始め、ピリオドを付けず、既定値・選択肢を書かない（CODE-04、CODE-05） |\n| 版 | `version` | 新しい CLI は `1.0.0`。変更したら `make fix` が決める（PROC-06） |\n\n## 3. 書く前に読む\n\n1. patterns.md の該当する節を最後まで読む\n2. rules.md のうち、次の表の接頭辞の節をすべて読む\n\n   | パターン | 読む接頭辞 |\n   |---|---|\n   | 1、2 | STR、NAM、CODE、ERR、STATE、OPS |\n   | 3、4、5 | NAM、CODE、ERR、STATE、PROC |\n   | 6、7 | STR、PROC |\n   | 8 | DEP、ERR、OPS、STATE、TEST |\n   | 9 | PROC、TOOL |\n\n3. 見本の該当ファイル（patterns.md の「見本」）を開き、キーの書き方・summary の文・オプションの組を確かめる\n\n## 4. 作る順序\n\nPROC-01 の順で作る。生成器を使わずに `cli.json` を白紙から書かない（STR-02）。\n\n1. 依頼から、CLI 名・名詞・動詞・項目を2節の表で書き出す\n2. `make new NAME=\u003Cname>`（操作が1つなら `SINGLE=1`）\n3. 名詞ごとに `make command NAME=\u003Cname> NOUN=\u003C名詞> VERB=\u003C動詞>`（識別子が `name` なら最初に `KEY=name`）\n4. 名詞ごとに `make field NAME=\u003Cname> NOUN=\u003C名詞> FIELD=\u003C項目名> TYPE=\u003C型>`（`LIST=1`・`NULLABLE=1`・`VALUES=a,b`）\n5. `cli.json` の `TODO` を埋め、依頼の既定値・絞り込み・標準のオプションを足す\n6. 環境変数を STATE-01 で足す（必要なときだけ）\n7. `make fix`（整形、版、`cli.md` の生成）\n8. `make check`\n\n`cli.json` を編集して保存するたびに、hooks が `make after-edit` で整形・版・`cli.md` の生成・その仕様の検査を回す（TOOL-02）。指摘が出たら、次の編集に進む前に直す。\n\n## 5. 検証する\n\n1. `make check` を実行する\n2. 落ちたら、エラーの先頭のルールID（`NAM-07 specs\u002Fnotes\u002Fcli.json:42 ...`）を rules.md で引き、`cli.json` を直す。エラー文に期待する値が書いてあれば、その値にする\n3. 次の方法で検査を黙らせない（TOOL-03）\n   - 検査ツール（`tools\u002F`）、`Makefile`、`.foundation\u002F`、`docs\u002Fdesign\u002Frules.md` などの保護ファイルを変える\n   - 仕様に表に無いキー（`x-`、`_`、`$comment`）を書く\n   - Python に抑止コメント（`# noqa` など）やテストの skip を書く\n\n   どうしても直せない場合は、その状態のまま報告する\n4. 実装の依頼（パターン 8）では、`make conform SPEC=specs\u002F\u003Cname>\u002Fcli.json CMD=\"\u003C起動コマンドの絶対パス>\"` を全項目通す（TEST-01）\n\n## 6. 完了前チェックリスト\n\n該当するファイルを開き、1つずつ確かめる。\n\n- [ ] 依頼文の操作・対象・属性・絞り込みの1つ1つが、`cli.json` のコマンド・型・項目・オプションにある。依頼に無いものを足していない\n- [ ] `cli.json` に `TODO` が残っていない（STR-02）\n- [ ] `cli.md` を `make fix` で作り直し、手で直していない（STR-04）。`released\u002F` のファイルを変えていない\n- [ ] `version` が `make fix` の書いた値である。メジャーを上げた場合は、ユーザーの承認を書いた ADR が同じ変更にある（PROC-06）\n- [ ] CLI 名を NAM-02 の表で選んだ（依頼の指定 → 最初の名詞の複数形 → `\u003C動詞>-\u003C目的語の複数形>`）\n- [ ] 各項目・オプションの型が値の意味に合っている（日付が `string` になっていない。CODE-02）\n- [ ] 一度に複数件を消す・変える操作に `-f\u002F--force` がある（STATE-01）\n- [ ] ファイルに書くコマンドは、データの置き場（`storage` が `data`）か `-o\u002F--output` だけに書く（DEP-05）\n- [ ] 実装の依頼では、仕様に無いオプション・別名・環境変数を実装に足していない（DEP-02）\n- [ ] 保護ファイル（`.foundation\u002Fmanifest.json` の `protected`）を変えていない（TOOL-03）\n- [ ] `make check` が通った（PROC-05）\n\n## 7. 報告する\n\n次の順で書く（PROC-05）。\n\n1. 何を作ったか（使ったパターンの番号と名前）\n2. 変えたファイルの一覧（作る順序の順）と、使った生成器のコマンド\n3. 2節で決めた値と、その根拠（依頼文、ユーザーの回答、既定値のどれか）\n4. `make check` の結果（出力の末尾）。実装の依頼では `make conform` の結果\n5. 決めきれずに残したこと、ルールと既存の仕様の食い違い、レジストリで CLI 名が空いているかの確認（この基盤は確かめない）\n","# cli-design の設計手順\n\nこの基盤では、CLI の「外から見える形」（コマンド、位置引数、オプション、出力、終了コード、環境変数）を、言語に依存しない仕様 `specs\u002F\u003Cname>\u002Fcli.json` として設計する。実装はこの仕様と、生成されたリファレンス `specs\u002F\u003Cname>\u002Fcli.md` に従って、各言語の標準ライブラリで行う。\n\nこのスキルは次の資料と一緒に使う。パスは基盤のルートからの相対パスである。\n\n- `docs\u002Fdesign\u002Frules.md`：ルールの全文。`\u003C接頭辞>-\u003C番号>` のルールIDで参照する\n- `.claude\u002Fskills\u002Fcli-design\u002Freferences\u002Fpatterns.md`：パターンごとの手順と、作るファイルの一覧\n- `.claude\u002Fskills\u002Fcli-design\u002Freferences\u002Fstdlib-mapping.md`：仕様を各言語の標準ライブラリで実装する対応表\n- 見本：`specs\u002Fnotes\u002F`（サブコマンドを持つ CLI）、`specs\u002Fcount-words\u002F`（サブコマンドを持たない CLI）、`tools\u002Fclispec\u002Ftests\u002Ffixtures\u002F`（見本の実装）\n\n既存の仕様と rules.md が食い違ったら rules.md に従い、食い違いを報告に書く。\n\n配布用の`ci.json`と`.ci\u002F`はZIPを検証する入口であり、設計するCLIの実装の置き場ではない（STR-01、ADR 0008）。\n\n## 1. 依頼をパターンに振り分ける\n\n| 依頼に含まれること | patterns.md の節 |\n|---|---|\n| 何かを記録・管理する新しい CLI（操作が2つ以上） | 1 |\n| 1回の変換・集計・出力だけを行う新しい CLI（操作が1つ） | 2 |\n| 既存の CLI への新しい対象（名詞）や操作（動詞）の追加 | 3 |\n| 既存の対象への新しい属性（項目）の追加 | 4 |\n| 既存のコマンドへの絞り込み・標準のオプション・環境変数の追加、説明の文の変更 | 5 |\n| コマンド・オプション・項目の削除、名前や型の変更、必須の追加 | 6 |\n| 版の確定・公開・リリース | 7 |\n| 仕様の実装、実装が仕様どおりかの確認 | 8 |\n| 検査ツールの Python・uv の版を上げる | 9 |\n\n- 複数の行に当たる場合は、表の上から順に全部行う（例：項目を足して絞り込みも足す → 4 → 5）\n- どの行にも当たらない場合（設定ファイル、対話の入力、色、3段のサブコマンド、ルールの変更など）は、実装しない。必要なパターンとルールを提案として報告する（PROC-04）。見本に無い形をその場で発明すると、作者ごとに違う形が生まれるからである\n\n## 2. 依頼から決まらない値\n\n推測で決めない。聞ける状況ならユーザーに聞く。聞けない状況ならこの表の既定値で決め、報告の3に書く。\n\n| 決めること | 何に響くか | 既定値 |\n|---|---|---|\n| CLI 名 | `name`、ディレクトリ、環境変数の接頭辞 | 依頼が指定した名前。無ければ、サブコマンドを持つ CLI は依頼に最初に出る名詞の英語の複数形（`notes`）、持たない CLI は `\u003C動詞>-\u003C目的語の複数形>`（`count-words`）（NAM-02） |\n| 操作が1つか2つ以上か | 構成（STR-05） | 依頼が対象を記録・管理するなら2つ以上、入力を1回変換・集計して出すだけなら1つ |\n| 名詞 | `path`、型の名前 | 依頼の対象を表す英語の単数形の1語（`bookmark`）。2語の対象は主となる1語（「読書リストの本」→ `book`） |\n| 名詞ごとの動詞 | コマンド | 依頼が「管理する」とだけ言うなら `create`・`list`・`view`・`edit`・`delete` の5つ。操作を列挙していれば、その操作に当たる標準の動詞だけ（NAM-04 の表）。表に無い操作は英小文字1語の動詞 |\n| 識別子 | `id` か `name` | 依頼が「名前で指定する」「名前は重複しない」と書いていれば `name`（`KEY=name`）、それ以外は `id` |\n| 項目 | 型の `fields` | 依頼に出る属性だけ。`id`・`name`・`created_at`・`updated_at` は生成器が足す |\n| 項目の型 | `TYPE=` | 日付 → `date`（名前は `\u003C意味>_date`）、日時 → `timestamp`（`\u003C意味>_at`）、件数・番号 → `integer`、金額・割合 → `number`、はい・いいえ → `boolean`、依頼が選択肢を列挙した値 → `enum`、それ以外（URL、メモ、名前）→ `string`（CODE-02） |\n| 項目が複数の値か | `LIST=1` | 依頼が複数持つと書いた属性（タグ、ラベル）だけ。名前は複数形 |\n| 項目が空を許すか | `NULLABLE=1` | 依頼が「任意」「省略できる」「後で設定する」と書いた属性、または既存の CLI に足す属性で依頼が既定値を決めていないもの |\n| `create` の必須の値の既定値 | `required`・`default` | 依頼が既定値を書いていればその値（`\"required\": false`）、無ければ必須（`\"required\": true`、`\"default\": null`）（NAM-07） |\n| 絞り込みのオプション | `list` の `--\u003C項目>` | 依頼が「〜で絞り込む」「〜だけを表示する」と書いた項目だけ。値が一致するものなら `--\u003C項目>`、範囲（「〜以降」「〜まで」「〜より前」「期間」「〜以上」「〜以下」）なら片側だけを求められても `--\u003C項目>-from` と `--\u003C項目>-to` の2つ組（`date`・`integer`・`number` の項目だけ。NAM-07） |\n| 件数の上限と並び順 | `list` の `--limit`・`--sort` | 生成器が足す値のまま（20、識別子の順） |\n| 確認が要る操作 | `-f\u002F--force` | 一度に複数件を消す・変える操作にだけ付ける。1件の `delete` には付けない（STATE-01） |\n| 環境変数 | `env` | データの置き場（生成器が足す）だけ。オプションの既定値を変える環境変数は、依頼が求めたときだけ |\n| サブコマンドを持たない CLI の入出力 | 位置引数、`-o\u002F--output` | 読むファイルは `file` 型の位置引数 `file`（複数なら `variadic`）。依頼が結果をファイルに書くことを求めたときだけ `-o\u002F--output` を置き、求めていなければ stdout に書く。`-` は stdin・stdout |\n| サブコマンドを持たない CLI の出力の型の名前 | `types` | 1行が表すものを snake_case で（単語の出現回数の行なら `word_count`） |\n| 自由な summary | ヘルプの文面 | 英語の1文。大文字で始め、ピリオドを付けず、既定値・選択肢を書かない（CODE-04、CODE-05） |\n| 版 | `version` | 新しい CLI は `1.0.0`。変更したら `make fix` が決める（PROC-06） |\n\n## 3. 書く前に読む\n\n1. patterns.md の該当する節を最後まで読む\n2. rules.md のうち、次の表の接頭辞の節をすべて読む\n\n   | パターン | 読む接頭辞 |\n   |---|---|\n   | 1、2 | STR、NAM、CODE、ERR、STATE、OPS |\n   | 3、4、5 | NAM、CODE、ERR、STATE、PROC |\n   | 6、7 | STR、PROC |\n   | 8 | DEP、ERR、OPS、STATE、TEST |\n   | 9 | PROC、TOOL |\n\n3. 見本の該当ファイル（patterns.md の「見本」）を開き、キーの書き方・summary の文・オプションの組を確かめる\n\n## 4. 作る順序\n\nPROC-01 の順で作る。生成器を使わずに `cli.json` を白紙から書かない（STR-02）。\n\n1. 依頼から、CLI 名・名詞・動詞・項目を2節の表で書き出す\n2. `make new NAME=\u003Cname>`（操作が1つなら `SINGLE=1`）\n3. 名詞ごとに `make command NAME=\u003Cname> NOUN=\u003C名詞> VERB=\u003C動詞>`（識別子が `name` なら最初に `KEY=name`）\n4. 名詞ごとに `make field NAME=\u003Cname> NOUN=\u003C名詞> FIELD=\u003C項目名> TYPE=\u003C型>`（`LIST=1`・`NULLABLE=1`・`VALUES=a,b`）\n5. `cli.json` の `TODO` を埋め、依頼の既定値・絞り込み・標準のオプションを足す\n6. 環境変数を STATE-01 で足す（必要なときだけ）\n7. `make fix`（整形、版、`cli.md` の生成）\n8. `make check`\n\n`cli.json` を編集して保存するたびに、hooks が `make after-edit` で整形・版・`cli.md` の生成・その仕様の検査を回す（TOOL-02）。指摘が出たら、次の編集に進む前に直す。\n\n## 5. 検証する\n\n1. `make check` を実行する\n2. 落ちたら、エラーの先頭のルールID（`NAM-07 specs\u002Fnotes\u002Fcli.json:42 ...`）を rules.md で引き、`cli.json` を直す。エラー文に期待する値が書いてあれば、その値にする\n3. 次の方法で検査を黙らせない（TOOL-03）\n   - 検査ツール（`tools\u002F`）、`Makefile`、`.foundation\u002F`、`docs\u002Fdesign\u002Frules.md` などの保護ファイルを変える\n   - 仕様に表に無いキー（`x-`、`_`、`$comment`）を書く\n   - Python に抑止コメント（`# noqa` など）やテストの skip を書く\n\n   どうしても直せない場合は、その状態のまま報告する\n4. 実装の依頼（パターン 8）では、`make conform SPEC=specs\u002F\u003Cname>\u002Fcli.json CMD=\"\u003C起動コマンドの絶対パス>\"` を全項目通す（TEST-01）\n\n## 6. 完了前チェックリスト\n\n該当するファイルを開き、1つずつ確かめる。\n\n- [ ] 依頼文の操作・対象・属性・絞り込みの1つ1つが、`cli.json` のコマンド・型・項目・オプションにある。依頼に無いものを足していない\n- [ ] `cli.json` に `TODO` が残っていない（STR-02）\n- [ ] `cli.md` を `make fix` で作り直し、手で直していない（STR-04）。`released\u002F` のファイルを変えていない\n- [ ] `version` が `make fix` の書いた値である。メジャーを上げた場合は、ユーザーの承認を書いた ADR が同じ変更にある（PROC-06）\n- [ ] CLI 名を NAM-02 の表で選んだ（依頼の指定 → 最初の名詞の複数形 → `\u003C動詞>-\u003C目的語の複数形>`）\n- [ ] 各項目・オプションの型が値の意味に合っている（日付が `string` になっていない。CODE-02）\n- [ ] 一度に複数件を消す・変える操作に `-f\u002F--force` がある（STATE-01）\n- [ ] ファイルに書くコマンドは、データの置き場（`storage` が `data`）か `-o\u002F--output` だけに書く（DEP-05）\n- [ ] 実装の依頼では、仕様に無いオプション・別名・環境変数を実装に足していない（DEP-02）\n- [ ] 保護ファイル（`.foundation\u002Fmanifest.json` の `protected`）を変えていない（TOOL-03）\n- [ ] `make check` が通った（PROC-05）\n\n## 7. 報告する\n\n次の順で書く（PROC-05）。\n\n1. 何を作ったか（使ったパターンの番号と名前）\n2. 変えたファイルの一覧（作る順序の順）と、使った生成器のコマンド\n3. 2節で決めた値と、その根拠（依頼文、ユーザーの回答、既定値のどれか）\n4. `make check` の結果（出力の末尾）。実装の依頼では `make conform` の結果\n5. 決めきれずに残したこと、ルールと既存の仕様の食い違い、レジストリで CLI 名が空いているかの確認（この基盤は確かめない）\n",{"name":5,"description":7},"main","c9fa22631bcf26cbe3dc98d3eee6541ec1e7425a","patterns\u002Fdesign\u002Fcli\u002Fcli-design\u002F.claude\u002Fskills\u002Fcli-design","https:\u002F\u002Fgithub.com\u002Fyukihito-jokyu\u002Fpattern","https:\u002F\u002Fyukihito-jokyu.github.io\u002Fpattern\u002F ","https:\u002F\u002Fgithub.com\u002Fyukihito-jokyu","2026-11-07 00:25:10",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add yukihito-jokyu\u002Fpattern --skill cli-design",{"tool":37,"command":38},"bunx","bunx skills add yukihito-jokyu\u002Fpattern --skill cli-design",{"tool":40,"command":41},"pnpm","pnpm dlx skills add yukihito-jokyu\u002Fpattern --skill cli-design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fyukihito-jokyu\u002Fpattern\u002Fblob\u002Fmain\u002Fpatterns\u002Fdesign\u002Fcli\u002Fcli-design\u002F.claude\u002Fskills\u002Fcli-design\u002FSKILL.md",true,[45,51],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"references\u002Fpatterns.md","REFERENCE","参考文档",12786,"https:\u002F\u002Fgithub.com\u002Fyukihito-jokyu\u002Fpattern\u002Fblob\u002Fmain\u002Fpatterns\u002Fdesign\u002Fcli\u002Fcli-design\u002F.claude\u002Fskills\u002Fcli-design\u002Freferences\u002Fpatterns.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fstdlib-mapping.md",15044,"https:\u002F\u002Fgithub.com\u002Fyukihito-jokyu\u002Fpattern\u002Fblob\u002Fmain\u002Fpatterns\u002Fdesign\u002Fcli\u002Fcli-design\u002F.claude\u002Fskills\u002Fcli-design\u002Freferences\u002Fstdlib-mapping.md",[56,63,70,77,84,91],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7F3BVTWV77RN6ENS9ARCVC5","setup","このDocusaurusパターンの初期設定・設定変更を、OSSと独自設定の台帳に沿った質問とCLIで行う。site.settings.jsonとsetup\u002Fsettings.catalog.jsonがある配布先で使用する。","https:\u002F\u002Fgithub.com\u002Fyukihito-jokyu\u002Fpattern\u002Fblob\u002Fmain\u002Fpatterns\u002Fweb\u002Fdocumentation\u002Fdocusaurus-basic\u002F.agents\u002Fskills\u002Fsetup\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7F3BEXZ9YRZC33CFGV7JPX2","sample","日付の表記を ISO 8601（YYYY-MM-DD）にそろえる見本のスキル。テストで使う。","https:\u002F\u002Fgithub.com\u002Fyukihito-jokyu\u002Fpattern\u002Fblob\u002Fmain\u002Fpatterns\u002Fdevelopment\u002Fskills\u002Fskill-tune-kit\u002Ftests\u002Ffixtures\u002Fsample-skill\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7F3AV5VMJA9Q505NE8PGEKN","skill-tune","既存の Claude Code スキルを評価データで改善する。正解データがあれば学習用・検証用・テスト用に分け、無ければ人と評価項目を決め、独立した学習と検証のラウンドを回し、最後にテスト用で測って報告する。","https:\u002F\u002Fgithub.com\u002Fyukihito-jokyu\u002Fpattern\u002Fblob\u002Fmain\u002Fpatterns\u002Fdevelopment\u002Fskills\u002Fskill-tune-kit\u002Fkit\u002Fclaude\u002Fskills\u002Fskill-tune\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7F3ADXX8ZZTNNC0R84X0RZV","review","skill-tune-kit の変更をレビューする手順。差分、プルリクエスト、ブランチ、特定のファイルのレビューを頼まれたとき、また「この実装で問題ないか確認して」「ルールに沿っているか見て」と頼まれたときは必ず使う。機械の検査を先に回し、機械で拾えないルールをルールIDごとに確かめ、固定の形式で指摘と判定を返す。","https:\u002F\u002Fgithub.com\u002Fyukihito-jokyu\u002Fpattern\u002Fblob\u002Fmain\u002Fpatterns\u002Fdevelopment\u002Fskills\u002Fskill-tune-kit\u002F.claude\u002Fskills\u002Freview\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7F39YNWYDSVCB8H5A4MMQYZ","impl","skill-tune-kit で実装・変更・追加・修正を行う手順。「検査の種類を足して」「サブコマンドを追加して」「プロンプトの文言を直して」「plan.json に項目を足して」「status の表示を変えて」「採否の規則を変えて」「〜の不具合を直して」「skill-tune の手順を直して」などの依頼で使う。この基盤のコードや配布物を書く・変える依頼では、依頼の大小にかかわらず必ず使う。依頼をパターンに振り分け、決められた順序で作り、`make check` と完了前チェックリストで確かめてから報告する。","https:\u002F\u002Fgithub.com\u002Fyukihito-jokyu\u002Fpattern\u002Fblob\u002Fmain\u002Fpatterns\u002Fdevelopment\u002Fskills\u002Fskill-tune-kit\u002F.claude\u002Fskills\u002Fimpl\u002FSKILL.md",[],[],{"skillNo":92,"name":65,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M7F39G7CX9YCJA3TMDDRE43T","議事録の日付をそろえる。議事録の整形を頼まれたときに使う。","https:\u002F\u002Fgithub.com\u002Fyukihito-jokyu\u002Fpattern\u002Fblob\u002Fmain\u002Fpatterns\u002Fdevelopment\u002Fskills\u002Fskill-harness2-kit\u002Ftests\u002Ffixtures\u002Fskills\u002Fsample\u002FSKILL.md",[],[]]