コンテンツへスキップ

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

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

できること

  1. 承認仕様を読み関連コードを確認。
  2. 全体制約、インターフェース、レビュー可能なタスクを定義。
  3. 計画を自己点検し実行方法を合意。

得られるもの

  • 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:プラグインマーケットプレイスから

  1. ターミナルで claude を実行して Claude Code を起動します。
  2. このプラグインは Anthropic の公式マーケットプレイスにあります。公式マーケットプレイスは Claude Code の初回起動時に自動で追加されます。
  3. プラグインをインストールします。Claude Code はまず詳細を表示するので、追加されるもの(スキル、フック、MCP サーバー)を確認し、自分用、このリポジトリの全員用、このリポジトリでの自分用のどれにするかを選びます。
    /plugin install superpowers@claude-plugins-official
  4. / を入力して /superpowers:writing-plans を探すか、そのまま作業を依頼します。

セッション内ではなくシェルから行う場合:

claude plugin install superpowers@claude-plugins-official

Claude 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 以降)。
信頼できるスキルだけをインストールする. Anthropic は、信頼できる入手元のスキルだけを使い、それ以外のスキルは使う前にすべてのファイルを読むよう勧めています。スキルは、説明に書かれていない方法でエージェントにコマンドの実行、ファイルの読み取り、データの送信を指示できるからです。

これらの手順の出典

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

コンテキスト変更に耐える計画

全体制約は全タスクに適用され、インターフェースは各段階の入出力を示します。引き継ぎの暗黙仮定を減らします。

実行前に確認。詳しいコマンドでも、実行と結果確認までは提案にすぎません。

writing-plans に関するよくある質問

計画を実行しますか?

いいえ。作成・確認して合意済み方法へ渡します。

タスクにはどの情報が必要ですか?

正確なパス、インターフェース、制約、実装手順、具体的検証コマンド。

各ファイルを別タスクにしますか?

いいえ。レビュー可能な一貫した変更であるべきで、ファイル境界だけでは不十分です。

有料サービスが必要ですか?

追加サービス指定はありません。エージェント利用料やAPI費用は別途発生し得ます。

ほかの AI スキル

関連スキル

スキルのカテゴリー