specsfy-interviewer について
specsfy-interviewerは、仕様の現在のワークフロー状態に応じて聞き取りと更新を行うスキルです。次の工程に影響する不足情報を確認し、合意済みの内容だけを記録して、ゲート判定や状態遷移は担当スキルに引き継ぎます。
主な機能
- 01仕様の状態に応じた聞き取り
- 02次の工程に関わる不足情報の確認
- 03確認済みの決定のみ仕様に反映
- 04合意後のEffort更新
- 05検証と状態遷移の引き継ぎ
活用シーン
- 01初期ドラフトの要件整理
- 02計画前の曖昧さの解消
- 03実行中に判明した変更の検討
- 04受け入れと納品後の確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/specsfy-interviewerを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
現在の状態に基づいて spec と対話する
必須の準備
このスキルを実行する前に、プロジェクトのルートで必ず $specsfy-setup を読み込んでください。自動ハンドオフの場合は、このステップの前にもう一度読み込んでください。
会話で確認済みのルートを再利用し、セットアップで未解決の項目が示された場合は先に進まないでください。
対話モード
対話モード：perguntas。
質問を作成する前に、.specsfy/Spec.md の
Contrato de perguntas numeradas を読み、適用してください。
指定された ID の spec.md を読み、状態フォルダーを確認してください。フォルダーが運用上の状態であり、Status はその検証可能な写しです。spec を規範的な情報源として維持し、担当者が確認した回答、選択、理由のみを記録してください。
対話を進める
- spec、そのゲート、タスク、エビデンス、プロジェクトのコンテキストを読みます。
- 次の段階に最も影響する実際の不足を特定し、中心となる契約に沿って質問のラウンドを作成します。
- 各ラウンドの後に spec を再評価します。確認済みの情報を繰り返したり、形式的な質問をしたりしないでください。
- 回答を確認した後、spec の適切なセクションを更新します。新しい情報によって必要な能力が変わる場合は、Effort も調整してください。
- 検証、実装、または移行の責任を該当するスキルに引き継ぎます。このスキルはゲートを承認せず、タスクを実行せず、spec を移動しません。
フォルダーに応じて焦点を調整する
| フォルダー | 対話の焦点 |
|---|---|
draft | 問題、関係者、動作、ルール、失敗、受け入れ条件 |
defined | 計画、データ、セキュリティ、またはテストに影響する曖昧さ |
planned | 依存関係、タスクの順序、TDD および BDD の戦略 |
in-progress | 遅れて発生した変更、実行時の発見、スコープへの影響 |
review | 観察された受け入れ状況、ドキュメント、引き渡し時の未解決事項、差し戻し |
completed | 引き渡し内容を変更するための聞き取りは行わず、正しいフローで変更を開始または再開します |
inbox では質問を受け付けません。backlog は引き続き
$specsfy-02-backlog の担当であり、必要に応じてこの発見プロトコルを呼び出します。
Effort を更新する
Effort は必要な推論および実行能力の見積もりとして使用し、所要期間としては使用しないでください。1〜10 の整数と、簡潔な理由を選んでください。
- 1–2：アトミックな変更で、既知のパターンに従うもの
- 3–4：局所的な変更と直接的なテスト
- 5–6：複数ファイル、または既知の統合
- 7–8：横断的な変更、移行、または外部統合
- 9–10：アーキテクチャ、不確実性の高さ、または頻繁な人手によるレビュー
確認後に実行します。
specsfy effort <id-da-spec> <1-10> --reason "<o que mudou a estimativa>"
このコマンドは spec.md の Effort、日付、理由、履歴を更新します。
見積もりをモデル名に結び付けないでください。この範囲を使って、実行プロファイル light、standard、high、maximum を選択してください。
ClickUpfy がある場合に統合する
プロジェクトに clickupfy-* スキルがあり、spec に ClickUp Task が含まれている場合、状態の移行または Effort の調整後に、適切な ClickUpfy スキルを読み込んでください。プロジェクトで設定されたマッピングを使用してください。設定がない場合は、
draft／defined／planned を To Do に、in-progress を In Progress に、
review を In Review に、completed を Complete に対応させます。
ローカルの状態を正とします。リモートの更新が行われない場合は、同期が完了したと宣言せず、未解決事項を spec に記録してください。
制限事項
- 回答、Effort、タスクとの関連付け、リモートのステータスを捏造しないでください。
completedにある spec を、新しい変更を始める方法として変更しないでください。- システムコマンドでフォルダーを移動しないでください。ゲートを通過した後、担当スキルでのみ
specsfy transitionを使用してください。 - 統合が設定されていない spec に ClickUp を必須にしないでください。