mcpField
W
writing-plan-documents

writing-plan-documents

github.com/borkwebドキュメント859 回インストール2 日前に更新
リポジトリ

writing-plan-documents について

writing-plan-documentsは、既存のワークフローに沿って明確な計画文書を書くための文章作成スキルです。目標、決定事項、依存関係、リスク、マイルストーン、受け入れ基準を整理し、根拠のない約束や冗長な記述を避けます。

主な機能

  1. 01目標と決定事項を冒頭に記載
  2. 02平易な言葉と具体的な行動を使用
  3. 03実行に役立つセクションのみを含める
  4. 04未決事項とトレードオフを説明
  5. 05依存関係に沿ってマイルストーンを配置

活用シーン

  1. 01議論に参加していない読者向けの計画書を作成
  2. 02タスクのリスクと依存関係を記録
  3. 03未決事項の選択肢を比較
  4. 04マイルストーンと受け入れ基準を整理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/borkweb/skills --skill writing-plan-documents

インストール後、Claude Code で/writing-plan-documentsを入力して読み込まれたか確認します。

詳細

計画書の作成

タスクで選択した計画ワークフロー内で、この文章作成の指針を適用してください。アクティブなモデルと推論の強度を引き継いでください。

  • 会話を見ていない人に向けて書いてください。まず目標と決定事項を示し、その後に判断に必要な根拠を説明してください。
  • 平易な言葉で具体的な行動を示し、不確実性を正確に伝えてください。埋め草、誇張した形容詞、もったいぶった種明かし、対比を煽る導入、直前の内容を繰り返すまとめは取り除いてください。
  • 読者の行動に役立つセクションだけを含めてください。必要に応じて、スコープ、アプローチ、依存関係、リスク、未解決の決定事項、受け入れ条件を記載します。他のワークフローで必須とされる構成は維持してください。
  • 未解決の決定事項については、選択肢、実行可能な案とそれぞれのトレードオフを示し、根拠がある場合は推奨案を提示してください。決定済みの事項や些細な選択について、代替案を作り出さないでください。
  • マイルストーンは依存関係と成果物に沿って順序付けてください。実際の期限や指定されたスケジュールは維持し、不確かな見積もりにはその旨を明記し、コーディング時間とレビューまたは展開にかかる経過時間を分けてください。予定をでっち上げないでください。
  • 並列する項目には箇条書きを使い、関係性は文章で説明してください。見出しや段落には新しい情報を含めてください。
  • 長い文書では、まず骨子を作成し、その後は1回の作成につき1セクションを追加または編集して、単一の応答が出力上限に近づかないようにしてください。

例:「促進するために」を「〜するために」に置き換えます。「問題はチェックアウトではなく、コンテンツです」を「問題はコンテンツです」に置き換えます。重要な技術用語やドメイン固有の制約は維持してください。

コメント