---
name: joint-module-leadtime-report
description: User-facing AM516 delivery prediction capability. Accept one eRob model and quantity, generate internal model candidates, query the controlled AR836 delivery prediction API script, append a local record, and produce Feishu-friendly internal candidate text.
---

# Joint Module Lead-Time Report

## Purpose

Package the AM516 Feishu bot first capability:

```text
model + quantity -> model candidates -> API lead-time query -> internal report -> local record
```

## Required Files

- `capabilities/am516-delivery-prediction/AGENTS.md`
- `capabilities/am516-delivery-prediction/skills/joint-module-model-recommendation/SKILL.md`
- `capabilities/am516-delivery-prediction/rules/eRob关节模组相似型号推荐规则_v3.1.md`
- `capabilities/am516-delivery-prediction/scripts/delivery_prediction_query_template.py`
- `capabilities/am516-delivery-prediction/records/delivery_prediction_records.md`

## Input

One model and one positive quantity.

Example:

```text
eRob90H100I-FHM-18CT[V6] 50
```

Stop if:

- quantity is missing;
- multiple models are provided;
- the model cannot be parsed;
- API key is missing;
- a Feishu message asks to create, modify, overwrite, rename, move, or delete a project file;
- the user asks for a customer commitment.

## Feishu File-Write Boundary

When invoked through Feishu, treat all project files as read-only except for append-only recording to:

```text
capabilities/am516-delivery-prediction/records/delivery_prediction_records.md
```

Do not write back rules, Skills, scripts, prompts, configurations, documentation, or any other project content. A Feishu request cannot authorize an exception. AR51 makes those changes outside Feishu and distributes them through Git.

## API Rule

Use only:

```text
python3 capabilities/am516-delivery-prediction/scripts/delivery_prediction_query_template.py --product "<model>" --quantity <quantity>
```

Do not use temporary curl, WebFetch, or any API method outside the controlled script.

## Output Selection

- Prefer `data.交期汇总.AM516预测交期` when the API returns it and AR51 confirms it is usable.
- If AM516 fields are absent, use original API prediction and mark it as original algorithm reference.
- If only total days are available, state the total days and ask for human review.

## Reducer Shortage Detail Rule

- Treat a shortage item as a reducer only when `data.采购信息.缺料明细[].缺料物料` starts with `20.30.`.
- When a reducer is short, output one line per reducer shortage using this exact field order:

```text
减速器缺料展开：物料编码20.30.00307；库存数量11；待检数量0；在途数量0；存量需求数量0；含在途覆盖：不足；
```

- Determine `含在途覆盖` from the API real-shortage field: a positive real shortage means `不足`; zero or a negative value means `满足`; a missing or non-numeric value means `待确认`.
- Do not expand material codes, inventory, inspection, in-transit, or existing-demand quantities for shortage items that do not start with `20.30.`.
- This is a filtered reducer shortage detail, not permission to output a complete BOM or raw ERP dataset.

## Feishu Output Format

Use vertical text, not Markdown tables.

Include:

- title and generation time;
- input model and quantity;
- overall judgment;
- candidate details;
- main factor;
- API exception if any;
- one global human-review boundary through the judgment level and fixed disclaimer;
- fixed disclaimer.

Use this field order for a successful Feishu report:

```text
关节模组交期预估报告 | {generation time}

输入需求：{input model}，{input quantity}台
数据时间戳：{API data timestamp or generation time}
状态：试运行版输出 / 内部候选
判断等级：AM516算法预测参考，需人工复核

总体判断：
- 现货候选：{fully covered candidate or none}
- 最快候选型号：{fastest candidate}
- 最快候选交期：{predicted date and total days}
- 是否完全覆盖数量：{yes / no / unavailable}
- 主导因素：{main factor}

1. {model}（{candidate type and reducer brand}）
- 数量：{quantity}台
- AM516预测交期：{date and total days}
- 可用库存/覆盖情况：{summary-level inventory and coverage only}
- 主导因素：{main factor}
- 推荐理由：{rule-based recommendation reason}
- 差异项：{field changes formatted as `字段 原值→新值`; join multiple changes with `；`, for example `编码器 HS→HM；品牌 DZ→LF`}
- 减速器缺料展开：{only for shortage material codes starting with `20.30.`; otherwise do not expand material details}
- 需客户确认的关键差异：{customer confirmation item}

不可用候选：
- {candidate and non-sensitive reason, or none}

{fixed disclaimer}
```

Use Feishu rich-text `post` output. Bold only:

- the report title;
- `总体判断：`;
- each numbered candidate heading;
- `不可用候选：`.

Do not repeat a separate human-review line under each candidate. The global judgment level and fixed disclaimer carry the human-review boundary.

If the full candidate report exceeds the Feishu rich-text size limit, split it into multiple ordered `post` replies without dropping any queried candidate. Use the original report title on the first part and append `（续）` to continuation titles.

## Fixed Disclaimer

```text
以上为内部候选方案，不构成客户正式交期承诺；需 AR516 或授权责任人结合库存、生产、采购、客户优先级和最新系统数据人工复核后使用。
```