mcpField
E
explain-workflow

explain-workflow

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

explain-workflow について

explain-workflowは、ソフトウェア作業に適したワークフローの選択と理解を支援するスキルです。関連スキルと次に使う正確なプロンプト、想定される内容を示し、作業自体は開始しません。

主な機能

  1. 01依頼を関連ワークフロースキルに対応付け
  2. 02次に使う正確なプロンプトを提示
  3. 03想定される結果を説明
  4. 04計画・実装・診断・レビューを区別

活用シーン

  1. 01機能依頼に適したワークフローの選択
  2. 02障害調査の次の手順の確認
  3. 03レビューや引き継ぎの手順選択

インストール

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

$npx skills add https://github.com/klausborges/workflow-skills --skill explain-workflow

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

同梱ファイル

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

skill.toml
agents/
openai.yaml
references/
workflow-language.md

詳細

ワークフローの説明

ユーザーの視点からワークフローを説明します。workflow-language.md を使用してください。

このスキルはガイドであり、ルーターではありません。関連するスキル、次に入力する正確なプロンプト、期待できる内容を伝えてください。依頼されない限り、作業を開始しないでください。

呼び出し方

  • 明示的な指定:use plan-work to plan this feature または use review-work to review this diff。
  • 自然な表現:plan this feature、diagnose this failure、write a handoff、または review this change。
  • 修正指示:エージェントが誤ったワークフローを選んだ場合は、スキル名を指定します。

レシピ

  • 不確実性やリスクが高い作業、または明示的な計画の依頼 → plan-work。依頼があれば、計画はチャット内で完結できます。それ以外の場合は、一時的な Plan を保存するのがデフォルトです。
  • Plan、引き継ぎ、調査結果、直接の概要、ドキュメント作業、修正、リファクタリングなど、すでに方針が決まっている作業 → implement-work。Plan によって作業が管理される場合に限り、Plan の追跡を適用します。検証と、独立した新しいコンテキストでのレビューは常に必要です。
  • 小規模で明確な実装 → 直接作業します。納品前に、新しいコンテキストでのレビューを実施します。
  • コードの概要把握 → explain-codebase。
  • 根本原因の調査 → diagnose-issue。修正には明示的な許可が必要です。
  • Plan、実装、継続作業、成果物のレビュー → review-work。別途修正を依頼されない限り、レビューは読み取り専用です。
  • 継続作業用のプロンプトまたはファイル → write-handoff。ファイルやチャットへの保存と、Immediate/Durable のライフサイクルは別です。
  • アーキテクチャ改善の機会を探す → improve-architecture。具体的な変更のレビューには review-work を使用します。
  • 動作を維持した範囲内での限定的な簡素化 → simplify-work。
  • 使い捨ての設計実験 → plan-prototype。
  • どれを使うべきか不確かだが、作業規模が大きい → use-workflow。

ユーザーが完全な一覧を求めない限り、回答は簡潔にしてください。「X にはどう使えばよいですか?」という質問には、説明して次のプロンプトを提示し、黙って作業を開始しないでください。

コメント