mcpField
W
writing-plans

writing-plans

github.com/hjewkesエージェントワークフロー443 回インストール35 週間前に更新
リポジトリ

writing-plans について

writing-plans は、実装計画をディレクトリとして作成するスキルです。全体計画とエージェント向けタスク別ブリーフィングをまとめ、構成、形式、ライフサイクル、実行への引き継ぎを定めています。

主な機能

  1. 01計画ディレクトリの構成
  2. 02全体計画とタスク別ブリーフィング
  3. 03機械可読なタスクマニフェスト
  4. 04計画形式とライフサイクルのガイド
  5. 05実行への引き継ぎ方法

活用シーン

  1. 01エージェント向け実装作業の準備
  2. 02作業のタスク別ブリーフィングへの分割
  3. 03完成した計画の実行への引き継ぎ

インストール

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

$npx skills add https://github.com/hjewkes/agent-skills --skill writing-plans

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
briefing-template.md
formats.md
plan-lifecycle.md
scripts/
verify-criteria

詳細

計画の作成

概要

実装計画は、計画ディレクトリとして作成します。簡潔なオーケストレーション計画と、エージェント向けのタスクごとのブリーフィングファイルで構成します。エージェントにはコードベースに関する前提知識が一切ないものとして進めてください。必要な情報をすべて記載します。対象ファイル、完全なコード、テスト、検証基準を明記してください。DRY。YAGNI。TDD。こまめにコミットします。

開始時に宣言します：「実装計画を作成するため、writing-plans スキルを使用します。」

コンテキスト： 単独で呼び出すことも、ブレインストーミングから引き継いで使うこともできます。現在のディレクトリ、または専用のワークツリーで使用できます。

計画の保存先： .claude/plans/YYYY-MM-DD-<feature-name>/

ディレクトリのライフサイクル（作成、実行、クリーンアップ、古い計画の検出）については、references/plan-lifecycle.md を参照してください。

計画ディレクトリの構成

.claude/plans/YYYY-MM-DD-<feature-name>/
  plan.md              # Orchestration plan (<200 lines)
  manifest.json        # Machine-readable task/wave metadata
  briefings/
    task-01.md         # Per-task agent briefing
    task-02.md
    ...

フォーマット仕様

plan.md のテンプレート、manifest.json のスキーマ、ブリーフィングの作成ルールについては、references/formats.md を参照してください。

ブリーフィングファイルのテンプレート：references/briefing-template.md。

実行の引き継ぎ

計画ディレクトリを保存した後、実行方法を提示します。

「計画が完成し、.claude/plans/<plan-id>/ に保存されました。どのように実行しますか？」

選択肢：

  1. 今すぐ実行 — タスクごとにエージェントを割り当て、各タスクの間にレビューを行います（このセッション内で続行します）
  2. 別のセッションで実行 — 新しいセッションを開き、一括実行のために plan-execution を呼び出します

必須のサブスキル： どちらの選択肢でも plan-execution を使用してください。

コメント

Markdown 対応