SpecKitをカスタマイズしてシステム改修に利用してみた

Spec Kit をカスタマイズしてシステム改修に利用してみた 2025/10/25

X：@ochtum18 Github：ochtum IT 関連の情報発信（とゲームや日常をポスト）よかったらフォローしてください!! 猫とゲームを愛するエンジニア Youtube は忙しいのであきらめた＼(^o^)
／

Spec Kit とは？ AI を活用した仕様駆動開発(SDD) を実現するための、
OSS ツールキット。これを試してみた GitHub から 2025 年9 月2 日に発表された。参考資料

サポートしている AI エージェント ※[speckit] リポジトリから引用参考資料

仕様駆動開発(SDD) とは？先にコーディングして後でドキュメントを書くのではなく、仕様を軸に設計/ 実装/
テストを進める開発手法のことを指す。要件/ 設計/ 実装を明確に分離することで、 AI 活用を最適化することが可能です。参考資料

Spec Kit を活用しよう！！しかし、新規開発が前提になっていて、システム改修に活用するにはどうしたら
いいかわからない大規模システムに活用できるか未知数💦

こうできないか？（というかそもそもこうしたい！！）設計書プロンプト既存ルールに合わせてソースコード改修
INPUT OUTPUT

結論から言うと・・・できた＼(^o^) ／

設計書 (10 行) plan プロンプト既存ルールに合わせてソースコード改修 INPUT
OUTPUT 改修対象のファイル10 個 INPUT 中間md tasks プロンプト INPUT OUTPUT INPUT こんな感じでやってみた

src サイズ：17GB src ファイル数：47,833 C# ステップ数：6,686 ファイル、 849,806 ステップシステム規模は
こんな感じ

どうやったかというと・・・分析から始めた解析編

フォルダ構成ルート .github\ptompts .specify memory scripts\powershell templates SpecKit で利用する
プロンプト( コマンドのようなもの ) 集プロジェクト規約、コーディング規約プロンプト実行時にキックされるスクリプト群プロンプト実行時に読み込まれるテンプレート。プロンプトと 1 対1 の関係になっていて、これが元になって要件や仕様、タスクが整理される。解析編

プロンプト構成ルート .github\ptompts specify.prompt.md plan.prompt.md tasks.prompt.md バージョン：0.0.9 バージョン：0.0.55
specify.prompt.md constitution.prompt.md plan.prompt.md tasks.prompt.md implement.prompt.md analyze.prompt.md clarify.prompt.md プロジェクトのガバナンス原則と開発ガイドラインを整備・改訂する何を構築したいのかを定義する（要件とユーザーストーリー）未定義またはあいまいな部分を明確化する（明示的にスキップされない限り、 /plan の前に実行する必要があります。以前のコマンド名は /quizme ）選択した技術スタックで技術的な実装計画を作成する実装に向けた具体的なタスクリストを作成する成果物間の整合性および網羅性を分析する（/tasks の後、 /implement の前に実行）計画に沿って機能実装のための全タスクを遂行する説明更新早い !! ローンチ時点(9 月2 日) と 10 月01 日時点ですでに構成変わっている解析編

役割を整理 instructions.md constitution.md ～prompt.md ～- template.md SpecKit には含まれていないが、
ガイドラインの役割を持つカスタム指示( 従来使われていた）プロジェクト規約作業指示詳細手順及び出力例/ 出力形式カスタムにおいて最も重要解析編

そのままでは中身が読みづらいので Chat- GPT で日本語に翻訳して意味を理解しようと
してみた解析編

[ リンク] 入力: /specs/[###- feature- name]/spec.md にある機能仕様実行フロー
（/plan コマンドの範囲） 1. 入力パスから機能仕様を読み込む → 見つからなければ：ERROR 「{path} に機能仕様がありません」テンプレート(plan) ここに設計書(Markdown) を指定すればいいんじゃないか？解析編

テンプレート(plan) ここに改修をしたいシステムのフォルダ構成を指定すればいいのではないか？解析編

プロンプト(tasks) 設計ドキュメントや使用技術を指定するところがあった！！解析編

紐解くと SpecKit はこういう構成であることに気づいた！！解決編

解決編

この考え方を流用すれば自作SpecKit が作れるのでは？解決編

例えばこう！！解決編

この考え方を流用してテック記事ライターを作ってみた興味がある方はこちら → 解決編

本題に戻ります解決編

改めてシステム改修用に SpecKit に必要な内容を整理するとどうなるか？解決編

設計書 (Markdown) システム情報テンプレートソースコード plan プロンプト処理結果次の
tasks プロンプトに渡す中間ファイル解決編プロンプトに渡すもの本来これはないここが specify の実行結果だった

プロンプトの全体の流れ（イメージ）内容整理（情報収集）実行
計画案実行計画検証実行結果チェック解決編ここが specify だったが、設計書で事足りる

SpecKit にあてはめると・・・内容整理（情報収集）実行計画案実行
計画検証実行結果チェック specify ：何を構築したいのかを定義する（要件とユーザーストーリー） plan ：選択した技術スタックで技術的な実装計画を作成する tasks ：実装に向けた具体的なタスクリストを作成する解決編ここが設計書に置き換わる

設計は？・Markdown で書く・どのようなことを実現したいか（目的）・どこを直すか（class
やファイル名で大まかで良いので示す）・機能を追加する場合、どこに属する機能か（フォルダ構成のどこに属するか）が伝わらないと厳しい解決編

システム情報は？・システムのフォルダ構成・技術スタック（どのような技術が使われているか）・コーディング規約依存関係も書かれていると
ベター・検証方法、検証ルール何を持って、書かれたものを正しいとチェックするか解決編

テンプレート大事！！・プロンプトを実行するときの詳細情報・出力内容のテンプレート・実行するときの前提条件
プロンプトの流れ、前提条件を書くイメージ・検証方法、検証ルールシステム情報のどのセクションを見るか解決編

プロンプトは？・実行する際の概要を書く・INPUT は何で、何をするのか
・実行する際に注意して欲しいこと細かいところはテンプレートで書けばよい解決編

SpecKit カスタマイズのポイント ① ・分からないところは全削除すべし・実行環境はシステムフォルダであること前提に
する・プロンプト実行時、対象のソースファイルも添付する前提にする・必ず実施するところは " 必ず" を強調する・変数は中括弧[] 、半角スペースを空ける、プレフィックスに $ を付けるなど、明確に表現する解決編

SpecKit カスタマイズのポイント ② ・ルールは constitution.md に書いて指定する copilot- instructions.md に
書いた上で、その場所に書いてあることを指定してもよい・中間プロンプトの場合、 Output する際に不明点にマーカーを付けてもらうとよい。 SpecKit の場合は「NEEDS CLARIFICATION( 明確化が必要) 」とつけていた解決編

これを試した結果・・・解決編

設計書(10 行) からバックエンドのソースコード改修に成功した！！一つのメソッドから関連するメソッドも
推測して直してくれた！！解決編

解決編設計ソースコードテンプレート plan 実行イメージはこんな感じ

解決編プロンプトテーブル7 個＼(^o^) ／設計テーブル定義書 ( 全部） SQL
もいけます

いまは GitHub Copilot の環境をこう捉えている

Thank you

SpecKitをカスタマイズしてシステム改修に利用してみた

SpecKitをカスタマイズしてシステム改修に利用してみた

More Decks by Ochtum

Featured

Transcript