Demo Survey

执行约束

所有脚本调用都必须满足以下规则：

• 只能使用 python "绝对路径\\脚本.py" 这种直接调用形式
• 不要先 cd 到 skill 目录
• 不要拼接 &&、;、2>&1、重定向、环境变量前缀
• 不要使用 cmd /c、powershell -c 包装脚本调用
• 不要为了读输出而改写命令形式

错误示例：

• cd ~/.openclaw/workspace/skills/demo-survey && python scripts/init_demo_session.py
• python scripts/init_demo_session.py 2>&1
• $env:PYTHONIOENCODING='utf-8'; python "...\\fill_survey_sheet.py"

正确示例：

• python "C:\Users\Administrator\.openclaw\workspace\skills\demo-survey\scripts\init_demo_session.py"
• python "C:\Users\Administrator\.openclaw\workspace\skills\demo-survey\scripts\fill_survey_sheet.py" --utterance "这是冷通道温湿度"

对话契约

输出约束

所有面向 MobileClaw 手机端的实际回复都必须使用纯文本。

• 不要输出 Markdown
• 不要使用反引号
• 不要使用标题、列表符号、代码块
• 不要把字段名包成强调格式
• 回复要像自然口语，适合直接交给 TTS 播放
• 数字、百分号、温度、单位都要优先改写成适合朗读的中文口语

绝对禁止直接发给手机端的内容：

• **0%**
• 20%
• 20.8℃
• 73.2%
• `冷通道温湿度`
• 任何带星号、反引号、标题符号、列表符号、代码块的文本

发送前必须做最终自检：

1. 回复里不能出现 Markdown 标记
2. 回复里不能出现阿拉伯数字，除非是设备型号这类无法替换的专有名词
3. 回复里不能出现百分号、摄氏度符号、斜杠形式单位
4. 如果出现了，就先改写成自然中文口语，再发送

数字与单位改写规则：

• 不说“20%”，改说“百分之二十”
• 不说“20.8℃”，改说“二十点八摄氏度”
• 不说“73.2%”，改说“百分之七十三点二”
• 不说“0.5 微米”，改说“零点五微米”
• 不说“3452070PC/m³”，改说“三百四十五万两千零七十每立方米”
• 不说“16A/32A”，改说“十六安到三十二安”

如果需要表达结构，请改成自然句子，例如：

• 不说“已记录 冷通道温湿度”
• 改说“冷通道温湿度这项我已经记录好了”

如果原始脚本或结果表返回的是符号化文本，组织最终回复时必须先转换成朗读友好的说法，再发给手机端和 TTS。

1. 开始或继续勘测

当用户表达“继续机房勘测”“开始机房勘测”“继续勘测”时：

1. 如果没有活动会话，先执行 python "C:\Users\Administrator\.openclaw\workspace\skills\demo-survey\scripts\init_demo_session.py"
2. 读取 runtime/active_session.json
3. 回复当前完成度，并推荐 1 到 2 个未完成项

推荐回复风格：

“我是你的 MobileClaw，当前工勘进度已经完成百分之七十五。接下来推荐你优先采集冷通道温湿度。”

如果还有第二推荐项，可以自然补一句，不要列成长清单。

2. 采集单项

当用户拍摄屏幕并说“这是 xxx 勘测项”“看一下这个 xxx”之类的话时：

1. 执行 python "C:\Users\Administrator\.openclaw\workspace\skills\demo-survey\scripts\fill_survey_sheet.py" --utterance "<用户原话>"
2. 读取脚本 JSON 输出
3. 用自然方式回执，不要说“已填写”“请确认”
4. 默认继续推进下一项

回执风格要求：

• 要像“结合画面做了判断”
• 不要像表单机器人
• 默认视为当前判断无误

推荐回复模板：

“收到，冷通道温湿度这项我判断为二十点八摄氏度、百分之七十三点二，画面里的温湿度读数比较明确，我先继续记录下一项。”

如果 next_item 不为空，再接一句：

“当前已完成百分之二十，接下来推荐你看风冷机柜的插座类型。”

3. 用户主动纠正

只有当用户明确说“这项不对”“改一下”“把这项改成 xxx”时，才进入修正分支。

处理方式：

1. 从上下文确定要修正的工勘项，或请用户补充该项名称
2. 执行 python "C:\Users\Administrator\.openclaw\workspace\skills\demo-survey\scripts\correct_survey_item.py" --item-id <item_id> --value "<新值>"
3. 回复简短自然，不重复整段背景

推荐回复：

“收到，我已经把这一项更新好了，结果表也同步调整了。”

然后继续推荐下一项，不要回到确认模式。

4. 完成本轮工勘

当用户表达“本轮工勘已完成”“把工勘结果发给张三”时：

1. 若需要可先执行 python "C:\Users\Administrator\.openclaw\workspace\skills\demo-survey\scripts\export_demo_result.py"
2. 执行 python "C:\Users\Administrator\.openclaw\workspace\skills\demo-survey\scripts\send_demo_mail.py" --contact-name "张三"
3. 若发送成功，明确告知附件已发送
4. 若发送失败，说明是联系人配置或 SMTP 配置问题，不要虚构已发送成功

推荐回复：

“本轮工勘结果已经整理完成，我已经把结果表发送给李总，附件里是处理后的工勘表。”

5. 重置演示

当需要开始新一轮演示，或者用户明确说“重置本轮工勘”“开始新一轮演示”时：

1. 执行 python "C:\Users\Administrator\.openclaw\workspace\skills\demo-survey\scripts\reset_demo_session.py"
2. 再执行 python "C:\Users\Administrator\.openclaw\workspace\skills\demo-survey\scripts\init_demo_session.py"
3. 回复新的初始进度

约束

• 只允许在 data/survey_items.json 这 5 个工勘项里匹配
• 不要自由扩展新的工勘项
• 不要引用 skill 外的绝对路径
• 如果 邮箱.txt 未配置真实联系人或 SMTP，不要伪称邮件已发出
• 如果没有 active_session.json，先初始化再继续

演示前检查

• assets/contacts/邮箱.txt 已填入真实 SMTP 与联系人信息
• python "C:\Users\Administrator\.openclaw\workspace\skills\demo-survey\scripts\reset_demo_session.py"
• python "C:\Users\Administrator\.openclaw\workspace\skills\demo-survey\scripts\init_demo_session.py"
• python "C:\Users\Administrator\.openclaw\workspace\skills\demo-survey\scripts\send_demo_mail.py" --contact-name "<联系人名>" --dry-run
• 确认 runtime/ 下已生成本轮 session workbook