Reagent Expiry Alert
Scan reagent bottle barcodes or IDs, log expiration dates, and alert before expiry to support safe laboratory inventory management.
Quick Check
CODEBLOCK0
When to Use
- - Use this skill when logging a new reagent with its expiry date into the inventory.
- Use this skill when checking for reagents approaching expiration (30/60/90-day alerts).
- Do not use this skill to manage controlled substances, biological hazards requiring special disposal, or reagents subject to regulatory chain-of-custody requirements.
Workflow
- 1. Confirm the reagent barcode/ID, expiry date, and action (scan/log or check alerts).
- Validate that the request is for reagent expiry tracking, not chemical safety assessment or disposal guidance.
- Date validation: If
--expiry is provided, validate that it is a valid YYYY-MM-DD date. If the date is in the past, emit a warning: "This reagent is already expired as of [date]. It will be logged with an Expired alert status." - Log the reagent or run the alert check using the packaged script.
- Return expiration status, alert level, and reorder recommendations.
- If inputs are incomplete, state which fields are missing and request only the minimum additional information.
Usage
CODEBLOCK1
Parameters
| Parameter | Type | Required | Default | Description |
|---|
| INLINECODE1 | string | No | — | Reagent barcode or ID |
| INLINECODE2 |
string | No | — | Reagent name |
|
--expiry | date | No | — | Expiration date (YYYY-MM-DD) |
|
--location | string | No | — | Storage location |
|
--quantity | string | No | — | Quantity on hand |
|
--check-alerts | flag | No | — | Check for upcoming expirations |
|
--alert-days | integer | No | 30 | Days before expiry to alert |
Alert Levels
- - 🔴 Expired — reagent past expiry date
- 🟠 Critical — expiring within 30 days
- 🟡 Warning — expiring within 60 days
- 🟢 OK — expiring beyond 60 days
Output
- - Expiration alert report with alert level per reagent
- Inventory summary
- Reorder recommendations for critical/expired items
Stress-Case Rules
For complex multi-constraint requests, always include these explicit blocks:
- 1. Assumptions
- Reagents Checked
- Alert Report
- Reorder Recommendations
- Risks and Manual Checks
Error Handling
- - If required inputs are missing, state exactly which fields are missing and request only the minimum additional information.
- If the task goes outside the documented scope, stop instead of guessing or silently widening the assignment.
- If
scripts/main.py fails, report the failure point, summarize what still can be completed safely, and provide a manual fallback. - Do not fabricate expiry dates, inventory counts, or reorder thresholds.
Input Validation
This skill accepts: reagent barcode/ID and expiry date for logging, or a check-alerts request for inventory review.
If the request does not involve reagent expiry tracking — for example, asking for chemical hazard assessment, waste disposal guidance, or controlled substance management — do not proceed with the workflow. Instead respond:
"reagent-expiry-alert is designed to log reagent expiry dates and generate alerts before expiration. Your request appears to be outside this scope. Please provide a reagent ID and expiry date, or use a more appropriate tool."
Response Template
Use the following fixed structure for non-trivial requests:
- 1. Objective
- Inputs Received
- Assumptions
- Workflow
- Deliverable
- Risks and Limits
- Next Checks
If the request is simple, you may compress the structure, but still keep assumptions and limits explicit when they affect correctness.
试剂有效期提醒
扫描试剂瓶条形码或ID,记录过期日期,并在过期前发出提醒,以支持安全的实验室库存管理。
快速检查
bash
python -m py_compile scripts/main.py
python scripts/main.py --help
使用场景
- - 当将带有有效期的试剂录入库存时使用此技能。
- 当检查即将过期的试剂时使用此技能(30/60/90天提醒)。
- 请勿使用此技能管理受控物质、需要特殊处置的生物危害品或受监管链要求约束的试剂。
工作流程
- 1. 确认试剂条形码/ID、有效期及操作(扫描/录入或检查提醒)。
- 验证请求是否属于试剂有效期追踪范畴,而非化学品安全评估或处置指导。
- 日期验证: 如果提供了--expiry参数,验证其是否为有效的YYYY-MM-DD格式日期。如果日期已过期,发出警告:该试剂自[日期]起已过期。将以过期提醒状态进行记录。
- 使用打包脚本录入试剂或运行提醒检查。
- 返回过期状态、提醒级别及补货建议。
- 如果输入不完整,说明缺失哪些字段,并仅请求最少的补充信息。
使用方法
text
录入新试剂
python scripts/main.py --scan REAGENT-001 --name Tris缓冲液 --expiry 2025-12-31 --location A货架
检查即将过期项目
python scripts/main.py --check-alerts --alert-days 30
使用自定义提醒窗口进行检查
python scripts/main.py --check-alerts --alert-days 60
参数
| 参数 | 类型 | 必填 | 默认值 | 描述 |
|---|
| --scan | 字符串 | 否 | — | 试剂条形码或ID |
| --name |
字符串 | 否 | — | 试剂名称 |
| --expiry | 日期 | 否 | — | 过期日期(YYYY-MM-DD) |
| --location | 字符串 | 否 | — | 存储位置 |
| --quantity | 字符串 | 否 | — | 现有数量 |
| --check-alerts | 标志 | 否 | — | 检查即将过期项目 |
| --alert-days | 整数 | 否 | 30 | 过期前提醒天数 |
提醒级别
- - 🔴 已过期 — 试剂已过有效期
- 🟠 严重 — 30天内过期
- 🟡 警告 — 60天内过期
- 🟢 正常 — 60天后过期
输出内容
- - 包含每项试剂提醒级别的过期提醒报告
- 库存摘要
- 针对严重/过期项目的补货建议
压力测试规则
对于复杂的多约束请求,始终包含以下明确区块:
- 1. 假设条件
- 已检查试剂
- 提醒报告
- 补货建议
- 风险与人工检查
错误处理
- - 如果缺少必要输入,明确说明缺失哪些字段,并仅请求最少的补充信息。
- 如果任务超出文档范围,停止处理,而非猜测或悄然扩大任务范围。
- 如果scripts/main.py执行失败,报告失败点,总结仍可安全完成的内容,并提供人工备用方案。
- 不得编造过期日期、库存数量或补货阈值。
输入验证
此技能接受:用于录入的试剂条形码/ID和过期日期,或用于库存审查的检查提醒请求。
如果请求不涉及试剂有效期追踪——例如要求进行化学品危害评估、废物处置指导或受控物质管理——请勿继续执行工作流程。应回复:
reagent-expiry-alert旨在记录试剂过期日期并在过期前生成提醒。您的请求似乎超出此范围。请提供试剂ID和过期日期,或使用更合适的工具。
响应模板
对于非简单请求,使用以下固定结构:
- 1. 目标
- 已接收输入
- 假设条件
- 工作流程
- 可交付成果
- 风险与限制
- 后续检查
如果请求简单,可压缩结构,但当假设条件和限制影响正确性时,仍需明确说明。