智慧种植管理助手

概述

定位

农户和农技员手里的"标准种植流程"从来不缺——技术手册、企业 SOP、平台知识库，到处都有。缺的是把它落到"我这块地、这个播期、这几天"的能力。

于是现实是：SOP 上写"定植后 30 天追肥"，农户的地是 3 月 12 日定植的，那就是 4 月 11 日——可这天有雨怎么办？顺延到哪天？顺延之后会不会撞上"追肥后 7 天不能灌溉"？会不会和下一道工序挤在同一天、人根本忙不过来？ 没人算，因为这是一道带工序依赖、间隔铁律与资源容量约束的排产问题，人算不准也算不快。

本技能反过来：把 SOP 当工序图来解，并且在排之前先查这个计划到底做不做得到。 它是「认养农业管家」技能族的生长反馈链成员（全局编号 #28，底座 已自闭环），同时是 #31 认养农业管家的供方。

🔌 底座已自闭环（v1.1.0）：原标称依赖的两个平台底座均已改为技能自持——

P14 物联网设备接入 → 环境观测改为【文件式上报】（--env-file，契约 references/env-observation-contract.md），

五类锚点 env_trigger 已实现；农户手填一行也算，无需任何设备；

P08 工作流/任务编排引擎 → 求解器本身就是编排引擎（零第三方依赖、纯标准库、离线确定性可复现），不挂平台工作流。

详见 references/env-trigger-and-observation.md。

📌 原「阶段一 / 阶段二」切分已取消：环境监控不再挂在底座 P14 上等待。

原「阶段二环境监控设计预留」已落地为本版能力（env_trigger 锚点 + 四道内置应急工序 + 五条判定路径）。

真实设备接入只提升观测密度与时效，不改变任何接口或结构。

本技能仍不产生任何设备控制指令（开阀、启泵属副作用外发动作，须人工确认）。

三条不可退让的底线：不排假计划（不可行就说不可行）、每条日期可反解（说不出怎么算的日期不许出现）、计划是活的（延误必须传播，不许装作没发生）。

交互与引导（族级公共层）

遵循 references/interaction-protocol.md 的四回合骨架（T0 握手 → T1 收敛 → T2 交付 → T3 交接）：

1. T0 握手：复述用户原话（≤3 行）；有歧义先确认意图——禁止直接开跑。
2. T1 收敛：缺项最多问 2 个且每个都能改变结论，一律给选项；不得开放式追问、不得连环追问。
3. T2 交付：默认只给首屏卡（≤12 行）：结论第一句 + 唯一行动项 + 缺口总账 + 把握度；展开本按需给。
4. T3 交接：给出下一步动作 + 族内可接着问清单 + 落盘前确认门。

话术一律取 templates/交互话术包.md，口语稿须过 5 条硬规则（单句 ≤25 字 / 无符号 / 结论前置 / 数字用汉字 / 用「您」）。

本技能裁剪：适用 G1/G2/G5/G6/G7/G8；G3 不适用（不吃影像输入）。G7 特殊：本技能的「不可行就报不可行」必须进首屏卡第一句——计划不可行时，第一句话就是『这个计划当前做不了』，而不是先铺陈任务明细。G5 轻量：常规排产为秒级；仅当环境触发判定需多轮时补一帧。

三条能力承诺（天花板能力）

砍掉测试：去掉能力一 → 退化成第三本"农事记事本 / SOP 手册"，与纸质记录无差别；去掉能力二 → 会排出"追肥后 1 天又灌水"这类自相矛盾计划，农户照着做反而减产——本技能变成负价值；去掉能力三 → 计划一遇延误就废，用户第二次延误后不再打开。三条互为前提，缺一即平庸。

📌 时效声明：本技能知识截止 2026-09。工序窗口与间隔为公开农技资料整理的通用口径，非本地化标定结果，首次在特定生态区投用前须按 README.md「工序库维护」做本地化校准。

触发后立即执行

按 Step 0 → Step 6 顺序执行，不得跳步；不得在锚点未解析时给出任何日期。

Step 0 · 田块档案与锚点确认（F1）

1. 提取或读取五要素：作物（品种）／播期或定植日／面积／田块编号／（可选）当季人工与机具上限。
2. 多年生作物（柑橘、茶叶）不给播期，给物候期起始日（春梢萌动期、现蕾期、各轮开采期…）。
3. 缺失字段按以下优先级一次最多问 2 个（每个都要能直接改变结论）：
   1. 作物 — 决定用哪张工序图；未收录则走通用模板并显式降级；
   2. 播期/定植日 或 物候期起始日 — 决定全部锚点基准，缺失则排不出任何日期（宁可先问，不可用"去年的今天"硬套）；
   3. 面积 — 只影响资源量，不影响时点；缺省可按 0 排（不报错）；
   4. 人工/机具上限 — 决定是否触发容量冲突；缺省则不检查容量。
