Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Sign up for free
Menu
Search
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Pricing
Search
Sign in
Sign up for free
Spec Kit概論 in 北海道もくもく会 オンライン vol.9
Search
hidao
July 25, 2026
Technology
65
0
Share
Embed
Copy iframe code
Copy JS code
Copy link
Start on current slide
Spec Kit概論 in 北海道もくもく会 オンライン vol.9
もくもく会を使ってSpec Kitについて学び、今日の成果としてClaudeにMarpを使ってスライドにまとめさせました。
hidao
July 25, 2026
Transcript
15 slides
北海道もくもく会 今日のお題:Spec Kitについて調べる 2026-07-25 (Sat) / by hidao 1
とは Spec Kit の Spec Kit = 一言で言うと AIコーディングエージェント向けの「仕様駆動開発(SDD) 」を実践するOSSツー
ルキット 仕様書・設計・タスク・実装を一連のワークフローとして管理するフレームワー ク GitHub Copilotだけでなく Claude Code / Codex / Gemini CLI など30以上のAIエー ジェントに対応 GitHub 2
なぜ作られたのか の問題 Vibe Coding 人 →「◦◦作って」 AI → コード生成 →
動く → でも設計が曖昧 → 後から修正が大変 → AIが前提を忘れる は数千行程度なら書けるが、要件・制約・アーキテクチャの長期維持が苦手 Spec Kitは「仕様→設計→タスク→実装」を人間の開発プロセスとしてAIに強制す る AI 3
コンセプト 従来の開発手法の課題: 同じ内容を毎回説明する AIが忘れる 設計が揺れる これを解決するため、仕様 → 計画 → タスクの切り出し
→ 実装 の順に定義 → 仕様が唯一の真実(Source of Truth) になる 4
コアワークフロー (憲法) 2. Specify(特定) 3. Clarify(明確化) 4. Plan(計画) 5. Checklist(チェックリスト)
6. Tasks(タスクの切り出し) 7. Analyze(解析) 8. Implement(実装) 9. Converge(収束) 品質ゲート(Clarify・Checklist・Analyze)を挟みながら実装に進む 1. Constitution 5
(プロジェクト憲法) Step 1: Constitution が今後ずっと守るべきルールを記述。 .specify/memory/constitution.md に保存さ れ、以降の全工程で参照される。 コーディング規約 /
テスト方針 パフォーマンス目標 / アーキテクチャ原則 セキュリティ基準 AI ・Biomeを使用する ・ユニットテスト必須 ・アクセシビリティAA準拠 ・Repository Pattern採用 6
(特定) Step 2: Specify 何を作るかを書く。技術は書かない(What/Why先行、Howは後)。 カンバンボードを作る ・ドラッグ&ドロップ可能 ・担当者を設定できる ・期限を持つ 成果物:
spec.md 7
(明確化) Step 3: Clarify 仕様には必ず曖昧さがある。例:「ドラッグ&ドロップ」だけでは不明な点 並び替え? カラム移動? モバイル対応? Undoできる? /speckit.clarify
でAIが不足情報を質問し、回答を仕様書へ反映 (曖昧さが少なければ省略可) 8
(計画) Step 4: Plan ここで初めて技術設計を行う。Constitutionへの適合も確認される。 - Frontend: React - Backend:
Go - Database: SQLite - 認証: JWT / API: REST 成果物: plan.md / research.md / data-model.md / contracts/ / quickstart.md 9
〜 Step 5 7: Checklist / Tasks / Analyze 設計品質のセルフチェック(要件網羅・非機能要件の有無など)
Tasks — Planから実装タスクへ分解、依存関係も考慮(成果物: tasks.md ) Checklist — - Task1: Userモデル作成 - Task2: ログインAPI - Task3: 画面作成 Analyze — 仕様・設計・タスク間の整合性チェック(実装前の最終レビュー) 10
〜 Step 8 9: Implement / Converge ここで初めてコードを書く AIは Constitution
/ Specification / Plan / Tasks を全て参照 → 単一プロンプトより一貫 性を保ちやすい Converge — 成果物を統合・収束。残課題整理と最終整合性確認 大規模・反復開発で特に有効 Implement — 11
このフローの本質 各工程がMarkdown成果物を生成し、それが次工程の入力になる constitution.md → spec.md → plan.md → tasks.md →
Source Code AI → はチャット履歴だけでなく、これらの成果物をコンテキストとして利用 長期間・複数人・複数エージェントでも設計意図を維持しやすい 12
エージェント対応 / カスタマイズ性 対応エージェント: GitHub Copilot / Claude Code /
Codex / Gemini CLI / Zed / Kiro カスタマイズ要素: Extensions — 新しいコマンドや品質ゲートを追加 Presets — テンプレートや組織ルールを上書き Workflows — 独自の工程を定義 Bundles — 上記をまとめて配布・適用 13
向いているプロジェクト/推奨度 効果が期待できるケース 中〜大規模Webアプリ / 長期保守システム 複数人開発 / 複数AIエージェント併用 要件変更が多いプロジェクト 推奨度
中〜大規模・継続開発/チーム開発/AI中心開発: ★★★★★ 個人の小規模ツール: ★★★☆☆ ワンオフスクリプト: ★★☆☆☆ 14
まとめ はGitHubが提供するSDD(仕様駆動開発)用フレームワーク 方法論だけでなく、ツールキット+ワークフローの組み合わせ Spec Kit自身はAIではなく AIへのコンテキスト管理ツール 仕様書を唯一の真実として、AIの「設計忘れ」「揺れ」を防ぐ Spec Kit 15
More Decks by hidao
See All by hidao
CapacitorとAndroid端末でつくるAndroidアプリ
hidao80
0
53
Conventional Commitsでコミットログにシンプルな秩序を
hidao80
0
42
AIが増やしたコードをAIに探させない ~ jscpdとknipの違いと使い分け ~
hidao80
0
57
Claudeの時間制限トークン使用量を節約する方法 - 2026年9月版
hidao80
0
100
ローカルで検証する「act」ハンズオン
hidao80
0
36
Viteなし・Bunだけで作るHono+React最小構成ハンズオン
hidao80
0
75
Denoで作るはじめてのCLI実行ファイルハンズオン
hidao80
0
96
Gherkinを調べてみた - 探していたのはテスト記法、見つかったのは共通言語
hidao80
0
48
Other Decks in Technology
See All in Technology
パスワードのない鍵で、 データを手元に置く
ginjihayashi
0
290
アラートを見直していたら営業組織への理解にちょっとだけ繋がった話
z63d
1
210
会社説明資料_最新版
demaecan
0
32k
AWS Client VPNの設定でハマったポイントとその過程での気づき
amarelo_n24
1
350
re:Inventを楽しむために、 1日1つ「これが楽しみ」を決めよう
beli68
0
100
Datadog の権限統制 〜Org 統合に向けて調べた注意点 / JDDUG-Meetup_24
visional_engineering_and_design
1
180
gem install とrequire のむこうがわ
ydah
0
180
落とし穴にハマってわかった 開発生産性を測るときに気をつけたいこと
munakata
3
390
農家は秘伝のタレを知らない - NOBODY KNOWS THE HIDDEN SOURCE - Kaggriculture 3rd Place Solution
masspeaks
2
510
市販IoT機器や自作IoT機器とHomeAssistantを駆使して家の電気代をできる限り見える化する方法の考案
harutiro
0
370
さようならSSH鍵、こんにちはゼロトラスト ― AIフレンドリーで快適な自宅鯖SSH
atalie2m
14
6.9k
2026-11-11 Tamachi.sre#7 PaCにインフラリソースの命を救われました。 / PaC saves the infra resource life
masasuzu
1
200
Featured
See All Featured
What's in a price? How to price your products and services
michaelherold
247
13k
Navigating the moral maze — ethical principles for Al-driven product design
skipperchong
2
690
Avoiding the “Bad Training, Faster” Trap in the Age of AI
tmiket
1
310
Let's Do A Bunch of Simple Stuff to Make Websites Faster
chriscoyier
508
140k
4 Signs Your Business is Dying
shpigford
187
23k
AI Search: Where Are We & What Can We Do About It?
aleyda
0
8.2k
30 Presentation Tips
portentint
PRO
1
470
How People are Using Generative and Agentic AI to Supercharge Their Products, Projects, Services and Value Streams Today
helenjbeal
2
400
No one is an island. Learnings from fostering a developers community.
thoeni
21
3.9k
Agile that works and the tools we love
rasmusluckow
331
22k
How to Build an AI Search Optimization Roadmap - Criteria and Steps to Take #SEOIRL
aleyda
1
2.3k
The untapped power of vector embeddings
frankvandijk
2
2k