grill-with-docs について
Grill With Docsは、インタビュー形式の問いかけとドメインモデリングを組み合わせたスキルです。計画や長期的に使うドメイン用語の明確化に向いており、共通理解をユーザーが確認してから必要な文書を更新します。
主な機能
- 01グリリングとドメインモデリングの統合
- 02核心的な質問と推奨回答
- 03ユーザーのフィードバックを待機
- 04既存ドキュメントとコードの確認
- 05用語の確定後にCONTEXT.mdを更新
- 06条件を満たす場合のみADRを作成
活用シーン
- 01反復的な質問で計画を明確化
- 02曖昧なドメイン用語を解消
- 03合意したドメイン用語をCONTEXT.mdに記録
- 04重要な決定をADRとして記録
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ carlitose/ agent-skills --skill grill-with-docsインストール後、Claude Code で/grill-with-docsを入力して読み込まれたか確認します。
詳細
ドキュメントを使ったグリリング
スラッシュコマンドが利用できる場合は、/grillingと/domain-modelingを組み合わせるのと同じです。
それ以外の場合は、リンク先の両方のスキルを直接読み込み、それに従ってください。
- インタビューループには
grillingを使用します。最前線にある質問を複数ラウンドで提示し、それぞれに推奨回答を示し、フィードバックを待ちます。ユーザーが共通認識を確認するまで、計画を実行しないでください。 - 永続的な用語には
domain-modelingを使用します。既存のコンテキストドキュメントとコードを調べ、曖昧な用語を問い直します。用語の意味が確定した場合にのみCONTEXT.mdを更新し、ADRの基準を満たす場合にのみADRを作成します。
インタビューの主導権はgrillingにあり、ドキュメント作成はそれに従属します。確認の段階を経る前にドキュメントを作成したり、このバリアントが有効になっているというだけで作成したりしないでください。確認済みの会話から永続的なドメイン用語が生まれた場合や、本当に重要な決定がなされた場合にのみ、必要に応じてドキュメントを作成または更新してください。
コメント
Markdown 対応