← 返回 Skills 市场
Promotion Engine
作者
fangwei-frank
· GitHub ↗
· v1.0.0
· MIT-0
110
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install promotion-engine
功能描述
Retail promotion calculator and discount lookup for digital employees. Computes final prices after applying discounts, bundles, thresholds, and membership ti...
安全使用建议
What to consider before installing or using:
- Functionality mismatch: the SKILL.md promises bundle/gift/member_price handling but the script only implements threshold and percentage discounts (and membership rate). If you need bundle/gift logic, ask the author to provide tests or implement those rules.
- KB file access: the script reads whatever JSON file path you pass via --kb. Make sure the agent is only given a sanitized knowledge_base.json (no secrets, tokens, or unrelated sensitive data) and consider running the skill in a sandboxed environment.
- Review/QA: inspect promo examples and test edge cases (bundles, BOGO, excluded items, stackability) with sample KBs before trusting customer-facing outputs.
- Missing references: SKILL.md references references/promo-rules-guide.md which is not included; ask the publisher for that document if you need the authoritative rule parsing spec.
- If you plan to allow autonomous agent runs, restrict the agent’s ability to choose arbitrary file paths or validate the --kb argument to prevent accidental data exposure.
功能分析
Type: OpenClaw Skill
Name: promotion-engine
Version: 1.0.0
The skill bundle is a legitimate retail promotion calculator. The Python script (scripts/calculate_promotion.py) uses standard libraries to process discount logic based on a provided knowledge base file and item list, with no evidence of network activity, data exfiltration, or unauthorized command execution. The SKILL.md instructions are strictly aligned with the stated purpose of calculating prices and explaining discounts to users.
能力评估
Purpose & Capability
Name/description = retail promotion calculator. The included script implements core threshold and percent discounts and membership discounts, which is coherent with the purpose. However SKILL.md advertises support for bundles, gifts, member_price, and more complex rules; the script does not implement bundle/gift/member_price parsing or bundle-specific logic. This is a functional mismatch (over-promised features).
Instruction Scope
SKILL.md instructs the agent to use scripts/calculate_promotion.py and a knowledge_base.json containing promotions[] and membership{}. The script reads an arbitrary --kb path (Path(args.kb).read_text()) and will JSON-load whatever file is passed. There is no guidance or enforcement limiting which file may be supplied; if the agent is given a path outside the intended KB, the script will read that file (if readable). This increases the risk of exposing or operating on unrelated sensitive JSON data. No network calls or external endpoints are present.
Install Mechanism
No install spec (instruction-only with a bundled script). Nothing is downloaded or written by an installer. The script itself is a local file and is executed directly; low installation risk.
Credentials
No required environment variables, no credentials, and no config paths declared. The script only needs a path to a JSON knowledge base and an items JSON payload — these are proportionate to the stated functionality. However, because the KB path is unrestricted, the opportunity to read arbitrary JSON files should be considered.
Persistence & Privilege
Skill is not always-enabled and does not request elevated/persistent privileges. It does not modify other skills or system configuration. Autonomous invocation is allowed by default (normal), but this combined with the unconstrained KB path is why caution is warranted.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install promotion-engine - 安装完成后，直接呼叫该 Skill 的名称或使用
/promotion-engine触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
first release
元数据
常见问题
Promotion Engine 是什么？
Retail promotion calculator and discount lookup for digital employees. Computes final prices after applying discounts, bundles, thresholds, and membership ti... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 110 次。
如何安装 Promotion Engine？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install promotion-engine」即可一键安装，无需额外配置。
Promotion Engine 是免费的吗？
是的，Promotion Engine 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Promotion Engine 支持哪些平台？
Promotion Engine 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Promotion Engine？
由 fangwei-frank（@fangwei-frank）开发并维护，当前版本 v1.0.0。
推荐 Skills