mcpField
C
create-plan

create-plan

github.com/tailcallhq開発7.6k124 回インストール1 日前に更新
リポジトリ

create-plan について

create-planは、複雑な実装依頼を扱うエージェント向けの計画作成スキルです。コードベースを調査し、構造化したMarkdown計画を作成して必須検証を行いますが、コードは変更しません。

主な機能

  1. 01コードベースの構造と処理の分析
  2. 02ファイル参照付きMarkdown計画
  3. 03チェックボックス形式の実装タスク
  4. 04計画の必須検証
  5. 05リスク、前提、代替案の記録

活用シーン

  1. 01複雑な変更の着手前の整理
  2. 02アーキテクチャ案の比較
  3. 03実装リスクの文書化
  4. 04エージェント向け実行計画の作成

インストール

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

$npx skills add https://github.com/tailcallhq/forgecode --skill create-plan

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

同梱ファイル

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

README.md
validate-all-plans.sh
validate-plan.sh
references/
example-plan.md
plan-template.md

詳細

実装計画の作成

実際にコードを変更することなく、戦略的な指針を示す包括的な実装計画を作成します。

使用する場面

  • ユーザーが明示的に計画、ロードマップ、または実装戦略を求めている場合
  • 実装前に体系的な分解が必要な複雑なタスク
  • リスク評価や代替アプローチの分析が必要な場合
  • アーキテクチャ上の判断について、実装前の分析が必要な場合

計画プロセス

1. 初期評価

コードベースを調査し、以下を把握します。

  • プロジェクトの構造と構成
  • 関連するファイルとコンポーネント — 全体のフローを理解するため、十分に読み込んでください
  • 既存のパターンと規約
  • 想定される課題とリスク
  • エントリーポイントから最終的な利用箇所までのデータフロー

search、sem_search、read ツールを使ってコードベースを調べます。ユースケースについてさらに詳しい調査が必要な場合は、sage を使います。計画では、filepath:line 形式で出典を明示してください。

2. 戦略的な計画の作成

plans/ ディレクトリに、次の命名規則で Markdown の計画ファイルを作成します。plans/{YYYY-MM-DD}-{task-name}-v{N}.md

例：plans/2025-11-24-add-auth-v1.md

3. 計画の検証

必須： 検証スクリプトを実行し、計画がすべての要件を満たしていることを確認してください。

./.forge/skills/create-plan/validate-plan.sh plans/{YYYY-MM-DD}-{task-name}-v{N}.md

エラーや警告がある場合は修正し、すべてのチェックに合格するまで再検証してください。

4. 計画の構成
# [Task Name]

## Objective

[Clear statement of goal and expected outcomes]

## Implementation Plan

- [ ] 1. [First task with detailed description and rationale]
- [ ] 2. [Second task with detailed description and rationale]
- [ ] 3. [Third task with detailed description and rationale]

## Verification Criteria

- [Criterion 1: Specific, measurable outcome]
- [Criterion 2: Specific, measurable outcome]

## Potential Risks and Mitigations

1. **[Risk Description]**
   Mitigation: [Specific mitigation strategy]

2. **[Risk Description]**
   Mitigation: [Specific mitigation strategy]

## Alternative Approaches

1. [Alternative 1]: [Brief description and trade-offs]
2. [Alternative 2]: [Brief description and trade-offs]

重要な要件

  • 計画の作成後、必ず ./.forge/skills/create-plan/validate-plan.sh を使って計画を検証してください
  • 実装タスクにはすべて、必ずチェックボックス形式（- [ ]）を使ってください
  • 実装計画のセクションでは、番号付きリストや通常の箇条書きを使用しないでください
  • 計画にコード、コードスニペット、コード例を記載しないでください
  • 何を、なぜ、どのファイルに影響するか、どの箇所と連携するかを含め、包括的なタスクを記述してください
  • ファイル参照には filepath:line 形式を使ってください（例：crates/forge_repo/src/provider.rs:45）
  • 各タスクの明確な根拠を含めてください
  • 具体的で測定可能な検証基準を提示してください
  • 要件が曖昧な場合は、置いた前提を記録してください
  • 具体的な「方法」ではなく、戦略的な「何を」「なぜ」を中心にしてください
  • コードではなく、自然言語で実施内容を説明してください

ベストプラクティス

  • 要件が曖昧な場合は、妥当な前提を置いてください
  • コードベースのパターンを参考に、ベストプラクティスを推定してください
  • 複雑な課題には、複数の解決策を提示してください
  • 網羅性と実行可能性のバランスを取りましょう
  • 実装エージェントが段階的に実行できる計画を作成してください

対象範囲

これは計画のみを行うスキルです。

  • ✅ コードベースを調査し、構造を分析する
  • ✅ 戦略的な計画とドキュメントを作成する
  • ✅ リスクを評価し、代替案を提案する
  • ✅ 自然言語で実装内容を説明する
  • ❌ 実際にコードを変更する
  • ❌ ファイルを変更したり、実装を作成したりする
  • ❌ テストやビルドコマンドを実行する
  • ❌ 計画にコード、コードスニペット、コード例を記載する

ユーザーが実装作業を依頼した場合は、実装エージェントへの切り替えを提案してください。

コメント

Markdown 対応