ローカライズされた読書ガイド
writing-plans目的、用途、および情報源
複数ステップのタスクの仕様や要件がある場合、コードに手を加える前にこれを使用します。
ソースを取得しました:
- 出典リポジトリ
- obra/superpowers
- SKILL.md
skills/writing-plans/SKILL.md- リポジトリの Star
- 309,479
- リポジトリの最終更新
- 2026-10-30
- 能力分類
- エージェントのワークフロー
- 最終収集時刻
ライセンス: MIT
ワークフローの抜粋は、Codezによる実行可能な指示ではなく、あくまでも参考資料です。このページを作成するために、サードパーティ製のスキルは実行されていません。
以下の目的とワークフローに関する記述は、上流工程に関する資料であり、読みやすいように整理・翻訳されています。これらは、別途ラベル付けされたCodez編集分析とは区別されます。
このスキルが何をするか
複数ステップのタスクの仕様や要件がある場合、コードに手を加える前にこれを使用します。
上流ワークフローの仕組み
概要
このコードベースや仕様を見たことがないエンジニア向けに実装計画を作成します。正確なインターフェースとテストがわかれば、プロジェクトの言語で慣用的なコードを書くと想定し、計画で選択肢が残されている箇所があれば、合理的な選択をするものとします。エンジニアが知ることができないのは、あなたが決定した内容です。どのファイル、どの名前と署名、仕様のどの値、どのテストが各タスクを証明するかなどです。それらを文書化します。計画全体を、一口サイズのタスクとして提供します。DRY、YAGNI、TDD、頻繁なコミット。開始時に「実装計画を作成するために、writing-plans スキルを使用します」とアナウンスします。コンテキスト: 隔離されたワークツリーで作業している場合は、superpowers:using-git-worktrees実行時のスキル。プランの保存先:docs/superpowers/plans/YYYY-MM-DD-.md
ステップ粒度
各ステップは、検証可能な結果を伴う1つのアクションです。「失敗するテストを作成する」 - ステップ「実行して失敗することを確認する」 - ステップ「テストが合格する最小限のコードを実装する」 - ステップ
上流への航路 · L43 ↗各ステップの内容
実装者がそこから正確に 1 つの妥当なことを書き出せるようになった時点で、ステップは完了です。それが要件のすべてです。曖昧さはありませんが、完全ではありません。各ステップの種類には、曖昧さをなくす要素のみが含まれています。テスト ステップ: テストの名前とアサーション (コードとして)、仕様の正確な値が含まれています。コード ステップ: 正確なシグネチャ (名前、パラメータ、戻り値の型)、それが存在するファイル、および仕様で固定されている特定の値。実装者は本体を記述します。本体は、シグネチャとテストで決定されないアルゴリズム、または仕様で修正された正確なコピーの場合にのみ出現します。検証ステップ: 実行するコマンドと、それが成功したことを示す出力。
上流への航路 · L140 ↗要件とセットアップ
このファイルから要件定義の短い記述が選択されませんでした。これは、スキルに依存関係がないという意味ではありません。リポジトリの設定手順と参照ファイルを確認してください。
制限事項と品質チェック
このファイルからは、個別の制限に関する記述は選択されていません。これは、このスキルがあらゆる入力や環境において安全であることを意味するものではありません。ソースコード全体を確認し、ご自身で結果を検証してください。
まずは安全なトライアルから始めましょう
- サポートされているホストとリポジトリのインストール手順を確認してください。スキルディレクトリと、それに関連付けられているスクリプト、アセット、ドキュメントはまとめて保管してください。SKILL.md単独では依存関係を省略できる場合があります。
- エージェントに実際の入力、希望する出力、および受け入れ基準を指定してください。呼び出し構文と利用可能なツールはホストによって異なります。このサイトは、汎用的なインストールコマンドを前提としていません。
- 使い捨てプロジェクトまたはコピーで、元のワークフローを試してみてください。ファイル、リモートサービス、または課金対象リソースを変更する操作は、許可する前に必ず確認してください。
- 出力結果をソースの品質チェックおよび独自の要件と照らし合わせて検証してください。トリガーが成功したことやリポジトリのスター数が多いことだけでは、正しい結果とは言えません。
詳細は出典元をご覧ください。
関連スキル
翻訳と範囲
この読書ガイドは、ピン留めされた上流からの抜粋を選りすぐっていますSKILL.md翻訳は補助的なものです。完全なマニュアルではなく、互換性テスト済みであることを保証するものでもありません。ご使用前に原文および参照ファイルをお読みください。
この紹介文は、下記に固定表示されているバージョンに関するものです。現在のリポジトリのアクティビティと収集時間は別途表示されます。
- ピン留めされたソース
- 原文を読む ↗
- ソースを取得しました
- ソースコミット
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b- ソースSHA-256
a6c67c1900064347c2a329990dd3c555657c51c3ec53b259a08aa01a2c26139a