コンテンツへスキップ

To-Specスキル

合意済み決定を仕様にまとめ、設定済みトラッカーへ公開。

コミュニティ · Matt Pocock
作者Matt Pocock
ライセンスMIT
ソースmattpocock/skills · GitHub 上の SKILL.md
プロジェクトサイトwww.aihero.dev/skills-to-spec
対応環境Claude Code · Codex、Gemini CLI、Cursor、Copilot
ソースを確認した日

to-specは決定済み会話を仕様に統合します。コード、用語集、アーキテクチャ決定を使い、要件インタビューをやり直しません。

テスト境界を確認し、ユーザーストーリーと範囲を記録してトラッカーへ1件公開します。ローカル設定ならMarkdownも対応します。

スキルの SKILL.md より: ## Out of Scope

これは Matt Pocock によるコミュニティスキルで、当サイトや Anthropic による確認は受けていません。スキルはエージェントにコードの実行、ファイルの読み取り、ネットワークへのアクセスを指示できます。インストール前に SKILL.md とフォルダー内のすべてのスクリプトを読み、説明と食い違う動作がないか確認してください。

できること

  1. 会話と関連決定を読む。
  2. テスト境界を確認して仕様を統合。
  3. 設定済み分類ラベルでトラッカーへ公開。

得られるもの

  • 問題、解決策、ストーリー、実装決定、テスト、対象外を含む仕様。

使う場面

  • 複数セッションにまたがる作業の決定を残す場合。

向かない場面

  • 未確定要件や1セッションで終わる小変更。

必要なもの

  • プロジェクト文脈とsetup-matt-pocock-skillsトラッカー設定のあるエージェント。
  • 遠隔公開には認証済みツールと権限が必要。ローカルMarkdownなら遠隔サービス不要。

スキルに含まれるファイル

ファイル・フォルダー用途
SKILL.md仕様テンプレート、テスト境界確認、トラッカー公開。

2026-11-19 時点でリポジトリに記載されていたライセンス:MIT。

プロンプト例

インストール後に次のいずれかを入力してください。スキル名を書くと確実にそのスキルが使われます。

  • /to-spec — 合意したアカウント書き出し設計を新要件なしでまとめてください。
  • /to-spec — 対象外決定を残し、先にテスト境界を確認してください。
  • /to-spec #42 — この決定マップを実装可能仕様にしてください。

to-spec のインストール方法

導入と権限

導入後setup-matt-pocock-skillsでトラッカーとラベルを設定。生成される設定を確認してください。

手動起動です。disable-model-invocationはtrue。公開先と権限を確認してください。このサイトは課題を作成しません。

スキルは SKILL.md ファイルを含むフォルダーです。インストールは一度だけで、エージェントは各セッションの開始時に短い説明を読み、リクエストが当てはまったときにだけ完全な指示を読み込みます。使う環境を選んでください:

Claude Code:スキルフォルダーにフォルダーをコピー

このパソコン上のすべてのプロジェクトで使うならスキルのフォルダーを ~/.claude/skills/ に、作業者全員で共有するならリポジトリ内の .claude/skills/ に置きます(コミットしてください)。

git clone --depth 1 https://github.com/mattpocock/skills.git
mkdir -p ~/.claude/skills
cp -R skills/skills/engineering/to-spec ~/.claude/skills/

Claude Code はセッション中にこれらのフォルダーで新しいスキルや変更されたスキルを検出します。セッション開始時にスキルフォルダーが存在しなかった場合は、/reload-skills を一度実行してください。その後 /to-spec と入力するか、作業内容をそのまま伝えます。

Windows では Git Bash または WSL でコマンドを実行するか、エクスプローラーで同じ場所にフォルダーをコピーしてください。

Codex、Gemini CLI、Cursor、GitHub Copilot

これらのエージェントも同じ SKILL.md フォルダーを読みます。4 つすべてがプロジェクト内で読むフォルダーは .agents/skills/ なので、次のコマンドでスキルをそこにコピーします:

git clone --depth 1 https://github.com/mattpocock/skills.git
mkdir -p .agents/skills
cp -R skills/skills/engineering/to-spec .agents/skills/
エージェントプロジェクトのフォルダーユーザーのフォルダーメモ
OpenAI Codex
.agents/skills/
~/.agents/skills/
$ と入力するか /skills を実行してスキルを選びます。タスクが当てはまれば Codex が自動で選ぶこともあります。
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
または gemini skills install <git URL> --path <folder> --consent で Git からインストールします。Google は 2026 年 6 月 18 日、無料枠と Google One のユーザー向けに Gemini CLI を Antigravity CLI に置き換えました。Antigravity はプロジェクトでは .agents/skills/、ユーザー用には ~/.gemini/config/skills/ を使います。
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Agent チャットで / を入力してスキルを選びます。Cursor は Claude Code の .claude/skills/ フォルダーも読みます。
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Copilot CLI、クラウドエージェント、VS Code・Visual Studio・JetBrains のエージェントモードで動きます(IDE の対応はバージョンによります)。または gh skill install OWNER/REPOSITORY SKILL を実行します(パブリックプレビュー、GitHub CLI 2.90.0 以降)。
信頼できるスキルだけをインストールする. Anthropic は、信頼できる入手元のスキルだけを使い、それ以外のスキルは使う前にすべてのファイルを読むよう勧めています。スキルは、説明に書かれていない方法でエージェントにコマンドの実行、ファイルの読み取り、データの送信を指示できるからです。

これらの手順の出典

2026-11-14 に各ベンダーのドキュメントと照合しました:

既に決まったことを記録

プロジェクト用語と実際の対象外事項を保ちます。空欄を埋めるため決定を創作しません。

複数セッションならto-ticketsへ渡します。同じ文脈で続けると大きな課題本文の再取得を避けられます。

to-spec に関するよくある質問

インタビューしますか?

新たな要件聞き取りはしませんが、テスト境界が期待に合うか確認します。

GitHub必須ですか?

いいえ。ローカルMarkdownか対応遠隔トラッカーを設定できます。

to-prdと同じですか?

作者がto-specへ改名しました。現在の導入名を使ってください。

ready-for-agentで意図しない作業が始まりますか?

はい。監視エージェントが親仕様を作業とみなす場合があります。チケット選択対象から明示除外してください。

ほかの AI スキル

関連スキル

スキルのカテゴリー