mcpField
G
grill-with-docs

grill-with-docs

github.com/akillness開発53366 回インストール今日更新
リポジトリ

grill-with-docs について

対話形式の質問で計画や設計を深めながら、ADRと用語集の項目を作成するスキルです。議論と並行して決定事項やドメイン用語を記録したいチームに適しています。

主な機能

  1. 01計画を深める構造化インタビュー
  2. 02議論中のADR作成
  3. 03用語集項目の追加
  4. 04grillingとdomain-modelingスキルの呼び出し

活用シーン

  1. 01実装前の設計の明確化
  2. 02決定事項のADRへの記録
  3. 03計画中のドメイン用語の整理

インストール

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

$npx skills add https://github.com/akillness/jeo-skills --skill grill-with-docs

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

詳細

ドキュメント付きで徹底的に質問する

計画や設計を磨き上げるために徹底的に質問しながら、ADRや用語集も作成します。質問のセッションとあわせて、ADRや用語集の項目も残したい場合に使用してください。次のフレーズで起動します：ドキュメント付きで徹底的に質問する、質問しながらドキュメントを作成する、これについて徹底的に質問してADRを書く。

このスキルは、上流の mattpocock/skills（MIT）からインポートされています。上流ではユーザーが呼び出すスキルです。

このスキルを使用する場面

  • 計画や設計を磨き上げるために徹底的に質問しながら、ADRや用語集も作成します。
  • 質問のセッションとあわせて、ADRや用語集の項目も残したい場合に使用してください。
  • 次のフレーズで起動します：ドキュメント付きで徹底的に質問する、質問しながらドキュメントを作成する、これについて徹底的に質問してADRを書く。

手順

「grilling」と「domain-modeling」に対して、Skill ツールをそれぞれ1回呼び出します。

例

  • まず、このスキルを狭い範囲に適用し、上記の形式どおりの出力になることを確認してから、タスク全体へ範囲を広げます。
  • リポジトリや環境から情報を得る必要がある場合は、ユーザーに尋ねるのではなく、調べてください。

ベストプラクティス

  • 上流の手順をそのまま維持し、独自の判断で変更する場合は、黙って進めず、明確に記録してください。
  • このスキルがユーザーの判断事項として指定している各ポイントで作業を止め、ユーザーに操作を引き継いでください。
  • 小さく元に戻せる変更を優先し、前提は隠さずに明示してください。

参考資料

  • 上流スキル：mattpocock/skills skills/engineering/grill-with-docs/SKILL.md（コミット 3cca18b、MIT）
  • プロジェクト標準：.agent-skills/skill-standardization/SKILL.md
  • バリデータースクリプト：.agent-skills/skill-standardization/scripts/validate_skill.sh

コメント

Markdown 対応