Communitygithub.com

2023Anita/harness-interview-workflow

Codexスキル。曖昧なタスクを盲点スキャン、インタビュー質問、ルートオプション、承認ゲート付き実行に変換します。

harness-interview-workflow とは?

このスキルは、AIエージェント(特にCodex)が高コストな作業を実行する前に、入念な事前調査と承認プロセスを強制するためのものです。ユーザーからの曖昧または複雑なリクエストを受け取ると、まず目標と成果物を明確にし、盲点スキャンを通じて既知・未知の要素を分類します。その後、アーキテクチャやリスクに最も影響を与える1〜3つの質問を厳選して行い、十分なコンテキストが得られた時点で2〜3の実行ルート案を提示します。ユーザーが明示的に承認(「確認実行」「続ける」など)するまで実行は開始されず、承認後は詳細な実装計画を作成し、リスクのあるアクションには承認ゲートを設定します。主なユースケースは、要件が不明瞭な新規機能の設計や、高リスクな変更の事前検討です。対応プラットフォームはCodexで、特にコード生成やアーキテクチャ設計の場面で効果を発揮します。実装中のエッジケースや逸脱は実行ノートに記録され、ユーザーの承認範囲内で保守的なパスが選択されます。

対応~Claude Code✓Codex CLI~Cursor
npx skills add 2023Anita/harness-interview-workflow

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

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

ドキュメント

Harness Interview Workflow

概要

このスキルは、Codexが高コストな作業を行う前に減速させるために使用します。曖昧または複雑なリクエストを構造化されたインタビューに変換します。未知の要素を発見し、最も影響力の高い質問のみを行い、ルート案を提案し、実行前に明示的な承認を待ちます。

運用契約

  1. ユーザーの目標と想定される成果物を言い換える。
  2. 実行を提案する前に盲点スキャンを行う。
  3. 1ラウンドにつき最大1〜3問の質問をする。
  4. 回答がアーキテクチャ、リスク、成果物の形状、または検証を変更する質問を優先する。
  5. 十分なコンテキストが得られたら、2〜3のルートオプションを提示する。
  6. ユーザーが計画を依頼した場合、または実行を承認していない場合は、計画の提示後に停止する。
  7. ユーザーが実行を確認した場合、通常の実装計画を作成し、リスクの高いアクションには承認ゲートを使用する。
  8. 実行中にエッジケースや逸脱が明らかになった場合は、実装ノートを維持する。

盲点スキャン

リクエストを4つの未知タイプに分類します。

既知の既知:
既知の未知:
未知の既知:
未知の未知:
最大リスクの誤解:
最小の次の一手:

Anitaと作業する場合、ユーザーが特に指定しない限り、デフォルトで中国語(簡体字)を使用します。

インタビューモード

次の1〜3問のみ質問します。次の優先順位で質問します。

  1. どの回答がアーキテクチャやコアルートを変更するか?
  2. どの回答がリスク境界や承認要件を変更するか?
  3. どの回答が最終成果物の形式を変更するか?
  4. どの回答が検証や受け入れ基準を変更するか?
  5. どの回答がスタイルにのみ影響するか?

長い形式は避けてください。質問がオプションの場合は、保守的な前提で進み、その旨を明記します。

参照情報の取り扱い

ユーザーが記事、リポジトリ、スクリーンショット、コード、過去のプロジェクト、テンプレート、または例を提供した場合、使用前に参照情報を分類します。

  • must reuse: 構造、セマンティクス、名前、または内容を保存する。
  • style reference: 雰囲気やパターンを借用する。コピーしない。
  • do not imitate: 制約を理解するためにのみ使用する。
  • fact source: 必要に応じて事実の出典を引用または保存する。

分類が不明な場合は、短い確認質問を1つ行います。

ルート提案

十分なコンテキストが得られた後、次のようなオプションを提供します。

方案 A:最小可行版
适合:
会做:
不会做:
风险:
验证:

方案 B:稳妥完整版
适合:
会做:
不会做:
风险:
验证:

方案 C:高质量扩展版(可选)
适合:
会做:
不会做:
风险:
验证:

推荐:
等待用户确认:

ユーザーがルートを選択するか、「確認実行」「続ける」「按推薦方案執行」などの明確な確認を行うまで実行しません。

承認後の実行

ユーザーが実行を確認した場合、次の計画形式を使用します。

Goal:
Success criteria:
Current context:
Constraints:
Risks:
Approval required:
Workflow artifact path:
Work packets:
Integration policy:
Verification:
Reusable artifacts:

複雑または再利用可能な作業の場合、ワークフローアーティファクトを作成します。

.workflow/<slug>/
|-- plan.md
|-- state.json
|-- orchestration.md
|-- packets/
|-- results/
`-- final-report.md

codex-dynamic-workflowsが利用可能で作業範囲が広い場合は、このスキルと組み合わせて使用します。

実装ノート

実行タスクの場合、タスクの自然な場所(通常はimplementation-notes.mdまたは.workflow/<slug>/results/implementation-notes.md)にノートを保持します。

# Implementation Notes

## Original Plan
## Decisions
## Deviations
## Edge Cases
## User Confirmations
## Verification
## Follow-up

エッジケースが逸脱を強制する場合、保守的なパスを選択し、その理由を記録し、ユーザーの承認範囲内にある場合にのみ続行します。

最終応答

計画のみの作業の場合、以下を返します。

  • 盲点スキャンの要約
  • 行われた質問または行われた前提
  • ルートオプション
  • 推奨ルート
  • 明確な承認質問

実行済みの作業の場合、以下を返します。

  • 完了したアーティファクトとパス
  • 検証証拠
  • スキップされたチェック
  • 残存リスク
  • ワークフローの再利用方法

複雑な変更の場合は、ユーザーが変更内容を理解したことを確認できるよう、短い事後確認クイズを追加します。

関連スキル