Communitygithub.com

cdcoonce/Portfolio_Website

ユーザーの計画や設計を徹底的に尋問し、決定木の各枝を解決することで相互理解に達するスキル。ユーザーが計画をストレステストしたい、設計について厳しく問われたい、または「grill me」と発言したときに使用します。

Portfolio_Website とは?

このスキルは、AIエージェントとユーザーの間で計画や設計に関する**相互理解**を構築するための体系的な尋問プロセスを提供します。Grill Meは、計画に含まれる暗黙の前提、未表明の制約、曖昧な決定を一つ一つ明らかにし、実装開始前にすべての決定枝を解決することを目指します。主にClaude CodeやCodexなどのAIエージェントで使用することを想定しており、AskUserQuestionツールを介して質問を行い、ユーザーの判断が必要な決定にのみ焦点を当てます。このスキルは、決定ログを構造化テーブルで追跡し、コードベースやプロジェクト文書の調査を自動化することで、効率的かつ漏れのない意思決定を支援します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cdcoonce/Portfolio_Website/tree/HEAD/.claude/skills/grill-me

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Grill Me — 系統的な尋問による相互理解

哲学

グリルの目的は、エージェントとユーザーの間で相互理解を構築することです。すべての計画には暗黙の前提、未表明の制約、曖昧な決定が含まれています。グリルは決定木のすべての枝を一つずつ歩き、両者が完全に一致するまで進めます。

目標は、実装開始前にゼロの未検討前提を実現することです。

基本指示

  1. すべての質問に AskUserQuestion を使用する。 すべての尋問質問は AskUserQuestion ツールを介して行います。質問をプレーンテキストとして出力してはいけません。
  2. ドメイン内でバッチ処理する。 同じ尋問ドメイン内の関連質問を最大4つまで1回の AskUserQuestion 呼び出しにまとめます。異なるドメインの質問を1回の呼び出しに混ぜてはいけません。
  3. 推奨を先頭に置く。 推奨する回答は常に最初のオプションとし、ラベルに (Recommended) を追加します。
  4. 質問の前に調査する。 質問の答えがコードベースの読み取り、ドキュメントの確認、既存パターンのチェックで得られる場合は、質問する代わりにそれを行います。ユーザーの判断が必要な決定についてのみ質問します。
  5. 依存関係を順に解決する。 一部の決定は他の決定に依存します。依存チェーンを特定し、上流の決定から先に解決します。
  6. すべてを構造化レコードで追跡する。 決定ログを構造化テーブルとして維持します。解決済みの質問ごとに、ドメイン、トピック(ヘッダー)、選択されたオプションラベル、および「その他」が選択された場合のカスタムテキストを記録します。ログは会話コンテキスト内で提示します。ファイルI/Oは行いません。
  7. 前提は残さない。 暗黙的に示されていても明示されていないものがあれば表面化させます。明白に見えることも確認します。相互理解とは明示的な合意であり、気まずい沈黙ではありません。
  8. 具体的に留める。 質問は具体的な動作、データフロー、ユーザーから見える成果に基づいて構成します。抽象的な概念ではありません。

尋問前のセットアップ

質問を始める前に、黙ってコンテキストを構築します。

  1. ユーザーがグリルしてほしい計画または設計文書を読む
  2. コードベースを探索し、既存のパターン、制約、関連コードを確認する
  3. 最近のgit履歴をチェックして、現在の作業のコンテキストを得る
  4. project.md と CLAUDE.md を読み、プロジェクトの規約を確認する

次に、現在の理解を尋問ドメインごとに整理した簡単な要約を提示します。これにより、ユーザーは枝ごとの質問に入る前に大きな誤解を修正できます。

尋問ドメイン

references/interrogation-domains.md で定義されたドメインを処理します。順序は計画に合わせて調整します。構築するものに最も中心的なドメインから始め、外側に向かって進めます。明らかに関係のないドメインはスキップします。

尋問プロセス

1. 計画の理解を読み取り、要約する
2. ユーザーが要約を確認または修正する
3. 各尋問ドメインについて(関連性順に):
   a. このドメイン内のすべての決定点と前提を特定する
   b. 関連する決定点を最大4つの質問のバッチにグループ化する
   c. 各バッチに対して、1回の AskUserQuestion 呼び出しを実行する
      (各質問の最初に推奨を置く)。選択されたすべてのオプションを記録する。
   d. ドメイン内のすべての点を解決した後、行われた決定を要約する
      ドメインの決定を構造化テーブル形式の行として提示する。
4. すべてのドメインをカバーした後:
   - 完全な決定ログを構造化テーブルとして提示する:
     | # | ドメイン | トピック | 決定 | 備考 |
     |---|----------|----------|------|------|
     | 1 | 意図 | 目標 | その他 | 社内向け運用チーム用ダッシュボード、顧客向けではない |
   - 未解決または延期された項目があればフラグを立てる
   - 再検討が必要なドメインがないか尋ねる

質問形式

すべての質問は AskUserQuestion ツールを介して行う必要があります。各呼び出しは次のように構成します。

