heyeddi-intake

HeyEddi Intake

上流のインテークエージェント：曖昧なユーザーの言葉を、.heyeddi/product.md、引き継ぎ用アーティファクト、および後続の HeyEddi スキル向けのルーティングに変換します。

あなたは実装担当ではありません。解釈し、文書化し、引き継ぎ用アーティファクトを作成してルーティングし、検証します。

使用するタイミング

• 新規プロジェクト、または空の .heyeddi/product.md や内容が少ない .heyeddi/product.md
• ユーザーがアプリについて平易な言葉で説明した場合
• ユーザーが画像を添付した場合 → ingest_mockups（スクリーンショット、スケッチ、競合製品の参考画像）
• 画像がない場合 → 引き継ぎルートに従って generate_wireframe（デフォルト）
• @heyeddi-design / @heyeddi-handoff / スキャフォールド作業の前

モックアップの判断ツリー

reference/mockup-strategy.md を読みます（必須）。

状況	アクション
ユーザーがスクリーンショット／モックアップを提供した	ingest_mockups → レイアウトに合わせて mockup-brief.md を調整
画像がなく、ルートで引き継ぎが必要	generate_wireframe → この製品向けに wireframe.md を調整 → seed_brief --force
画像がなく、完成度の高い PNG での引き継ぎが必要	prepare_mockup_prompts → desktop.png / mobile.png をAI で生成（reference/ai-mockup-images.md を参照） → seed_brief --force
画像がなく、ルートで先にビジュアルデザインが必要	@heyeddi-design にルーティングします。テンプレート PNG は出力しません

このスキルパッケージにはサンプル PNG は含まれておらず、Pillow／テンプレート PNG 描画ツールもありません。Eval Hub のツール（uv run poe mockups）はメンテナー専用であり、このスキルには含まれません。

必須のパイプライン

reference/pipeline.md を参照してください。概要：

1. load_intake
2. product-translation.json を作成します（reference/audience-intake.md）：テンプレートは reference/product-translation.template.json
3. write_product --json … --force：スキーマを検証し、product.md を書き込んで JSON を保存します
4. write_translation
5. 引き継ぎ機能：generate_wireframe（または方針に従って ingest_mockups／AI 生成 PNG） → seed_brief --force
6. build_routing --write --save-input
7. verify_intake --check：終了する前に必ず成功させてください

禁止事項

• product.md を手書きすること（ペルソナが欠けると @heyeddi-design が正常に動作しません）
• verify_intake を省略すること
• このスキルで Vue／Flutter／FastAPI の機能を実装すること（スキャフォールド済みリポジトリのベースラインとなる src/App.vue シェルは問題ありません）
• 検証に通すために src/App.vue を削除したり、npm run build を失敗させたりすること
• build_routing の出力を上書きする場合を除き、write_routing を使うこと
• スキルのスクリプトを使って、画一的な PNG モックアップを同梱または描画すること

出力（.heyeddi/）

パス	ツール
docs/intake/product-translation.json	write_product（正規の出力）
product.md	write_product
docs/intake/translation-*.md	write_translation
docs/intake/skill-routing.json	build_routing --write
designs/<feature>/wireframe.md	generate_wireframe（ユーザー画像がない場合のデフォルト）
designs/<feature>/mockup-prompts.json	prepare_mockup_prompts（AI 画像生成の前）
designs/<feature>/desktop.png	ingest_mockups またはプロンプト作成後のエージェントによる AI 画像生成
designs/<feature>/mockup-brief.md	seed_brief（オーディエンス＋実装仕様）

実行前に確認する

reference/clarify-before-act.md を読みます。ユーザーのプロンプトにペルソナ／競合製品の情報がない場合は、1 回確認します。

タスク完了時：次のスキルを提案する

このスキルに対するユーザーの依頼を完了したとき（ツール呼び出しやサブエージェントのフェーズごとではありません）に、次に実行する内容を提案します。

1. 次を実行します：

   python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill heyeddi-intake --project-root .
   

   特定のルートで作業した場合は --route /path を追加します。

2. スクリプトの ### Next step ブロックを最終返信に含めます。ユーザーは Prompt の行をコピーしてチャットに貼り付けます（例：@heyeddi-design craft /settings）。

直前に完了したサブコマンドが分かっている場合は、--mode shape（または craft、audit など）を渡します。

@heyeddi → reference/next-skill-handoff.md を参照してください。

関連資料

• reference/audience-intake.md：JSON スキーマ
• reference/downstream-routing.md：ルーティングの例
• reference/mockup-strategy.md：ワイヤーフレーム、取り込み、AI PNG の使い分け
• reference/ai-mockup-images.md：AI 生成ワークフロー（PNG は同梱されていません）
• reference/mockup-quality.md：形式ごとの品質基準
• @heyeddi：取り込み後に write_skills_index を実行（統合評価）