Jeremy-01/intake-first-planner

Intake-First Planner

将此技能用于那些不能从猜测参数出发的项目：物理布局规划器、工作台或家具布置工具、设备放置、线缆布线、日程/资源优化、仿真设置以及类似的约束求解系统。假设用户可能是完全的新手：用通俗语言解释需要哪些信息，提供可填写的 YAML，并避免要求他们理解实现细节。

核心规则

在所需的事实和场景足够明确、不再需要假设之前，不要进行求解、优化、推荐或搭建领域特定逻辑。如果关键数据缺失，则输出“缺失参数”预检响应，并在实现之前停止。

工作流程

1. 对请求进行分类：
   • 仅预检：用户想要需求、模式或提示清理。
   • 预检后构建：用户想要代码、测试、报告或可复用项目。
   • 技能创作：用户想要可复用/开源的技能或提示包。
2. 选择相关参考：
   • 通用可复用工作流程：阅读 references/intake-workflow.md。
   • 空间/布局规划器：阅读 references/spatial-layout-domain.md。
   • Three.js 报告或 3D/视觉输出：阅读 references/threejs-visualization.md。
   • 将一次性提示转换为可复用技能：阅读 references/prompt-to-skill.md。
   • 技能打包/开源转换：阅读 references/skill-packaging.md。
3. 生成或更新结构化的事实源，通常为 YAML 或 JSON。
4. 门控执行：
   • 如果缺少必要事实，仅返回缺失参数检查清单、建议的模式片段、所需场景以及明确的非假设项。
   • 如果事实完整，则使用事实源作为权威输入来实施项目。
5. 对于 Python 项目，优先使用 uv 命令。始终在手顺/恢复文档中包含 venv + pip 的恢复命令。
6. 除非用户明确要求恢复历史，否则不要读取旧的会话 JSONL、聊天日志或先前的对话。

输出模式

对于缺少输入的情况，使用以下格式：

在安全求解之前，我需要几个具体的测量值。您可以通过填写下面的 YAML 来回答；未知的值可以保留为 `null`。

**缺失参数**
- ...

**建议的 YAML**
```yaml
...
```

**待确认的场景**
- ...

**未假设的内容**
- ...

对于实现，创建包含以下内容的项目：

• pyproject.toml, src/, tests/, examples/, reports/, outputs/
• 一个结构化的配置示例作为唯一的事实源
• 当涉及几何或布局时，使用俯视图 SVG/HTML 和 Three.js 3D HTML 查看器生成视觉报告
• 针对解析、变换、约束、评分以及至少一个场景回归测试的确定性测试
• 包含 uv 和 venv + pip 命令的 HANDOFF.md, RECOVERY_README.md 和 PROJECT_CONTEXT.md

可复用资产

• schemas/intake_project.schema.yaml：通用模式模板。
• schemas/spatial_layout.schema.yaml：空间/布局模式模板。
• references/threejs-visualization.md：默认的 3D 可视化指南。
• examples/workstation_layout_request.yaml：领域请求示例。
• examples/furniture_layout_request.yaml：房间/家具规划示例。
• examples/equipment_cable_routing_request.yaml：设备放置和线缆布线示例。
• scripts/check_skill_package.py：轻量级包完整性检查器。