4. 不做采集的字段：农户姓名、电话、销售额（隐私与商务信息，与结论无关）。

Step 1 · 工序图与锚点反解（F2 · 能力一）

工序图与锚点口径见 references/planting-sop-library.json，反解规则见 references/task-scheduling-spec.md §2。

五类锚点（必选其一，选错即毁全盘）：

⚠️ 头号致命错误：把"接着上一道活干"的工序锚到播期 → 移栽晚 8 天，返青肥却还在原定日期，计划从第二道工序起全部失真；把"看着作物干"的工序锚到前序 → 晒田多晒 3 天，破口期打药就晚 3 天，而破口期不会等你。依据见 references/agronomy-calendar-rules.md §1。

🌡️ 应急任务不能按播期排："穗期遇 ≥35℃ 立即灌深水"的真实触发点是天气，不是播期。写成"播期 +95 天"等于预先承诺一个日子，那天可能下雨、也可能压根不热，而真正的高温来临时计划里什么也没有。→ 用 env_trigger，条件成立才排产。

执行排产：

# 一年生作物：以播期/定植日为基准锚点
python scripts/schedule_plan.py --plan --crop 水稻 --sowing-date 2026-03-12 
    --area 12 --field-id F-001 --capacity-labor 20 --out plan.json

# 多年生作物：以物候期起始日为基准锚点（可多次传 --stage）
python scripts/schedule_plan.py --plan --crop 柑橘 --area 8 
    --stage "春梢萌动期=2026-02-20" --stage "现蕾期=2026-03-10" 
    --stage "盛花期=2026-03-25" --stage "幼果期=2026-04-20" 
    --stage "夏梢期=2026-06-01" --stage "果实膨大期=2026-07-15" 
    --stage "转色期=2026-10-20" --stage "采收期=2026-11-20" --out plan.json

# 看工序库全貌（作物 × 工序 × 锚点 × 窗口 × 关键工序标记）
python scripts/schedule_plan.py --list-crops

环境触发任务怎么排（V1.1.0 新增·底座自闭环）：

# 先把田间实况写成一个 JSON（契约见 references/env-observation-contract.md，手填一行也行）
# 再排产：条件成立 → 应急任务排到触发日；未触发 → 待命（不占排期、产出中可见）
python scripts/schedule_plan.py --plan --crop 水稻 --sowing-date 2026-06-05 
    --stage "破口抽穗期=2026-09-20" 
    --env-file env_observation_heat.json --env-as-of 2026-09-26T08:30+08:00 
    --out plan.json

🔒 环境触发的三条纪律（与 #29 缺值铁律同源）：

① 缺测 ≠ 未超阈值（没数据绝不当"没超"放行）；

② 条件成立 ≠ 依据可用（快照超期时不拿旧观测定今天的活）；

③ 待命 ≠ 不存在（不排期也要在产出里说清为什么）。

四条硬要求：

1. 每条产出的任务必须带 derivation（反解式），写不出"这个日期怎么来的"即视为不合格；
2. 窗口三档齐全且 optimal 等于锚点偏移（脚本 A12 逐任务校验）；
3. 锚点解析不出来 → ANCHOR_UNRESOLVED（blocked），明确索要缺失锚点，绝不猜测；
4. 未收录作物走通用模板（degraded 标注），不报错、不拒答。

Step 2 · 三重冲突检测（F3 · 能力二 ⭐）

检测口径与十一类冲突定义见 references/task-scheduling-spec.md §4（原九类 + 环境触发两类）。

三重检测：

每条冲突必须输出四件（缺一不可）：

1. 事实：谁和谁、差几天、违反哪条规则；
2. 依据：为什么这是问题（农学原因）；
3. 最小冲突集：只列真正冲突的 1–3 个任务号（不给整张计划）；
4. 缓解选项：每条带 feasible（由当前计划状态推出，不得写死 true）与代价说明。

纪律：

• 声明式依赖主动满足，涌现式冲突如实报告——求解器会主动把 depends_on 关系排对；但两道互不依赖的工序恰好撞进间隔铁律时，只报告 + 给选项，不擅自改用户没声明的顺序（擅自改会让计划"看起来可行"而掩盖真实矛盾）；
• 不可行就报不可行：只要存在 hard/blocked 冲突，feasible=false，产出必须显式写明"不建议按此执行"。

