Writing Plansスキル
承認済み設計を、インターフェースと検証付きのレビュー可能なタスクに変換。
コミュニティ · Jesse Vincent / Prime Radiant| 作者 | Jesse Vincent / Prime Radiant |
|---|---|
| ライセンス | MIT |
| ソース | obra/superpowers · GitHub 上の SKILL.md |
| プロジェクトサイト | primeradiant.com/superpowers |
| 対応環境 | Claude Code · Codex、Gemini CLI、Cursor、Copilot |
| ソースを確認した日 |
writing-plansは承認済み仕様を、履歴を知らない開発者向け実装計画にします。正確なパス、インターフェース、制約、検証コマンドを記録します。
計画は引き継ぎ文書で、実装完了ではありません。まとまった変更単位に分け、入出力を明示して別々の担当者を連携させます。
スキルの SKILL.md より: writing-plans
できること
- 承認仕様を読み関連コードを確認。
- 全体制約、インターフェース、レビュー可能なタスクを定義。
- 計画を自己点検し実行方法を合意。
得られるもの
- docs/superpowers/plans/YYYY-MM-DD-<feature>.mdに手順と検証を含む計画。
使う場面
- この会話を知らない開発者へ複数段階の変更を渡す場合。
向かない場面
- 要件未確定なら先にbrainstorming。
必要なもの
- 承認仕様、ファイル対応エージェント、プロジェクトアクセス。
- 実行・テスト・コミットにはプロジェクトのツールと権限が必要です。
スキルに含まれるファイル
| ファイル・フォルダー | 用途 |
|---|---|
SKILL.md | 計画構造、タスク粒度、引き継ぎ条件。 |
2026-11-19 時点でリポジトリに記載されていたライセンス:MIT。
プロンプト例
インストール後に次のいずれかを入力してください。スキル名を書くと確実にそのスキルが使われます。
- 承認設計を、明示したインターフェースと検証コマンド付き計画にしてください。
- 1ファイル1タスクではなく、まとまった変更か確認してください。
- 新しい開発者向けに移行計画を作り全体制約を明記してください。
writing-plans のインストール方法
導入と権限
プラグイン全体はbrainstormingや実行スキルとの連携を保ちます。計画フォルダーはSKILL.mdだけです。
元の計画はテスト先行やコミットを含みます。倉庫ルールに合わせてください。計画作成で実行はされません。
スキルは SKILL.md ファイルを含むフォルダーです。インストールは一度だけで、エージェントは各セッションの開始時に短い説明を読み、リクエストが当てはまったときにだけ完全な指示を読み込みます。使う環境を選んでください:
Claude Code:プラグインマーケットプレイスから
- ターミナルで
claudeを実行して Claude Code を起動します。 - このプラグインは Anthropic の公式マーケットプレイスにあります。公式マーケットプレイスは Claude Code の初回起動時に自動で追加されます。
- プラグインをインストールします。Claude Code はまず詳細を表示するので、追加されるもの(スキル、フック、MCP サーバー)を確認し、自分用、このリポジトリの全員用、このリポジトリでの自分用のどれにするかを選びます。
/plugin install superpowers@claude-plugins-official - / を入力して
/superpowers:writing-plansを探すか、そのまま作業を依頼します。
セッション内ではなくシェルから行う場合:
claude plugin install superpowers@claude-plugins-officialClaude Code:スキルフォルダーにフォルダーをコピー
このパソコン上のすべてのプロジェクトで使うならスキルのフォルダーを ~/.claude/skills/ に、作業者全員で共有するならリポジトリ内の .claude/skills/ に置きます(コミットしてください)。
git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p ~/.claude/skills
cp -R superpowers/skills/writing-plans ~/.claude/skills/Claude Code はセッション中にこれらのフォルダーで新しいスキルや変更されたスキルを検出します。セッション開始時にスキルフォルダーが存在しなかった場合は、/reload-skills を一度実行してください。その後 /writing-plans と入力するか、作業内容をそのまま伝えます。
Windows では Git Bash または WSL でコマンドを実行するか、エクスプローラーで同じ場所にフォルダーをコピーしてください。
Codex、Gemini CLI、Cursor、GitHub Copilot
これらのエージェントも同じ SKILL.md フォルダーを読みます。4 つすべてがプロジェクト内で読むフォルダーは .agents/skills/ なので、次のコマンドでスキルをそこにコピーします:
git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p .agents/skills
cp -R superpowers/skills/writing-plans .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 以降)。 |
これらの手順の出典
2026-11-14 に各ベンダーのドキュメントと照合しました:
コンテキスト変更に耐える計画
全体制約は全タスクに適用され、インターフェースは各段階の入出力を示します。引き継ぎの暗黙仮定を減らします。
実行前に確認。詳しいコマンドでも、実行と結果確認までは提案にすぎません。
writing-plans に関するよくある質問
計画を実行しますか?
いいえ。作成・確認して合意済み方法へ渡します。
タスクにはどの情報が必要ですか?
正確なパス、インターフェース、制約、実装手順、具体的検証コマンド。
各ファイルを別タスクにしますか?
いいえ。レビュー可能な一貫した変更であるべきで、ファイル境界だけでは不十分です。
有料サービスが必要ですか?
追加サービス指定はありません。エージェント利用料やAPI費用は別途発生し得ます。
ほかの AI スキル
関連スキル
Brainstormingスキル
コミュニティ · Jesse Vincent / Prime Radiantコードを書く前に、初期アイデアを合意済みの設計へ整理します。Subagent-Driven Developmentスキル
コミュニティ · Jesse Vincent / Prime Radiant新しい実装者、限定レビュー、タスク記録で承認計画を実行。planning-with-files スキル
コミュニティ · OthmanAdi長い作業の計画と進捗をファイルに残し、対応フックを使います。To-Specスキル
コミュニティ · Matt Pocock合意済み決定を仕様にまとめ、設定済みトラッカーへ公開。To-Ticketsスキル
コミュニティ · Matt Pocock仕様を実演できる縦割りスライスへ分け、阻害依存を明示。n8n セルフホスティング スキル
コミュニティ · Romuald CzłonkowskiDocker版n8nをデプロイ・保守し、Caddy HTTPS、非公開サービス、検証済みバックアップを整えます。