writing-plan-documents について
writing-plan-documentsは、既存のワークフローに沿って明確な計画文書を書くための文章作成スキルです。目標、決定事項、依存関係、リスク、マイルストーン、受け入れ基準を整理し、根拠のない約束や冗長な記述を避けます。
主な機能
- 01目標と決定事項を冒頭に記載
- 02平易な言葉と具体的な行動を使用
- 03実行に役立つセクションのみを含める
- 04未決事項とトレードオフを説明
- 05依存関係に沿ってマイルストーンを配置
活用シーン
- 01議論に参加していない読者向けの計画書を作成
- 02タスクのリスクと依存関係を記録
- 03未決事項の選択肢を比較
- 04マイルストーンと受け入れ基準を整理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ borkweb/ skills --skill writing-plan-documentsインストール後、Claude Code で/writing-plan-documentsを入力して読み込まれたか確認します。
詳細
計画書の作成
タスクで選択した計画ワークフロー内で、この文章作成の指針を適用してください。アクティブなモデルと推論の強度を引き継いでください。
- 会話を見ていない人に向けて書いてください。まず目標と決定事項を示し、その後に判断に必要な根拠を説明してください。
- 平易な言葉で具体的な行動を示し、不確実性を正確に伝えてください。埋め草、誇張した形容詞、もったいぶった種明かし、対比を煽る導入、直前の内容を繰り返すまとめは取り除いてください。
- 読者の行動に役立つセクションだけを含めてください。必要に応じて、スコープ、アプローチ、依存関係、リスク、未解決の決定事項、受け入れ条件を記載します。他のワークフローで必須とされる構成は維持してください。
- 未解決の決定事項については、選択肢、実行可能な案とそれぞれのトレードオフを示し、根拠がある場合は推奨案を提示してください。決定済みの事項や些細な選択について、代替案を作り出さないでください。
- マイルストーンは依存関係と成果物に沿って順序付けてください。実際の期限や指定されたスケジュールは維持し、不確かな見積もりにはその旨を明記し、コーディング時間とレビューまたは展開にかかる経過時間を分けてください。予定をでっち上げないでください。
- 並列する項目には箇条書きを使い、関係性は文章で説明してください。見出しや段落には新しい情報を含めてください。
- 長い文書では、まず骨子を作成し、その後は1回の作成につき1セクションを追加または編集して、単一の応答が出力上限に近づかないようにしてください。
例:「促進するために」を「〜するために」に置き換えます。「問題はチェックアウトではなく、コンテンツです」を「問題はコンテンツです」に置き換えます。重要な技術用語やドメイン固有の制約は維持してください。
コメント
Markdown 対応