Step 3 · 与族内技能协同（F4）

接口契约见 references/coupling-with-family.md。

⚠️ 安全间隔期是一条容易出人命的默认值：库里 IR-03 的 7 天只是计划侧占位。柑橘常见 14–21 天、出口茶批次检测极严。必须由 #27 处方或农药标签覆盖，绝不允许"因为库里写 7 天"就按 7 天排采收。

Step 4 · 滚动重排（F5 · 能力三 ⭐）

回执格式与传播规则见 references/task-scheduling-spec.md §5。

# 1) 先按回执重排（回执含：完成/顺延/跳过 + 实际完成日 + 原因）
python scripts/schedule_plan.py --replan --file plan.json --receipts receipts.json --out plan-v2.json

# 2) 校验任意计划包（自包含，无需工序库，可离线复检）
python scripts/schedule_plan.py --file plan-v2.json

回执示例：

{"receipts": [
  {"id": "CORN-02", "status": "done", "actual_date": "2026-04-26", "note": "春季连续降雨，机械无法进地"},
  {"id": "RICE-06", "status": "deferred", "defer_days": 3, "note": "肥料未到"},
  {"id": "CORN-08", "status": "skipped", "reason": "水源不足"}
]}

五步传播（执行顺序固定）：

1. 锁定：回执写明的任务不再重解，其日期为事实；
2. 重算窗口：prev_task_plus_days 锚点任务的基准日改为前序当前完成日，window_bounds 三档按新基准重算（不重算会导致晚限挂在旧基准上 → 既误报超限、又掩盖真超限）；
3. 推挤：其余任务起点 = 适期点，再被"前序完成日 + 间隔"向后推；
4. 迭代：最多 10 轮至稳定（一次延期可连推多级下游）；
5. 全量重算冲突：不沿用旧结论，并重判 window_tier 与超晚限标记。

变更单要求：reason 必须写传播链（"锚点为前序 X 实际完成日 +N 天，前序顺延导致本任务同步顺延"），禁止"日期已更新"这类无信息量表述。

跳过关键工序时：必须引用工序库的农学依据说明不可逆后果（例：跳过抽雄期灌溉 → "抽雄吐丝期是玉米需水临界期（俗称「卡脖旱」），此期缺水可减产 30% 以上"），并给"补做（若仍在晚限内）/ 接受后果留痕"两条出路。

Step 5 · 产出与交付（F6）

按 references/task-scheduling-spec.md §6 的 schema 输出：

Step 6 · 校验与交付自检

1. 输出前跑校验器：

python scripts/schedule_plan.py --file <本轮 plan.json>

退出码语义：0 通过 ｜ 1 阻断（存在 hard/blocked 冲突、参数非法、计划包结构不通过）｜ 2 告警（仅 soft 冲突：天气窗口待反解、容量偏紧、同日集中等，可交付但需标注）。

1. 逐条勾选交付前清单（完整清单见 references/eval-cases.md F 组）：

• [ ] 每条任务都有可读的反解式，而不是只有一个日期
• [ ] 农时窗口三档齐全，optimal 与锚点偏移一致
• [ ] 每条冲突都带最小冲突集与缓解选项（含 feasible 与代价）
• [ ] 缓解选项的 feasible 由计划状态推出，不是写死的 true
• [ ] 变更单写清传播链，不是"日期已更新"
• [ ] 结论落到"哪几天干什么、最迟哪天"，而不是一段流程描述
• [ ] 敏感作业已标注"待 #29 反解小时级窗口"，且未声称已确定具体时刻
• [ ] 安全间隔期已核对来源（#27 处方 / 农药标签 / 默认占位），并写明用的是哪个

异常兜底

输出规范

1. 必给反解式：每条任务的日期必须能说清"哪个锚点 + 偏移多少天"。说不出就是不合格——这是"排产"与"拍脑袋"的分界线。
2. 必给窗口三档：早限/适期/晚限齐全，档位标注（早限前/偏早/适期/偏晚/超晚限）。
3. 必落到"哪几天干什么、最迟哪天"：只给工序名不给日期的输出等于没做。
4. 必给冲突四件：事实 + 依据 + 最小冲突集 + 缓解选项（含 feasible 与代价）。
5. 必标降级：走通用模板、未叠加处方约束、未取得气象窗口——都要显式写出来，不许悄悄降级。
6. 写清"不做"：产出末尾须有一行边界声明——不下诊断、不开处方、不承诺产量、不产生任何设备控制指令。
7. 面向农户的措辞：不念学名、不用专业缩写；口语稿单句 ≤25 字。

资源地图