| name | task-questionnaire |
| description | タスクの不明点を洗い出し、重要度分類・既定値候補付きの優先順位付き質問票を作成するスキル。 USE FOR: context gathering, questions, requirements clarification. DO NOT USE FOR: implementation. WHEN: 不明点を確認したい、要件を整理したい。
|
| metadata | {"origin":"user","version":"2.0.0"} |
タスク質問票作成スキル
適用モードの判定
| 条件 | 適用プロトコル | 詳細 |
|---|
| GitHub PR に Assign/コメントリクエスト等でトリガーされている | §1.1 GitHub Issue 起点モード(旧: PR連携) | references/pr-protocol.md |
| 直接チャット・CLI スタンドアロン実行等、GitHub PR と連携していない | §1.2 CLI セッション起点モード(旧: 非PR連携) | references/standalone-protocol.md |
auto-context-review ルール
Issue body、PR body、または CLI 起動時メタデータに <!-- auto-context-review: true --> が指定されている場合は、コンテキストが十分な場合でも設計判断・技術選定・スコープの確認を目的として強制的に質問票を作成する。
- GitHub Issue 起点モード(§1.1): ステップ3〜4 を強制実行し、PR にコメントを投稿する
- 非PR連携モード(§1.2): ステップ3 を強制実行し、
qa/ 配下に質問票ファイルを作成する
推論許可の定義
「推論で進めてください」または「作業を進めてください」の意思表示を 推論許可 と呼ぶ。
- 推論許可を得た場合のみ、未回答項目を推論で補完できる
- 推論で補完した箇所は
TBD(推論: {根拠}) + 「この回答はCopilot推論をしたものです。」と明記する
質問票の形式要件(強制)
- 質問数は固定で無理に増やさず、目的達成に必要なものだけ を過不足なくリストアップすること
- 各質問は 選択式(複数の選択肢を提示する形式)とする
- 各質問に 重要度(最重要/高/中/低の4段階)を判定すること
- 各質問に 分類項目 を付与し、依頼内容に応じて分類項目を自動生成すること
- 各質問に 既定値候補 を1つ設定する(タスクの目的を考慮し最も合理的な選択肢を既定値とする)
- 各既定値候補に 既定値候補の理由 を明記する
- 各質問に 未回答のまま進めた場合の影響 を明記する
- 捏造は絶対に禁止:選択肢・既定値候補・理由に根拠のない情報を含めない
- PR コメント全文投稿(PR連携モード時・必須):
qa/ に質問票ファイルを作成した場合、その 全質問を省略なく PR コメントとしても投稿すること
ガイド一覧(references/)
| ファイル | 内容 |
|---|
references/pr-protocol.md | §1.1 PR連携モード全体(ステップ1〜7、PRコメント投稿テンプレート、回答マージ+統合ドキュメント生成) |
references/standalone-protocol.md | §1.2 非PR連携モード全体(ステップ1〜7、qa/ファイル命名規則、再アサイン時の参照ルール) |
基本質問票作成手順(共通)
以下の手順は §1.1 / §1.2 いずれのモードでも適用される共通手順である。
- タスク目的の確認: ユーザーのプロンプト・会話履歴・作業ディレクトリから目的を読み取る
- 不明点の洗い出し: スコープ・技術選定・アーキテクチャ・データ・セキュリティ・テスト・デプロイ等の観点で網羅的にリストアップ
- 質問票の作成: 洗い出した不明点を分類項目ごとに整理し、重要度4段階で判定した選択式質問にまとめる(既定値候補+理由+未回答時影響付き)
- 回答の収集と整理: 回答を決定事項一覧としてまとめる
入出力例
※ 以下は説明用の架空例です
例1: PR連携時(Issue #42 の AC が不明確)
→ PR にコメントを投稿 + qa/Issue-42-context-review.md を作成
例2: 非PR連携時(直接チャットで曖昧な依頼)
→ qa/membership-rank-logic-qa.md を作成してユーザーに回答を求める
例3: auto-context-review: true 指定時
→ コンテキストが十分でも強制的に質問票を作成(目的に必要な質問を過不足なく)
Related Skills
| Skill | 関係 | 説明 |
|---|
task-dag-planning | 後続 | コンテキスト収集完了後にステップ7で§2計画フェーズへ遷移 |
work-artifacts-layout | 出力先 | qa/ 配下の質問票ファイル配置パス・命名規則 |
agent-common-preamble | 参照元 | 全Agent共通Skills参照リストに本Skillが含まれる |