手工皂配方设计:从对话到草稿配方的一站式技能

0 0 更新时间: 2026-08-02 17:26:34

该技能是手工皂制作流程的起点,通过与用户对话明确模具、用途、香氛和油脂需求,生成草稿配方。它读取库存但从不修改,所有数值由工具计算,并交由SoapCalc交叉验证后才转为就绪状态。适用于开始新一批手工皂时的配方设计。

安装
npx skills add https://github.com/bstaruk/soap.git --skill formulate
技能详情 readonly

手工皂配方设计,也能这么智能?

说实话,我一开始看到这个技能的时候有点懵——手工皂配方设计?这不就是翻翻书、算算碱量的事儿吗?但当我仔细研究了这个叫 Formulate — design one batch 的技能之后,才发现自己格局小了。

这玩意儿可不是简单的配方模板,它是一个完整的配方设计工作流,专门用来帮助手工皂制作者在开始新批次时,通过一场结构化的对话,最终生成一份经过精确计算的草稿配方。整个过程严谨得让我有点破防——它甚至规定"Claude永远不做碱量算术",所有数字必须来自专门的工具,而且最终配方必须经过外部SoapCalc的交叉验证才能转为Ready状态。

它到底能干什么?

简单来说,这个技能是手工皂制作流程的入口点。每次你打算做新一批皂的时候,它会引导你完成以下步骤:

  • 阅读项目文档:包括根目录的CLAUDE.md(硬性规则)、配方指南、方法文档,以及当前库存(模具、香氛、基础油)——注意,是只读的。
  • 锁定设计简报:和你对话确认模具(决定批量大小)、用途(手皂、沐浴皂、礼品等,决定配方和超脂比例)、香氛(查看库存剩余量、香草醛含量等)、以及任何特殊油脂或意图。
  • 调用计算器:使用tools/lye.py计算碱量、水量、香氛量等所有数字,绝不允许手工计算或"微调"。
  • 生成草稿配方:在recipes/目录下创建带编号的Markdown文件,包含完整的厨房操作表。
  • 等待验证:将配方标记为Draft,提示用户去SoapCalc交叉验证碱量,验证通过后才会转为Ready。

安装其实很简单

如果你和我一样用的是支持Skills的环境(比如Claude Code),安装这个技能只需要一条命令:

npx skills add https://github.com/bstaruk/soap.git --skill formulate

这条命令会从GitHub仓库bstaruk/soap拉取技能文件,作者是bstaruk。安装好之后,你就可以直接跟它说"帮我设计一个新批次的手工皂",它就会自动进入配方设计流程。

如果你的环境不支持npx,也可以直接下载ZIP包,解压后把.skills/formulate目录放到合适的位置,同样能用。

我的使用体验

我试着用这个技能设计了一个简单的沐浴皂批次。一开始它问我用什么模具,我说了一个长方形的,它就自动计算了批量大小,还建议填充量在92-95%之间——这个细节真的挺贴心的,因为做皂的人都知道,装得太满容易溢出,太少又浪费空间。

然后它问我用途,我说是沐浴皂,它就推荐了配方中默认的混合油和超脂比例。接着它问我香氛,我提到有一瓶快用完的薰衣草精油,它居然提醒我:"这瓶只有30克,如果要用它,批量大小需要调整,或者考虑混合其他香氛。"——这就是读取库存的好处,避免设计出做不了的配方。

最后它生成了一个草稿配方,把所有数字都列出来了,包括碱量、水量、香氛量、填充率等等。它还特别提醒我:"这是草稿,请在SoapCalc上交叉验证碱量,如果匹配,再将soapcalc_confirmed设为true,status设为ready。"这种严谨的态度真的让人放心。

几个值得注意的细节

用了几次之后,我发现这个技能有几个设计得特别聪明的地方:

  • 库存只读:它永远不修改库存文件,库存变更由其他技能处理,这样可以避免误操作。
  • 不越权:它绝不自己把配方标记为Ready,必须由用户(或用户手动操作)在SoapCalc验证后更改状态。
  • 有护栏:如果计算器显示"OVERFLOWS"(超出模具容量),它会直接告诉你批量太大,需要调整,而不是让你硬塞。
  • 不瞎编数据:如果遇到没有SAP值的油脂,它会停下来,而不是猜测一个数字。

这些设计原则让这个技能不仅仅是一个工具,更像是一个有经验的制皂师傅在指导你,每一步都确保安全和合规。

实际应用场景

这个技能最适合以下场景:

  • 新手制皂:不用担心算错碱量,所有计算自动完成,而且有二次验证。
  • 库存管理:每次设计配方时都会自动查看现有原料,避免重复购买或浪费。
  • 批量生产:如果你经常做皂,这个技能可以帮你保持配方一致性,每个批次都有完整的记录。
  • 实验探索:想尝试新油脂或新香氛?它会在安全范围内帮你设计实验配方。

一点小吐槽

说实话,这个技能对环境的依赖有点强,如果项目文档(比如formulation.md)不完整,它可能会多问一些问题。另外,它要求使用绝对精确的计算工具,如果你没有安装Python环境,可能要先配置一下。但这些都是小事,比起手工算碱量的风险,这点麻烦完全值得。

总之,如果你是个手工皂爱好者,或者正在考虑做一个制皂管理项目,这个技能绝对值得一试。它把配方设计从"凭感觉"变成了"凭数据",同时保留了对话的灵活性,真是绝绝子!