heyeddi-intake

HeyEddi 信息采集

上游信息采集 Agent：将模糊的用户描述转化为 .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 → 针对该产品完善 wireframe.md → seed_brief --force
没有图片，需要精细的 PNG 交接产物	prepare_mockup_prompts → 使用 AI 生成 desktop.png / mobile.png（参见 reference/ai-mockup-images.md）→ seed_brief --force
没有图片，路由需要先进行视觉设计	路由至 @heyeddi-design：不要输出模板 PNG

技能包不附带示例 PNG，也没有 Pillow／模板 PNG 绘制工具。评估中心工具（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 或生成提示词后由 Agent 使用 AI 生成图片
designs/<feature>/mockup-brief.md	seed_brief（用户画像 + 实现规范）

行动前先澄清

阅读 reference/clarify-before-act.md。如果用户提示中缺少用户画像／竞品信息，进行一轮澄清。

任务完成后：建议后续技能

完成此技能的用户请求后（不是每次调用工具或子 Agent 阶段后），建议接下来运行的命令：

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（集成评估）