Back to skills
extension
Category: Data & AnalyticsNo API key required

实验室预算预测器

使用实验室预算预测工具来处理需要结构化执行、明确假设和清晰输出边界的数据分析工作流。

personAuthor: aipoch-aihubclawhub

实验室预算预测工具

财务可持续运行时长计算器。

使用场景

  • 当任务需要使用实验室预算预测工具来处理需要结构化执行、明确假设和清晰输出边界的数据分析工作流时,使用此技能。
  • 当数据分析任务需要明确的假设、有边界的范围以及可复现的输出格式时,使用此技能。
  • 当你需要针对缺失输入、执行错误或部分证据提供文档化的回退路径时,使用此技能。

主要特性

  • 以此为核心的工作流范围:使用实验室预算预测工具来处理需要结构化执行、明确假设和清晰输出边界的数据分析工作流。
  • 打包的可执行路径:scripts/main.py
  • 结构化执行路径,旨在保持输出的一致性和可审查性。

依赖项

相关细节请参见上方的 ## Prerequisites

  • Python3.10+。当前打包技能的仓库基线版本。
  • 第三方包本技能包未明确指定版本。如果此技能需要更严格的环境控制,请添加固定版本号。

使用示例

cd "20260318/scientific-skills/Data Analytics/lab-budget-forecaster"
python -m py_compile scripts/main.py
python scripts/main.py --help

示例运行计划:

  1. 确认用户输入、输出路径以及任何必需的配置值。
  2. 如果脚本使用固定设置,编辑文件内的 CONFIG 块或文档化参数。
  3. 使用已验证的输入运行 python scripts/main.py
  4. 检查生成的输出,并返回最终产出物,同时说明任何假设。

实现细节

相关细节请参见上方的 ## Workflow

  • 执行模型:验证请求、选择打包的工作流,并产出有边界的交付物。
  • 输入控制:在运行任何脚本之前,确认源文件、范围限制、输出格式和验收标准。
  • 主要实现入口:scripts/main.py
  • 需要首先明确的参数:输入路径、输出路径、范围过滤条件、阈值以及任何领域特定的约束。
  • 输出规范:保持结果可复现,明确标注假设,避免未记录的副作用。

快速检查

使用此命令在进行更深入的执行之前,验证打包的脚本入口点可以被正确解析。

python -m py_compile scripts/main.py

可审计命令

使用以下具体命令进行验证。这些命令有意设计为自包含的,避免使用占位路径。

python -m py_compile scripts/main.py
python scripts/main.py --help

工作流

  1. 在进行详细工作之前,先确认用户目标、所需输入以及不可协商的约束条件。
  2. 验证请求是否符合文档化的范围,如果任务需要不受支持的假设,则提前停止。
  3. 使用打包的脚本路径或文档化的推理路径,仅使用实际可用的输入。
  4. 返回一个结构化的结果,明确区分假设、交付物、风险和未解决的问题。
  5. 如果执行失败或输入不完整,切换到回退路径,并准确说明是什么阻碍了完全完成任务。

应用场景

  • 经费管理
  • 招聘决策
  • 设备采购
  • 无成本延期规划

参数

| 参数 | 类型 | 默认值 | 是否必需 | 说明 | |-----------|------|---------|----------|-------------| | --current-balance | float | - | 是 | 剩余资金(美元) | | --monthly-burn | float | - | 是 | 每月支出 | | --upcoming-costs | float | 0 | 否 | 即将发生的一次性采购支出 | | --currency | string | USD | 否 | 货币代码 | | --output, -o | string | stdout | 否 | 输出文件路径 |

返回结果

  • 可持续运行时长预测
  • 关键日期预警
  • 削减成本情景方案
  • 过渡资金预警

示例

15 万美元余额,每月 1.5 万美元支出 → 可持续运行 10 个月

风险评估

| 风险指标 | 评估 | 等级 | |----------------|------------|-------| | 代码执行 | 本地执行 Python/R 脚本 | 中 | | 网络访问 | 无外部 API 调用 | 低 | | 文件系统访问 | 读取输入文件,写入输出文件 | 中 | | 指令篡改 | 标准提示词准则 | 低 | | 数据暴露 | 输出文件保存在工作区中 | 低 |

安全检查清单

  • [ ] 无硬编码的凭据或 API 密钥
  • [ ] 无未授权的文件系统访问(../)
  • [ ] 输出不暴露敏感信息
  • [ ] 已配备提示注入防护措施
  • [ ] 已验证输入文件路径(无 ../ 路径遍历)
  • [ ] 输出目录限制在工作区内
  • [ ] 脚本在沙箱环境中执行
  • [ ] 错误信息已做脱敏处理(不暴露堆栈跟踪)
  • [ ] 依赖项已审计

前置条件

无需额外的 Python 包。

评估标准

成功指标

  • [ ] 成功执行主要功能
  • [ ] 输出符合质量标准
  • [ ] 能够妥善处理边界情况
  • [ ] 性能可接受

测试用例

  1. 基本功能:标准输入 → 预期输出
  2. 边界情况:无效输入 → 妥善的错误处理
  3. 性能:大数据集 → 可接受的处理时间

生命周期状态

  • 当前阶段:草稿
  • 下次审查日期:2026-03-06
  • 已知问题:无
  • 计划改进项
    • 性能优化
    • 增加功能支持

输出要求

每个最终响应在相关时都应明确以下内容:

  • 目标或所需的交付物
  • 使用的输入及引入的假设
  • 工作流或决策路径
  • 核心结果、建议或产出物
  • 约束、风险、注意事项或验证需求
  • 未解决的问题及后续检查项

错误处理

  • 如果缺少必需的输入,准确说明缺少哪些字段,并仅请求所需的最少额外信息。
  • 如果任务超出文档化的范围,应停止而不是猜测或悄悄扩大任务范围。
  • 如果 scripts/main.py 执行失败,报告失败点,总结仍能安全完成的部分,并提供手动回退方案。
  • 不得编造文件、引用、数据、搜索结果或执行结果。

输入验证

此技能接受符合 lab-budget-forecaster 文档化用途的请求,且该请求需包含足够的上下文以安全完成工作流。

当请求超出范围、缺少关键输入,或需要不受支持的假设时,不要继续执行工作流。应回复:

lab-budget-forecaster 仅处理其文档化的工作流。请提供缺失的必需输入,或切换到更合适的技能。

响应模板

对于非简单请求,使用以下固定结构:

  1. 目标
  2. 收到的输入
  3. 假设
  4. 工作流
  5. 交付物
  6. 风险与限制
  7. 后续检查项

如果请求较为简单,可以压缩结构,但仍需在影响正确性时明确说明假设和限制。