explain-workflow について
explain-workflowは、ソフトウェア作業に適したワークフローの選択と理解を支援するスキルです。関連スキルと次に使う正確なプロンプト、想定される内容を示し、作業自体は開始しません。
主な機能
- 01依頼を関連ワークフロースキルに対応付け
- 02次に使う正確なプロンプトを提示
- 03想定される結果を説明
- 04計画・実装・診断・レビューを区別
活用シーン
- 01機能依頼に適したワークフローの選択
- 02障害調査の次の手順の確認
- 03レビューや引き継ぎの手順選択
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ klausborges/ workflow-skills --skill explain-workflowインストール後、Claude Code で/explain-workflowを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
skill.tomlagents/openai.yamlreferences/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 にはどう使えばよいですか?」という質問には、説明して次のプロンプトを提示し、黙って作業を開始しないでください。
コメント
Markdown 対応