Spec Kitが文書を書く。レビューはDotMDで。

GitHub Spec Kitとは

Spec Kitは、スペック駆動開発のためのGitHubのオープンソースのツールキットです。エージェントの代わりにはなりません。プロジェクトを設定するコマンドラインツールspecifyと、エージェントのチャットで実行する一連のコマンドを加えます。書くのはエージェントで、Spec Kitは手順と構造を与えます。

Claude Code、Codex CLI、Cursorなど、多くのエージェントに対応しています。一覧はSpec Kitのintegrationsページにあります。

インストールと初期化

Python 3.11以降とuvが必要です。そのうえで次を実行します。

uv tool install specify-cli
specify init my-project --integration claude

--integrationフラグには、エージェントのキーを指定します。Claude Codeはclaude、Codex CLIはcodex、Cursorはcursor-agentです。ほかのエージェントのキーは、Spec Kit自身のページに載っています。

コマンドの順序

これらはターミナルではなく、エージェントのチャットに入力します。

1. /speckit-constitution
2. /speckit-specify：spec.mdを書きます。
3. /speckit-plan：plan.mdを書きます。
4. /speckit-tasks：tasks.mdを書きます。
5. /speckit-implement：タスクに沿って実装します。
6. /speckit-converge

コマンドの綴りはエージェントによって違います。/speckit.specifyを使うものもあれば、ハイフンや$を使うものもあります。各エージェントの形は、Spec Kitのcommand invocationの説明にあります。

DotMDで各手順をレビューする

Spec Kitは、続ける前に各結果のレビューを求めます。DotMDなら、ターミナルでの流し読みではなく、きちんとしたレビューになります。

1. プロジェクトを開く

   ⌘Oを押して、プロジェクトのフォルダを選びます。Spec Kitが書くファイルは、作られるたびにサイドバーに現れ、見出し、リスト、表が整形されて表示されます。

2. 該当の行にコメントする

   spec.mdを読み、間違っている、または曖昧な要件を選んで⌥⌘Mを押します。変えたいことを書きます。コメントはファイルではなく、DotMDが保存します。

3. エージェントに直させる

   エージェントに「DotMDの私のコメントを確認して」と伝えます。エージェントはMCP経由でコメントを読み、ファイルを編集します。修正はコメントの隣に、古い文を赤、新しい文を緑で表示されます。1つずつ承認するか再オープンします。

4. 次のコマンドは、それから

   スペックが正しくなったら/speckit-planを実行し、プランとタスクでも繰り返します。スペックで見つけた誤りなら、コメント1つで済みます。コードになってから見つけると、やり直しになります。

tasks.mdを確認する

タスク一覧はMarkdownのチェックリストで、DotMDはタスクリストをチェックボックス付きで表示します。何が終わり、何が残っているかが一目で分かります。/speckit-implementを実行する前に、エージェントが読むのと同じように、順番に、1つ1つが小さく、抜けがないかを確認しましょう。Spec Kitの分析ステップを実行したなら、その結果も同じように扱います。DotMDで開き、納得できないものにコメントします。

エージェントをDotMDにつなぐのは1行です。Claude Code、Codex、Cursorのガイドに手順があります。

各ファイルをレビューする理由

Spec Kitは速く進みます。コマンド1つで、文書が丸ごと現れます。その速さがリスクです。スペックに誤った要件があるのに、読まずに次のコマンドを実行すると、プランもタスクも、そしてコードも、その上に作られます。spec.mdを一度丁寧に読むのが、このプロセス全体で最も安い確認です。

Spec Kitについての質問

その他の質問