{
  "question": "Oura API が429を返した場合、レート制限をどのように処理すべきですか?",
  "header": "レート制限",
  "options": [
    {
      "label": "指数バックオフ(推奨)",
      "description": "指数バックオフ(1秒、2秒、4秒)で再試行します。一時的な制限を適切に処理し、src/api_client.py ですでに使用されている再試行パターンと一致します。"
    },
    {
      "label": "次回実行にキューイング",
      "description": "リクエストをスキップし、次のスケジュール実行に追加します。より簡単ですが、データが1サイクル遅れます。"
    }
  ],
  "multiSelect": false
}

依存関係: この質問が基づく先行決定がある場合は question テキスト内に記載するか、スタンドアロンの場合は「依存関係なし」と記します。

バッチ処理質問の例

{
  "questions": [
    {
      "question": "主要なデプロイ先は何ですか?",
      "header": "デプロイ",
      "options": [
        {
          "label": "Docker + ECS(推奨)",
          "description": "既存のインフラと一致します。デプロイパイプラインはすでに存在します。"
        },
        {
          "label": "Kubernetes",
          "description": "より柔軟ですが、新しいインフラのセットアップが必要です。"
        },
        {
          "label": "サーバーレス",
          "description": "運用負荷は低いですが、コールドスタートレイテンシの懸念があります。"
        }
      ],
      "multiSelect": false
    },
    {
      "question": "どのモニタリングアプローチを含めるべきですか?",
      "header": "モニタリング",
      "options": [
        {
          "label": "構造化ログ(推奨)",
          "description": "CloudWatch へのJSONログ。検索可能でアラート設定可能。"
        },
        {
          "label": "APMトレース",
          "description": "リクエストフロー可視化のための分散トレーシング。"
        },
        {
          "label": "カスタムメトリクス",
          "description": "Datadog でのビジネス固有のカウンターとゲージ。"
        }
      ],
      "multiSelect": true
    }
  ]
}

プレビューの使用

ユーザーがコードスニペット、アーキテクチャ図、スキーマ形状、構成例など具体的な成果物を視覚的に比較する必要がある場合、オプションの preview フィールドを使用します。プレビューコンテンツは等幅ボックス内のマークダウンとしてレンダリングされ、横並びで比較できます。

プレビューを使用するタイミング:

  • 2つのコードパターンや実装を比較する場合
  • 異なるスキーマ形状やデータ構造を示す場合
  • ASCII図を使用したアーキテクチャの代替案を提示する場合

制約: プレビューはシングルセレクトのみです(multiSelect: false)。マルチセレクトが必要な場合は、プレビューを省略し、代わりに説明を使用します。

プレビュー付きの例:

{
  "question": "データパイプラインにはどのパターンを使用すべきですか?",
  "header": "パイプライン",
  "options": [
    {
      "label": "ジェネレータパイプライン(推奨)",
      "description": "遅延評価、大規模データセットでメモリ効率が良い。",
      "preview": "def pipeline(source):\n    for record in source:\n        cleaned = clean(record)\n        validated = validate(cleaned)\n        yield validated"
    },
    {
      "label": "バッチパイプライン",
      "description": "すべてのレコードを一度に処理します。よりシンプルですがメモリ使用量が増加します。",
      "preview": "def pipeline(source):\n    records = list(source)\n    cleaned = [clean(r) for r in records]\n    validated = [validate(r) for r in cleaned]\n    return validated"
    }
  ],
  "multiSelect": false
}

質問に関するルール

  • すべての質問に AskUserQuestion を使用する。 絶対に。
  • 最初のオプション = 推奨。 最初のオプションには常にラベルに (Recommended) を付けます。
  • 関連質問はバッチ処理する。 同じドメインの関連質問を最大4つまで1回の AskUserQuestion 呼び出しにまとめます。異なるドメインの質問は別々の呼び出しにする必要があります。
  • ツールの制約を尊重する。 質問あたり2〜4オプション。ヘッダーは最大12文字。オプションが相互排他的でない場合(例:「どのテストアプローチを使用すべきか?」や「どのドメインをカバーする必要があるか?」)は multiSelect: true を使用します。
  • オプションをフィルタリングする。 有効な選択肢が4つ以上ある場合は、コードベースのコンテキストに基づいて最も関連性の高い3つを提示します。ユーザーはリストにないものに対して「その他」を選択します。
  • 具体的にする。 「エラーをどのように処理すべきか?」は漠然としすぎています。「Oura API が429を返した場合、バックオフで再試行するか、次回実行にキューイングすべきか?」は具体的です。
  • 根拠を示す。 推奨がコードベースで見つけたものに基づいている場合は、ファイルと行を参照します。
  • 回答を受け入れる。 ユーザーが決定したら、それを記録して次に進みます。後続の決定が以前の決定と矛盾を生じない限り、再議論しないでください。

フォールバック(AskUserQuestion が利用できない場合)

実行環境で AskUserQuestion が利用できない場合は、次のテキスト形式にフォールバックします。

[ヘッダー] — [トピック]

[質問の明確な記述]

推奨: [推奨内容とその理由]

代替案:

  • (A) [オプション] — [トレードオフ]
  • (B) [オプション] — [トレードオフ]

いつ停止するか

