# 実装計画の作成 (writing-plans)

> 仕様や要件を、ファイル・インターフェース・テストを明記した小さなタスクからなる実装計画にまとめます。

- カテゴリ: [タスク分解](https://www.myskills.tools/ja/categories/task-breakdown/)
- 提供元: コミュニティ · Jesse Vincent
- リポジトリ: https://github.com/obra/superpowers/tree/main/skills/writing-plans (commit 8ca22db)
- SKILL.md: https://github.com/obra/superpowers/blob/main/skills/writing-plans/SKILL.md
- インストールコマンド: `npx skills add obra/superpowers --skill writing-plans`
- ライセンス: MIT
- 対応ツール: Claude Code, Codex, Cursor, Gemini CLI, OpenCode
- 権限: read-repo ✓, write-files ✓, shell ✗, network ✗
- 状態: スキャン済み
- ルールスキャンですべてのリスクを検出できるわけではありません。インストール前にこのスキルの SKILL.md を読み、権限を確認してください。

## 基本ルール

各ステップは、実装者が合理的なものを一つだけ書ける粒度にし、曖昧さもコードの書き写しも残さないこと。

## 実行フェーズ

1. **スコープ確認** — 仕様が独立した複数のサブシステムにまたがる場合は、サブシステムごとに計画を分けるよう提案します。
2. **ファイル構成を決める** — 作成・変更するファイルとその責務を先に洗い出し、技術レイヤーではなく責務で分割します。
3. **タスクを書く** — 決まったヘッダーとテンプレートで、各タスクのファイル・インターフェース・TDD の手順（失敗するテスト、実行、最小実装、再実行、コミット）を書きます。
4. **セルフレビュー** — 仕様と照らし合わせ、網羅性・ステップの明確さ・型の一貫性・Review Focus・分量を確認し、その場で直します。
5. **実行の引き継ぎ** — docs/superpowers/plans/ に保存してレビューを依頼し、Subagent-driven か Native かの実行方法を選んでもらいます。

## 権限の説明（SKILL.md より）

| 機能 | 必要か | 説明 |
|---|---|---|
| ファイル書き込み | 一部で必要 | 計画ドキュメントのみを書きます（既定は docs/superpowers/plans/）。コードは変更しません。 |
| コマンド実行 | 不要 | テストやコミットのコマンドは計画に記載するだけで、このスキル自体は実行しません。 |
| 外部通信 | 不要 | ローカルの仕様とコードベースだけを基に作成し、ネットワークは使いません。 |

## SKILL.md のフロントマター（YAML）

```yaml
---
name: writing-plans
description: Use when you have a spec or requirements for a multi-step task, before touching code
---
```

ホーム: https://www.myskills.tools/ja/ · URL: https://www.myskills.tools/ja/skills/writing-plans/