「このシステムの運用、お願いします」——フリーランスや業務委託でそう任された日、リポジトリをcloneした直後にやるべきことがあります。コードを読み始めることではなく、調査Skillを仕込むことです。このKitでは、①既存コードの「全体像マップ」と「この機能を変えたら壊れる箇所の一覧」を出す調査専用Skill(impact-scan)を生成プロンプト1発で自分専用に作成し(あなたのスタックの壊れやすいポイント入り)、②リポジトリに住まわせて運用する、までを扱います。一度仕込めば、以後はリポジトリを指して一言頼むだけ。ドキュメントがなくても前任者が捕まらなくても、変更前に「壊れる箇所」が危険度つきで先に見える運用体制が初日にできあがります。コードは一切変更しないread-only設計です。
リポジトリをcloneしたら、コードを読み始める前にこのStepです。Skillとは、AIに渡す「手順書」を置いておく仕組みで、使い分けは「事実・ルールはCLAUDE.md、手順はSkills」。置いておけば、関連する依頼をしたときだけ自動で発動します。ここでは既存コード調査Skill「impact-scan」を下の生成プロンプトで作ります。あなたのスタック(Rails、Laravel、Next.js…)特有の"壊れやすいポイント"が織り込まれた自分専用版ができるのがポイント。質問には「全部おまかせ」でもOK。できたらフォルダに置くだけで、運用の仕込みは完了です。
コピーしてClaude(Claude Code / Web版どちらでも)に送ってください。最大3つの質問が来るので、答えるか「全部おまかせ」と返すと、SKILL.mdの完成品が出力されます。それを .claude/skills/impact-scan/SKILL.md(このリポジトリ専用)または ~/.claude/skills/impact-scan/SKILL.md(全リポジトリ共通)として保存すれば仕込み完了。Cursor等Skills非対応ツールの人は、生成されたSKILL.md本文を会話の最初に貼れば同じ動きをします。
あなたは「Claude Skills(Agent Skills)の設計者」です。 既存コードの調査専用Skill「impact-scan」を、私の環境向けに生成してください。 # まず質問(最大3つ。私が「全部おまかせ」と答えたら、推奨値で確定して生成に進む) 1. 主に触る技術スタックは?(例:Next.js+Supabase / Rails / Laravel / Django など。推奨値:TypeScript系Web) 2. よく入る案件のタイプは?(自社サービス / 受託の引き継ぎ / チーム開発参画 など。推奨値:受託の引き継ぎ) 3. 出力言語は日本語でよいか(推奨値:日本語) # 生成するSKILL.mdの仕様(すべて満たすこと) ## frontmatter - name: impact-scan - description: 発動トリガーを、ユーザーが実際に言いそうな言葉で書く(「全体像を教えて」「どこが壊れる」「影響範囲」「引き継いだコードを把握したい」「久々に触る」等)+「調査専用でコードは一切変更しない」を明記 ## 共通ルール - read-only:ファイルの変更・作成・削除をしない(提案はするが実行しない) - すべての記述に〔確認済み〕(実際に読んだ)/〔推測〕(名前・慣例からの推定)のラベルと根拠を付ける - 大規模リポジトリは全部読まず優先順で読み、読んでいない領域を「未調査」と正直に明記する - docs/CODEMAP.md が存在すれば最初に読み、差分だけ調査する ## 全体像モード(「全体像」「構成」「把握したい」で発動) - 読み順:ルート直下とREADME/package.json相当 → エントリポイント → ルーティング/画面 → データモデル → 外部連携(env・SDK)→ 実行系(scripts/CI/cron) - 出力:30秒サマリー(5行)/機能マップ表(機能・入口・主要ファイル・触るデータ)/重要ファイルTop10(理由付き)/気になる点(全て〔推測〕ラベル)/未調査の領域 - 最後に必ず「docs/CODEMAP.md として保存するか」を提案する(指示があるまで書き込まない) ## 影響範囲モード(「変えたら」「壊れる」「影響」+変更対象で発動) - 手順:対象の定義位置を読んで特定 → 直接参照(import・呼び出し・ルート・UI)→ 間接波及(型・API契約・DBスキーマ・共有状態・環境変数)→ 表示と文言(UI・メール・通知のハードコード)→ 実行時経路(cron・webhook・バッチ)→ 検証系(テスト・シード・ドキュメント・CLAUDE.mdの記載) - 出力:変更対象の現仕様(〔確認済み〕)/壊れる可能性のある箇所一覧表(場所・なぜ壊れうるか・危険度・確認方法)/変更前チェックリスト(5項目以内)/読んでいないが関係しうる場所(〔推測〕を分離) - 危険度の定義:高=直接呼び出し・契約やシグネチャの変更/中=型・共有データ・文言・テスト経由/低=名前一致のみの推測 ## パーソナライズ - 質問1のスタック特有の「変更時に壊れやすいポイント」を3〜5個、影響範囲モードの手順に1セクションとして追加する ## 制約 - 本文は120行以内。出力は1つのコードブロックで - 最後に配置場所と使い方を3行で案内する(.claude/skills/impact-scan/SKILL.md / ~/.claude/skills/… / 関連する依頼で自動発動)
「全部おまかせ」で生成した場合の完成形です。自分の生成結果と見比べて、①read-onlyの共通ルール ②〔確認済み〕〔推測〕ラベルの義務化 ③2つのモードと出力形式 ④スタック特有の壊れポイント——が入っていれば成功。今すぐ試したい人はこのファイルをそのまま置いてもOKですが、Step 1のプロンプトで作ると自分のスタック用に調整された版になります。
Skillsの仕組みをちゃんと知りたい人向け。読まなくてもこのKitは使えます。
仕込んだSkillを、運用を任された初日のつもりで走らせます。ターミナルでリポジトリに移動して claude を起動し(cd project → claude)、下の2つを順に送るだけ。1つ目で「このアプリが何で・どこに何があるか」の全体像マップ、2つ目で「この機能を変えたら壊れる箇所」の一覧が危険度・確認方法つきで出ます。全行に〔確認済み〕〔推測〕ラベルが付くので、AIの当てずっぽうと事実を区別できます。試すリポジトリがない人は、同梱のサンプルリポジトリで見本とまったく同じ結果を再現できます。
知らないコードの「入口」を3分で作る起動文です。30秒サマリー・機能マップ・重要ファイルTop10・気になる点が出て、どこから読み始めるべきかが決まります。読んでいない領域は「未調査」と申告させる設計なので、出力をどこまで信じてよいかも判断できます。
このリポジトリの全体像を調査してください。今日からこのシステムの運用を担当するので、何のアプリで・どこに何があって・どこから読み始めるべきかを最短で把握したいです。
{ }を最初のタスクに書き換えて送ってください。変更対象の現在の仕様を確認したうえで、壊れる可能性のある箇所を「場所/なぜ壊れうるか/危険度/確認方法」の表で出します。コードには一切触らせない調査専用。運用初日からこの表を持ってタスクに向かえるかどうかで、立ち上がりの速度が変わります。
最初のタスクとして {予約のキャンセル期限の判定} を変更することになりました。実装に入る前に、壊れる可能性のある箇所を一覧にしてください。変更前チェックリストもお願いします。「前任者がAIで構築した予約システムを引き継いだ初日、いきなり『キャンセル期限を2日前までに変えて』と頼まれた」というシナリオの実行例です。判定ロジック本体からAPI・回数券の返還分岐・メール文面のハードコード・境界テストまで9箇所が危険度つきで出ています。自分の結果がこの粒度なら成功。この見本は下のサンプルリポジトリに対する実測結果なので、行番号までそのまま再現できます。
見本を自分の手で再現するための同梱リポジトリです。unzip → cd fitbase → claude を起動 → Step 2の2つのプロンプトを送るだけ。.claude/skills/impact-scan/ にSkillが設置済みなので、Step 1を飛ばして先に「動く体験」をすることもできます(気に入ったらStep 1に戻って、自分のスタック用のimpact-scanを作ってください)。
初日の調査を使い捨てにしないのがこのStepです。全体像を docs/CODEMAP.md として保存すると、Skillは次回それを先に読んで差分だけ調査します(2日目からの思い出しがほぼゼロに)。さらに、自分で作ったSkillだから育てられる——調査の見逃しやスタック特有の注意点をSKILL.md自体に追記して、案件を跨いで持ち歩ける自分専用の調査員にしていきます。
この Step はサブスクリプション限定です
堀本 修治|CTO・GTMエンジニア さんのサブスクリプションでこの Kit の続きが読めます
登録済み有料Kit 3 件も読み放題
初回5日間無料トライアル・いつでも解約できます
登録すると利用規約・特定商取引法に基づく表記に同意したものとみなされます
壊れる箇所が見えたら、次は「安全に直したい」。仕上げに、影響範囲一覧を「どの順で・何を確認しながら直すか」の変更計画書に変換するプロンプトを渡します。そして次回作の予告:この先は「Issueを投げたらPRが立つまでAIに一周させるハーネス」を無料Kitとして配布します。今日作ったimpact-scanは、そのハーネスに最初に差し込むSkillになります。
この Step はサブスクリプション限定です
ログインしてコメントする
SNS アカウントで AI Contents Bank にログインすると、コメント・お気に入り・進捗保存ができるようになります。
まだコメントはありません
最初のコメントを投稿して、クリエイターに感想を伝えましょう。
コメント0件