关于 margin-analyzer
margin-analyzer 是面向中小企业主的定价分析技能，汇总成本与交易数据，计算产品或服务的单位经济指标并比较定价情景。它提供数据分析而不替业主做定价决定。
主要功能
- 01汇总成本与收入数据
- 02计算毛利及单位经济指标
- 03结合行业与历史数据作背景分析
- 04模拟涨价情景及收入影响
- 05标注数据质量限制
适用场景
- 01评估各产品或服务的毛利
- 02比较涨价 5%、10% 或 15% 的情景
- 03依据历史交易分析销量与价格变化
- 04使用 CSV 补充缺失的连接器数据
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/margin-analyzer确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
reference/csv-schema.mdgotchas.mdindustry-benchmarks.mdreference/examples/retail-boutique.mdservice-business.md详细介绍
Margin Analyzer
Status: MVP 草稿 · Owner: JJ · Version: 1.1.0 Category: Finance & Ops · Phase: V2
快速开始
当小企业主问"我该提价吗？"或"我的利润率还行吗？"时，此技能会：
- 确定分析对象：明确纳入范围的产品或服务
- 从 QuickBooks 拉取成本数据（COGS、直接费用）
- 从 PayPal 或 Square 拉取收入数据（交易历史）
- 计算单位经济效益：每个项目的收入、COGS、毛利、毛利率
- 对照背景信息做基准比较：通胀、成本变化、行业常规水平（如有）
- 构建定价情景：基于历史相关性（数据允许时），展示价格上涨 +5%、+10%、+15% 时收入与利润率的变化
- 呈现分析结果：不给出定价建议，由业主自行决定
输出结果让业主基于真实数据自行做出定价决策。
工作流
第 1 步：前期检查
QuickBooks： 调用 company-info 确认行业字段已填写。若缺失或为"Unknown"，询问："我需要您的业务类别来拉取相关基准数据。您处于哪个行业？"然后调用 quickbooks-profile-info-update。
PayPal： 无需前期检查，但 PayPal 会对频繁调用进行限流，详见 reference/gotchas.md。
无连接器： 提供 CSV 上传作为备选方案。该技能可基于导出的交易和费用数据工作。预期的 CSV 结构见 reference/csv-schema.md。
第 2 步：明确分析范围
向业主询问两个问题：
-
"您想分析哪些产品或服务？"
- 全部，还是特定子集？
- 若对方回答"全部"，在拉取全部数据前，先确认连接器的数据量足以产生有意义的结果。
-
"对您来说，哪个指标最重要？"
- 毛利（收入减去直接成本）？
- 净利（扣除全部费用后）？
- 单位收入？
- 对方的回答将决定输出结果的呈现方式。
第 3 步：拉取成本数据（QuickBooks）
使用 profit-loss-quickbooks-account 从 QuickBooks 获取数据：
- 日期范围： 最近 12 个月（若可用数据不足，则取全部历史）
- 提取内容： 按产品或服务线划分的销货成本，以及直接费用
若未连接 QuickBooks，向业主索取：
- 按产品或服务线划分的成本明细（材料、人工、每项的直接交付成本）
- 过去 6–12 个月内已知的任何成本变化
若已连接 QuickBooks，但所有期间的 COGS 均为 $0，则不要将 $0 用作成本输入。需向业主说明此情况：
"QuickBooks 显示该期间未记录任何销货成本。要计算有意义的利润率，我需要按产品或服务线划分的成本明细，而不是整个业务的单一平均值。对于您想分析的每个项目，交付它需要花费多少成本？材料、直接人工、每个项目的任何直接费用。即使是粗略数字也可以。"
在最终输出的数据质量说明部分标注此限制。
第 4 步：拉取收入数据（PayPal / Square）
从 list_transactions（PayPal）或 make_api_request（Square）获取数据：
- 日期范围： 与成本数据时间窗口保持一致（最近 12 个月）
- 提取内容： 交易金额、产品或服务名称、日期，以及（如有）数量
若触发 PayPal 限流，暂停 30 秒后重试一次。若仍被阻止，提供选项："PayPal 目前暂时受到限流。要改用 Square 或上传 CSV 吗？"
若仅有一个数据来源可用，在输出中注明此限制。
第 5 步：计算单位经济效益
对于范围内的每个产品/服务，计算以下指标：
| 指标 | 公式 |
|---|---|
| 收入 | 该项目的交易金额总和 |
| COGS | 来自 QB 或业主提供的成本数据 |
| 毛利 | 收入 − COGS |
| 毛利率 % | (毛利 ÷ 收入) × 100 |
| 销售数量 | 交易笔数（如有） |
| 单件收入 | 收入 ÷ 销售数量 |
| 单件成本 | COGS ÷ 销售数量 |
对利润率低于 20% 的任何项目进行标记。此标记并非建议，而是供业主关注的数据点。
第 6 步：基准对比
加入背景信息，使数字更具意义：
- 通货膨胀： 若讨论投入成本上涨，请注明相关的成本趋势。示例："在此期间，您的投入成本上涨约 X%，而售价保持不变，这使毛利率压缩了 Y 个百分点。"
- 行业基准： 利用 QuickBooks 行业概况，得出其类别大致的毛利率水平。参见
reference/industry-benchmarks.md。 - 历史对比： 若有 24 个月以上的数据，将今年的毛利率与去年进行比较，以呈现趋势方向。
对于数据较少的情况需妥善处理：若交易记录不足 6 个月，则省略价格弹性部分，并注明："您至少需要 6 个月的定价历史，才能估算销量如何随价格变化而响应。我将改为展示情景测算。"
第 7 步：定价情景
为每个产品/服务构建一张表格，展示三种价格变动情景：
| 情景 | 新价格 | 预计收入* | 毛利率 % |
|---|---|---|---|
| +5% | $X | $Y | Z% |
| +10% | $X | $Y | Z% |
| +15% | $X | $Y | Z% |
预计收入的计算方法：
- 若有 6 个月以上的历史数据： 利用历史数据估算销量响应。若存在过往的价格变动，则计算实际观测到的弹性：
弹性 = 销量变化百分比 ÷ 价格变化百分比。以此推算新价格下的预计销量。 - 若历史数据不足： 展示三种销量假设（−0%、−5%、−10%），由业主选择最符合实际的假设。
请添加以下说明："以上为基于现有数据的预测，并非保证。实际的销量响应取决于竞争状况、客户敏感度和时机。"
第 8 步：呈现分析结果
按以下结构输出：
以二级标题展示企业名称和日期范围，随后包含四个部分：单位经济效益汇总表（产品/服务、收入、COGS、毛利、毛利率 %）；背景与基准对比部分（2-4 句，涵盖通货膨胀、成本变化和行业水平）；定价情景（每个产品一张情景表，若产品较多则选取前 3-5 个）；以及数据质量说明（标注任何局限性，如数据不完整、缺少 COGS 或历史数据过短）。
保持客观。不要说"您应该提高价格"或"考虑降低价格"。业主是在查看数据后自行做出判断。
范围界定
本技能仅呈现数据，不推荐价格。
若业主问"那我该怎么做？"，请回复："我可以告诉您数据显示了什么，但定价决策由您自行做出。您是否需要我再测算其他情景？"
这是有意为之。定价决策会带来实际的商业后果，并且依赖只有业主才了解的背景信息（如竞争定位、客户关系、资金需求）。本技能的职责是确保业主在决策时参考的是真实数字。
连接器
主要： QuickBooks、PayPal 同样支持： Square、Brex · 桌面端（CSV/导出）
参考文件
reference/gotchas.md— 常见陷阱（数据缺口、弹性误区、毛利计算错误）reference/industry-benchmarks.md— 按中小企业类别划分的毛利率区间reference/csv-schema.md— 业主上传 CSV 时的预期列reference/examples/— 实际情景示例（零售、服务、产品类）