用途:HeyEddi Intake 是上游接入智能体,把模糊的用户语言转成 .heyeddi/product.md、交接产物和技能路由,供下游 HeyEddi 技能使用。它不承担实现者角色,只负责解释、记录、产出交接物、路由和校验。
适用时机:新项目或 .heyeddi/product.md 为空/内容单薄时;用户用自然语言描述应用时;用户附带图片时走 ingest_mockups(截图、草图、竞品参考);无图片时按交接路由默认执行 generate_wireframe;在任何 @heyeddi-design、@heyeddi-handoff 或脚手架工作之前。
主要能力与流程:先读 reference/mockup-strategy.md(强制)。有截图/模型图则 ingest_mockups 并按用户布局定制 mockup-brief.md;无图片但路由需要交接则 generate_wireframe 并 seed_brief --force;无图片但需要精细 PNG 交接则 prepare_mockup_prompts 生成 desktop.png / mobile.png 后 seed_brief --force;无图片且需先做视觉设计则路由到 @heyeddi-design,不输出模板 PNG。强制流水线见 reference/pipeline.md:load_intake → 起草 product-translation.json → write_product --json … --force(校验 schema,写 product.md 并保存 JSON)→ write_translation → 交接功能(generate_wireframe 或 ingest_mockups / AI PNG)→ seed_brief --force → build_routing --write --save-input → verify_intake --check,必须通过才能结束。
输出(.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)、designs/<feature>/desktop.png(ingest_mockups 或提示词后由智能体生成)、designs/<feature>/mockup-brief.md(seed_brief)。
限制与禁止:不要手写 product.md(缺少 personas 会破坏 @heyeddi-design);不要跳过 verify_intake;不要在本技能内实现 Vue/Flutter/FastAPI 功能(脚手架仓库中的基线 src/App.vue 外壳可以);不要为通过校验而删除 src/App.vue 或破坏 npm run build;除非覆盖 build_routing 输出,否则不要用 write_routing;不要从技能脚本打包或绘制千篇一律的 PNG 模型图。技能包不附带示例 PNG,也没有 Pillow/模板 PNG 绘制器;eval hub 工具(uv run poe mockups)仅供维护者使用,不属于本技能。
澄清与后续:读 reference/clarify-before-act.md,若用户提示缺少 personas/竞品,可进行一轮澄清。任务完成后建议下一步技能,运行:python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill heyeddi-intake --project-root .,可用 --route /path 指定路由,已知子命令时加 --mode shape(或 craft、audit 等),并在最终回复中包含脚本的 ### Next step 块。相关参考:reference/audience-intake.md(JSON schema)、reference/downstream-routing.md(路由示例)、reference/mockup-strategy.md、reference/ai-mockup-images.md、reference/mockup-quality.md;@heyeddi 在接入后执行 write_skills_index(集成评估)。