Daily Guidance

Daily Guidance 让 agent 先形成一天的完整 Story，再按 Story 指导每个仿真步的行为。 所有结构化操作都通过 scripts/daily_guidance.py 的 CLI 命令完成——你提交 JSON 内容， 脚本负责校验、序列化 YAML、以及从仿真时钟推导执行状态。

每天一个文件：state/daily_guidance/YYYY-MM-DD/story.yaml（由脚本生成和维护）。

核心原则

1. 用 plan --json 提交一天的安排。 提交 JSON 对象，脚本校验后写入 story.yaml。
2. 执行状态由时钟推导。 completed_segments / current_segment_id 是 (segments, 当前仿真时间) 的函数，由脚本在读取时计算。时间到了自然完成。
3. pre_step hook 每步输出当前 segment。 每个 step 开始，hook 会注入 active_segment （含 activity 和 location_policy）。按此移动和回答问卷。

每步流程

每个 step 开始，pre_step hook 自动输出当前状态。两种情况：

情况 A：还没有有效 Story（ok: false）

hook 输出会包含 next 指引。立即提交一天的 Story：

python scripts/daily_guidance.py plan --date YYYY-MM-DD --json '<JSON对象>'

情况 B：已有有效 Story（ok: true）

hook 输出包含 active_segment 和 guidance，例如：

active_segment:
  id: sleep_night
  activity: sleep
  location_policy: home_aoi
  start: "00:00"
  end: "07:00"
guidance: Your intended activity now is 'sleep' at location policy 'home_aoi'. ...

直接按 active_segment.activity 和 location_policy 行动并回答问卷。回答意图问卷时，以 active_segment.activity 为当前意图。

CLI 命令

所有命令通过 execute_skill_script 调用，统一返回 {ok, ...} YAML 结果块。

plan 的 JSON 格式

--json 接收一个对象，包含 story_id、date、segments 三个字段。self_check 可选。

{
  "story_id": "agent_0007:2018-06-13",
  "date": "2018-06-13",
  "segments": [
    {
      "id": "sleep_night",
      "start": "00:00",
      "end": "07:00",
      "activity": "sleep",
      "location_policy": "home_aoi",
      "maslow_reason": {
        "need": "physiological.rest",
        "reason": "night sleep keeps the day physically plausible",
        "risk": "starting the day without rest",
        "required": "required"
      },
      "tpb_reason": {
        "want": {"reason": "sleep supports recovery", "status": "supported"},
        "norm": {"reason": "sleeping at night is normal", "status": "supported"},
        "can": {"reason": "the agent is at home", "status": "supported"},
        "proof": "night time at home supports sleeping",
        "choice": "commit"
      }
    }
  ]
}

生成规则

• 先读 AGENT.json，确认当前时间、职业、家庭/工作地点、角色义务。
• 如果 profile 表示有工作/学习义务，必须安排合理的 work/study segment，除非 tpb_reason.can.status 给出执行条件不足。
• 必须覆盖：睡眠/休息、进食、主要角色义务、安全返回或夜间栖身。
• 工作日应包含通勤、用餐、傍晚回家、休闲等真实节律，各 segment 均匀分布在全天。
• 每个 segment 必须有 id/start/end/activity/location_policy/maslow_reason/tpb_reason。
• start/end 用 HH:MM，按顺序连续衔接（前一段的 end 等于后一段的 start）；末尾可用 24:00。时间必须覆盖一整天 00:00–24:00。

location_policy 取值

Maslow Reason

用马斯洛需求层次解释一天安排是否合理。maslow_reason.need 是字符串，可用常见值或按场景扩展。

maslow_reason.required 使用 required、soft_required 或 optional。

TPB Reason

计划行为理论（TPB）认为行为意图由三类因素形成：

• want：为什么想做或接受该行为。
• norm：为什么符合角色、社会规范或他人期待。
• can：为什么现在有时间、地点、交通、资源等执行条件。

每个字段含 reason（短句）和 status（supported/weak/missing/contradicted）。 proof 写一个短句说明依据。choice 用 commit/revise/delay/skip/observe。 当 can.status: contradicted 时，choice 不能用 commit。

偏差处理

现实与计划不符时，用 CLI 命令记录：

• record --activity ... --location ...：记录本步实际活动到 actual_timeline。
• deviate --type record_only --reason ...：轻微偏离，只追加 change_log。
• deviate --type local_patch --reason ...：需要调整当前或相邻 segment（随后用 revise）。
• revise --from SEG_ID --json '<新尾段>'：重写当天剩余 segments。
• deviate --type carryover --reason ...：当天无法补偿，留给第二天参考。