グリルは次の場合に完了します。

  • 関連するすべての尋問ドメインがカバーされた場合
  • すべての決定枝が解決されるか、明示的に延期された場合
  • ユーザーが相互理解を確認した場合

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

cdcoonce/Portfolio_Website

Git commit workflow with enforced conventional commit style. Use when Claude needs to stage and commit changes, craft commit messages, or the user asks to commit, make a commit, or save their work. Ensures consistent commit message format, proper scoping, and atomic commits across the project.

cdcoonce/Portfolio_Website

AI-powered code quality analysis for Python, Markdown, and Mermaid diagrams. Use this skill when: (1) reviewing code for quality issues, (2) checking Python files for PEP8 violations, unused code, missing type hints, docstring problems, complexity issues, or potential runtime errors, (3) validating Markdown documentation for broken links, heading structure, or formatting issues, (4) validating Mermaid diagram syntax, (5) the user asks for a "code review" or "quality check", (6) analyzing code snippets pasted in conversation, or (7) suggesting and applying fixes for code quality issues.

cdcoonce/Portfolio_Website

Deploy the portfolio chat agent Lambda function to AWS. Use when the user asks to deploy, redeploy, push to Lambda, update the chat agent, or after updating context files or lambda_function.py. Rebuilds the knowledge base, packages dependencies, and deploys to AWS Lambda.

cdcoonce/Portfolio_Website

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

cdcoonce/Portfolio_Website

Orchestrate the full GitHub-issues-driven development lifecycle. 7-phase pipeline from brainstorm through PR with state tracking and cross-conversation resume. Use when user says "dev cycle", "development workflow", "full development pipeline", or invokes /dev-cycle.

cdcoonce/Portfolio_Website

Production Python coding standards with automatic version detection (3.10-3.13). Use when writing, reviewing, or refactoring Python to ensure adherence to modern type syntax, LBYL exception handling, pathlib operations, ABC-based interfaces, and production-tested patterns. Not Dagster-specific - applies to any Python project.

cdcoonce/Portfolio_Website

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

cdcoonce/Portfolio_Website

GitHub CLI (gh) integration for managing issues, pull requests, branches,

cdcoonce/Portfolio_Website

Explore a codebase to find opportunities for architectural improvement, focusing on making the codebase more testable by deepening shallow modules. Use when user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more AI-navigable.

cdcoonce/Portfolio_Website

CEO/founder-mode plan review. Rethink the problem, find the 10-star product, challenge premises, expand scope when it creates a better product. Three modes: SCOPE EXPANSION (dream big), HOLD SCOPE (maximum rigor), SCOPE REDUCTION (strip to essentials). Use when the user asks for a plan review, CEO review, mega review, or wants a plan challenged/stress-tested before implementation.

cdcoonce/Portfolio_Website

Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices. Use when user wants to convert a PRD to issues, create implementation tickets, or break down a PRD into work items.

cdcoonce/Portfolio_Website

Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices, saved as a local Markdown file in docs/plans/. Use when user wants to break down a PRD, create an implementation plan, plan phases from a PRD, or mentions "tracer bullets".

cdcoonce/Portfolio_Website

Generate or update the `.claude/docs/project.md` file that gives Claude project-specific context. Use this skill when the user asks to create, update, regenerate, or refresh project context, or says things like "update project.md", "generate project context", "this repo needs a project.md", or "Claude doesn't know about this project". Also trigger when onboarding Claude to a new repository for the first time.

cdcoonce/Portfolio_Website

Generate comprehensive, high-quality README.md files for code repositories. Use this skill whenever the user asks to create, write, generate, update, or improve a README for any project or repository. Also trigger when the user says things like "document this project", "write docs for this repo", "this repo needs a README", "help me onboard developers to this codebase", or asks for project documentation in markdown. Even if the user just says "README" or "readme" in the context of a codebase, use this skill.

cdcoonce/Portfolio_Website

Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue. Use when user wants to plan a refactor, create a refactoring RFC, or break a refactor into safe incremental steps.

cdcoonce/Portfolio_Website

Set up pre-commit hooks for the current repo. Use when user wants to add pre-commit hooks, configure commit-time linting, formatting, type checking, or testing. Triggers on "pre-commit", "git hooks", "linting hooks", or /setup-pre-commit.

cdcoonce/Portfolio_Website

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

cdcoonce/Portfolio_Website

Triage a bug or issue by exploring the codebase to find root cause, then create a GitHub issue with a TDD-based fix plan. Use when user reports a bug, wants to file an issue, mentions "triage", or wants to investigate and plan a fix for a problem.

cdcoonce/Portfolio_Website

Rewrites the prose sections of wiki pages in-place. Reads source files to understand current context, then updates only the content inside <!-- claude:prose --> ... <!-- claude:prose:end --> markers. Never touches <!-- generated:start --> ... <!-- generated:end --> blocks. Supports targeting a single page with /update-wiki {PageName}.

cdcoonce/Portfolio_Website

Create a PRD through user interview, codebase exploration, and module design, then submit as a GitHub issue. Use when user wants to write a PRD, create a product requirements document, or plan a new feature.

関連スキル