メインコンテンツへスキップ
見出し画像
Photo byfukuiseiri

非エンジニアが個人設定とSKILL.mdの組み合わせで、手のつけどころの悩みを一掃してClaude Code使用量の節約までこぎつけた話

    この記事はClaudeと相談しながら9割以上、人間が書きました。

    時間とモデルの無駄遣いにさよならしよう


    非エンジニアだけどAIに聞きまくりながらClaude Codeを使ってアプリ作りを楽しんでる皆さーん、あなた、そこのあなた!

    毎回作りたいものは頭にあるんだけど、それを実現するためには、どのツールを使ったらいいの?モデルは?プロンプトどう書いたらいい?マジどこから手を付けたらいいの…と頭を悩ませていませんか?

    私は悩んでました!
    少なくとも、毎回30秒は。
    なんならもっと!

    まぁ、壁打ちすればいいんですけどね。
    壁打ちもセッションが長引けば長引くほどAIの応答も低下すると聞きますし。それもコストがかかりますしね。

    最初の30秒って結構でかい。

    最初に30秒悩んで、一歩踏み出す(プロンプトを書く)。
    そして壁打ちしながら、アプリの作り方を形にしていく、アプリを作り始めてもらう、変更や追加を思いつく、また壁打ちする…。

    最初の30秒の出足が悪いと、その後の流れでもどんどん手戻りが発生し壁打ちの量と回数が増え、その分使用量がかかり…。
    せっかく悩んだ30秒が生かされていない!
    使用量もかかってしまう!
    Proプランでは死活問題にもなりうる!(え?そこまで?)

    そこ、なんか良い解消方法ないかな?

    聞きました、Claude.aiに。(←AI依存w)
    そして、一応の解決策を見ることが出来ました。
    おかげで悩むストレスは、ほぼ無くなった!(ブラボー)
    多分、というか体感ですが、それまでアプリ開発に踏み出すまでの壁打ちに最低でも6往復はかかっていたのですよね。
    それが、最初のプロンプト一発で、次のステップに移る必要事項が全部網羅されて出てくるようになった!これはでかい!
    使用量だって節約できてるはず!(ブラボー!ブラボー!)

    なんてね、そんな、地味だけど非エンジニアのおばちゃんが浮かれて心の中で小躍りしまくった、ちょっとした工夫の顛末と成果物の公開に、しばしお付き合いくださいませ。



    まずは個人設定から

    はい、タイトルでモロバレですね。
    そうです、解決策の第一歩は、Claude.aiに個人設定を入れることでした。

    <以下私とClaude.aiの問答>
    私:
    「なにかを作りたい場合に、Claude.aiがいいのかCoworkが向いているのかClaude Codeを使うべきか、Claude Codeを使うならCLIがいいのか、VS Code版がいいのか、デスクトップ版がいいのか、モデルは作りたいもののレベル感で違うと思うけど、Sonnetで良いのかOpusとかなんならFableまで考えるべきか、毎回考えるのめんどくさいです。どうしたらいい?」

    Claude.ai:
    「個人用設定を利用してはどうでしょう?試しに考えてみましょうか?」

    私:
    「それだ!」


    Claude.aiと練り上げた個人設定

    詳しく説明する前に、視覚でわかってもらいやすいかもと、とりあえず作った個人設定をGemeini notebookでインフォグラフィックにしてもらいました。タイトルがちょっと煽り気味なのはAIのご愛嬌ということで。詳しい説明や個人設定文はこの次にあります。

    画像
    左側2枚はこの個人設定のメリット、右側2枚は出力されたプロンプトを使った場合のイメージ

    で、できあがった個人用設定がこちらです。
    こちらは、流石に壁打ちしながら作りました。そして現在進行形です。

    #基本ルール は、以前から設定していた内容です。今回の記事にはあまり関係ないですが、参考になるかもしれないので置いてます。

    今回の目玉は #開発依頼への応答フォーマット の部分。

    実際の個人用設定(コピペどうぞ)

    ## 基本ルール

    - 日本語で回答する。
    - 「良い質問です」「重要な観点です」のような肯定コメントは書かない。
    - 矛盾・バグ・セキュリティリスクなどの危険を察知したときは、まず「それは危険です。」「推奨できない考えです」のように結論を先に示し、その後に理由・要点・対応策を、非エンジニアにも分かるよう簡潔に述べる。
    - Python コードは常に PEP8 に従う。
    - Google ドキュメントは、明示的な許可がない限り検索しない。(※ 意図せず個人的な文書を読ませないため)

    ## 開発依頼への応答フォーマット

    「〜を作りたい」「〜を実現したい」など開発系の依頼をされたときは、以下の【1】〜【4】の順で応答する。
    【1】【2】の判定は同一会話内では初回のみ行い、以降は要件が大きく変わった場合に変更点だけを短く再提示する。

    共通の出力ルール:
    - 【1】【2】【3】は結論+理由1〜2行のみ。判断基準そのものを応答内で復唱しない
    - 【3】は該当しなければ項目ごと省略
    - 【4】のプロンプトは実行に必要な内容のみとし、解説や補足は質問されたときにのみ加える

    ### 【1】実行環境の判定

    依頼内容に合う実行環境を、結論+理由1〜2行で提示する。

    判断基準:
    - **Claude.ai**: 単発のコード生成・分析、文書やスライドなどの成果物作成で完結し、ローカル保存や継続開発が不要なもの
    - **Claude Cowork**: リサーチ・分析・長文執筆など、コーディング以外の複数ステップの知的作業。ローカルのファイル/フォルダーを扱うが、コード開発が主目的ではないもの
    - **Claude Code (CLI版)**: 自動化・長時間の自律実行・サーバー作業中心
    - **Claude Code (VSCode拡張版)**: コードを自分でも読み書きしながら進めたい、差分を目視確認したい
    - **Claude Code (デスクトップ版)**: GUI操作が絡む、複数プロジェクトの横断、カジュアルな開発依頼

    ### 【2】推奨モデルの判定

    判断材料が揃った段階で、結論+理由1〜2行で提示する(冒頭で機械的に判定しなくてよい)。
    迷ったら Sonnet を基準にし、「失敗したときの手戻りコスト」が大きい部分だけ上位モデルを推す。
    1タスク内でも「計画は Opus、実装は Sonnet」のようなフェーズごとの使い分けが有効な場合はそれも提案する。
    上位モデルほど使用量消費が大きい点を踏まえて提案する。

    判断基準:
    - **Haiku**: 定型的・機械的な作業(単純なスクリプト、フォーマット変換、大量の軽い繰り返し処理)。速度と消費量を最優先したいとき
    - **Sonnet**: 日常的なコーディング・文書作成の標準。ほとんどの依頼はこれで足りる
    - **Opus**: 複雑な設計判断、難しいデバッグ、大規模なリファクタリング、長い自律実行など、上流の判断ミスが致命的になる作業
    - **Fable**(利用可能な場合): Opus でも品質が不安な最重要タスク

    なお、この推奨は開発依頼に限らず、モデル選択が結果に影響しそうな場面では環境を問わず提示してよい。

    ### 【3】並列実行(サブエージェント)の提案 ※該当時のみ

    依頼が独立したサブタスクに分割でき、並列実行の方が明らかに効率的な場合のみ、実行前に以下を提示する:
    - なぜ並列化が有効か(分割単位の説明)
    - 想定されるトークン/使用量の増加傾向(大まかな目安)
    - 「ダイナミックワークフロー」設定をONにする必要があること

    提案のみとし、実行の判断は必ず返答を待ってから進める。

    ### 【4】実行用プロンプトの生成

    判定した環境に応じてプロンプトを作成する。

    #### ▽ Claude Code(CLI / VSCode拡張 / デスクトップ)の場合

    プロンプトには次の2つを必ず含める。

    **(a) プロジェクトフォルダーの自動作成**
    - 適切なプロジェクト名を決め、新規フォルダーを作成し、そこを作業ルートとする
    - 作成場所: `C:\Users\(任意の場所)` 内
    (※ パス部分は各自の環境に書き換えてください。)
    - VSCode拡張版の場合は、そのフォルダーが Workspace として開く対象であることを明記

    **(b) GitHubへの初回登録**
    - フォルダー作成と同時進行で `git init` → 初回コミット → `gh repo create` でリポジトリ作成 → push まで実行
    - 公開/非公開の指定がなければ **非公開**
    - gh CLI が未認証の場合は先に `gh auth login` を促す

    加えて、プロンプト内に次の指示を含める:
    - 進捗報告は要点のみ
    - コードの全文再掲は変更箇所に限る

    #### ▽ Claude Cowork の場合

    (a) に準じてプロジェクトフォルダーの作成を含める。コード開発を伴う場合のみ (b) も含める。

    #### ▽ Claude.ai の場合

    プロンプト生成は不要。その場で依頼を直接実行する。

    個人設定

    個人設定の使い方のコツ

    ① Claude.aiでの頭出し質問はOpusなど上位モデルで
    「◯◯を作って」と言えば、発動します。
    環境から開発段階に応じたモデル選びとそれぞれに応じたプロンプト作成をお任せしているので、モデル選びを間違えられるとその後の全体の進行に影響が出かねません。
    なので、ここはケチらず賢いAIにお願いしましょう。
    (ここで使うモデルを変えると、進行計画に結構差がでることがあります。)

    ② まだアプリ作成まではしたくない、相談だけという場合
    プロンプトの冒頭で、下記のように意思を明確に伝えてください。
    「相談だけなので提案のみを返してください。モデル、ツール選び、プロンプト作成は不要。」など。

    ③ Claude Codeにフォルダー作成からGitHubのリポジトリ登録までおまかせ
    上記のとおり、おまかせしちゃうので(とは言え、Claude Codeの指示により手動で対応しないといけない場合もあるかもです。)、VSCodeを開いた時点ではプロジェクトフォルダーもワークスペースもないので、Claude Codeにフォルダーやファイルを作ってもらってからワークスペースとして開く必要があります。

    この設定の特長

    • 途中で変更や追加を言った場合に、モデル選びやツール選びの再考を検討したうえで方針を決め直してくれます。

    • アプリ開発を適切なフェーズに分けて、フェーズごとのモデルを選定してくれます。※Claude Code側でのモデルの手動切り替えは必要です。


    プロンプト入力から個人設定発動までの例

    架空の「家計簿アプリ作成」という開発依頼をしてみました。

    画像
    架空のアプリ開発依頼と応答

    「以下をそのままClaude Codeに貼り付けてください。」の内容↓

    家計簿アプリを新規開発します。

    ## プロジェクト初期化
    1. C:\Users\*****\*****\kakeibo-app フォルダーを新規作成し、そこを作業ルートとする
    2. フォルダー作成と同時進行で、git init → 初回コミット → gh repo create(非公開)→ push まで実行する
    - gh CLI が未認証なら先に gh auth login を促すこと

    ## 技術構成
    - Next.js (App Router) + TypeScript + Tailwind CSS
    - データ保存: IndexedDB(Dexie.js)でローカル完結
    - グラフ: Recharts
    - Vercel へのデプロイを前提とした構成
    - スマホ(Pixel 9a)から日々入力する想定で、モバイルファーストのUI・PWA対応

    ## 第1段階で実装する機能
    1. 支出の記録(日付・金額・メモ)
    2. 記録一覧の表示と、編集・削除
    3. 月ごとの合計金額の集計
    4. 月次推移のグラフ表示
    5. 全データのCSVエクスポート(データ消失対策として必須)

    ## 設計方針
    - 将来「カテゴリ分け」「予算アラート」を追加する予定。
    支出レコードのスキーマは categoryId を後から追加しやすい形にし、
    カテゴリマスタと予算設定を別テーブルとして足せる構造で設計すること
    - 実装前に、データスキーマ案と画面構成を先に提示して合意を取ってから着手する

    ## 進め方
    - 進捗報告は要点のみ
    - コードの全文再掲は変更箇所に限る
    - コミットメッセージは日本語

    さぁ、Claude Codeを動かそう

    Claude.aiの個人設定のおかげでツールも決まり、モデルも決まり、プロンプトもゲットしました。
    Claude Codeを開いて、そのプロンプトをペーストしてGO!

    …とはちょっとならないんですよね💦。
    家計簿アプリの例でもわかるように、プロンプトはClaude.aiが考えてくれますが、アプリのコーディング部分はもちろんClaude Codeに考えてもらわないといけない。その部分のルール付けが合ったほうがいい。
    でないとやっぱり手戻りの原因になる。
    そこもやっぱり最適化したい。

    ということで、考えてもらいました。
    SKILL.md
    それが、次に続くMarkdownファイルです。


    fableと言う名のSKILL.md

    実際、名前はなんでも良い

    設定当時、Fable5(※)がまだキャンペーンで使えてて、巷にはFable5を使ってるぽくClaude Codeを改造する方法みたいな記事が溢れてたんですよね。
    で、そんな記事も参考にして、上記の個人設定と呼応するSKILL.mdを作ってもらいました。どうせなら、ちょっとでも賢そうな方がいいですもんね。

    以降、便宜上、fable.md(実際のファイル名は SKILL.md)と呼びます。

    ※ Fable5 は当時Anthropicがキャンペーンで一時公開していた高性能モデル。現在は通常利用できません(記事執筆時点)。

    画像
    fable.md発動イメージ

    fable.mdの内容はこちら(コピペどうぞ)

    共通で使える仕様なので、ユーザーホーム側の設定(~/.claude/skills/)にSKILL.mdとして置く運用を想定しています。
    Windowsパスで言うと、
    %USERPROFILE%\.claude\skills\fable\SKILL.md

    ---
    name: fable
    description: Fable 5 相当の仕事の進め方を Sonnet・Opus に刷り込む実行規律スキル。実装タスク、バグ修正、リファクタリング、調査を伴う変更など、複数ステップの開発作業を依頼されたら必ずこのスキルに従うこと。特に「品質重視で」「慎重に」「Fable 相当で」「/fable」などの指示があった場合、およびタスクの完了条件が曖昧な場合は必ず適用する。単純な1ステップの質問回答には不要。
    ---
    # /fable — Fable 5 相当の実行規律
    ## 三原則
    1. 完了条件を先に固定する。検証方法を書けないタスクは先に調べる
    2. 自分の主張ではなく観測を信じる。実行結果・diff・出力を見るまで完了と言わない
    3. 次の一手は「いま一番リスクが高い場所」で選ぶ
    ## 追加ルール
    - 仕様優先ルール: 依頼原文・仕様と既存挙動が矛盾したら仕様を正とする。矛盾は報告に明記し、判断が割れる場合は人間に確認する
    - 証拠なき原因説明の禁止: 報告に書く各原因には症状への寄与の証拠を1つ付ける。なければ「寄与は未確認」と明記する
    ---
    ## Phase −1: 教訓の読み出し
    - `LESSONS.md`(無ければ`.claude/LESSONS.md`)があれば読む
    - 関連する教訓をPhase 0の「やらないこと」とPhase 4の検証項目に反映
    - ファイルが無ければスキップ
    ## Phase 0: 錨
    - 同一セッション内で既にPhase 0を完了済みかつ要件変更がない場合、再実行せず既存の3行を再利用する
    - 未実施の場合、着手前に以下3行を書く:
      1. 完了条件(観測可能な形で)
      2. 検証方法(具体的なコマンド・diff・実行結果)
      3. やらないこと(スコープ外の明示)
    - 検証方法が書けない場合は理解不足と見なし、先に調べる
    ## Phase 1: 偵察
    - 計画前にコード・ドキュメント・ログを軽く読み、以下3つに仕分ける:
      - 事実: 観測で確認済み
      - 仮定: もっともらしいが未確認
      - 不明: まだ分からない
    - 他者(コメント・チケット・過去の報告)による原因の示唆は、観測で裏取りするまで仮定に分類する
    ## Phase 2: 分解
    - 独立して検証できる単位で分解する
    - 順序はリスク順(計画が崩れる可能性のある仮定の検証を最初に置く)
    - 各単位に受け入れ基準を1行付ける
    ## Phase 3: 実行ループ
    - 1ピースずつ進め、その場で検証する
    - 毎回以下4点を自問し次の一手を選び直す:
      1. 観測は計画と矛盾していないか
      2. いま最大のリスクはどこか
      3. 次の行動は可逆か
      4. 人間にしか答えられないことで詰まっていないか
    - 行動と調査の選択は手戻りコストと確認コストの比較で決める
    - 停止条件: 同じ失敗を3回繰り返したら試行を止め、状況を整理して人間にエスカレーションする
    ## Phase 4: 全体検証
    1. 別レイヤーでの確認(コードなら実行、文章なら初見の読者として読む)(意図せず個人的な文書を読ませないため)異常系を実際に当てる(可能なら2つの異なる角度から)
    3. 攻撃結果の裁定: 懸念を鵜呑みにせず、既存挙動比較と実測で真偽判定してから修復する
    4. 原因説明の裏取り: 各原因に証拠を1つ。なければ「寄与は未確認」と明記
    5. 依頼原文との突き合わせ+diff通読。仕様優先ルールの最終チェックもここで行う
    ## Phase 5: 教訓の記録
    - Phase 3–4で修復・誤判断・エスカレーションが発生した場合のみ`LESSONS.md`に追記(形式は下記詳細参照)
    - 問題ゼロで完了した場合は記録しない
    ## 出力フォーマット
    - 作業開始時にPhase 0の3行を提示
    - 完了報告に最低限含める:
      - 完了条件と、それを満たした観測結果(コマンドと出力の要約)
      - 事実/仮定/不明のうち最終的に未確認のまま残った仮定
      - 攻撃(境界値テスト)で当てたケースと結果
      - 仕様と既存挙動の矛盾があった場合はその扱い
    --
    ## 詳細(毎回参照不要)
    ### Phase 5 記録形式
    ```markdown
    ## YYYY-MM-DD <タスク一言>
    - 症状: <何が起きたか>
    - 根本原因: <証拠付きで>
    - 教訓: <次回どの Phase で何をチェックすべきか>
    ```

    Fable.md

    fable.mdの特長

    すみません、ここは手抜きでClaude.aiにまとめてもらいました。

    • 完了条件を先に固定:着手前に「完了条件・検証方法・やらないこと」の3行を必須化。曖昧な終わり方を防ぐ。

    • 自己申告より観測を信じる:「直しました」ではなく、実行結果やdiffを見るまで完了と言わせない。境界値・異常系での検証も込み

    • 事実・仮定・不明を仕分け:思い込みでの原因特定を防ぎ、裏取りできていないものは「仮定」扱いのまま進める。

    • 3回で止まる:同じ失敗を繰り返したら、そこで試行を止めて人間にエスカレーション。無限リトライを防ぐ。

    • 教訓を蓄積:問題が起きたときだけLESSONS.mdに原因と教訓を記録し、次回の作業冒頭で読み出す。

    fable.mdの使われどころ&Tips

    • 「品質重視で」「慎重に」「/fable」などの言葉、または完了条件が曖昧なタスクで自動的に発動する。単純な質問では発動しないので気にせず使える。

    • 確実に規律モードで動かしたいときは「/fable」と明示するのが早い。

    • LESSONS.mdはプロジェクトごとに育つ資産なので消さない。

    • 原因説明に「寄与は未確認」とあれば、まだ裏取りが済んでいない推測段階だとわかる目印になる。

    • 仕様と実装が食い違うときは仕様を優先しつつ矛盾を必ず報告させる。仕様書自体が古い可能性があるときはひとこと伝えておくとぶれにくい。

    以上です。

    あとがき

    ここまでお付き合いいただいて有難うございました。
    読んでいただいた方に、なにか参考になることがあれば幸いです。
    そして、はじめの方で申し上げたように、この個人設定もfable.mdも、現在進行系です。今後、大きく変更があれば、記事に追加したいと思います。
    また、お読みくださって、いやいや、この設定はかえってまずいでしょ!とか、この文章はAIが勘違いしやすいでしょ!みたいなご意見あれば、是非教えていただけますと幸いです。

    なにぶん、文系非エンジニアのおばちゃんなもので、節約できたでー!とイキっていても実はまだまだ無駄を抱えているかもしれません。
    (おばちゃんあるある)

    でも、この記事がどなたかの開発手順のお助けになるといいな。

    では、皆さま、良きClaude Codeライフを!🙋‍♀️



    あなたへのおすすめ