mcpField
T
tidy

tidy

github.com/davepoon数据与数据库3.7k98 次安装2 天前更新
代码仓库

关于 tidy

tidy 是一项用于整理未分类交易的技能,通过相似描述聚类并批量建议类别和商户名称。它先征求用户确认,再为重复交易创建规则,或直接标注一次性交易。

主要功能

  1. 01获取指定期间的未分类交易
  2. 02按描述或商户聚类交易
  3. 03为交易组建议类别和商户名称
  4. 04预览并创建自动分类规则
  5. 05直接标注一次性交易

适用场景

  1. 01批量整理近 90 天的未分类交易
  2. 02调查难以识别的商户或处理方
  3. 03为重复出现的商户建立分类规则

MCP 相关

该技能调用 MCP `query` 工具读取交易,并使用 `admin` 工具预览或创建规则、分类交易及设置商户名称。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/davepoon/buildwithclaude --skill tidy

安装后在 Claude Code 中输入/tidy确认已加载。

详细介绍

整理未分类的交易

通过对相似交易进行聚类并批量应用类别,为未分类的交易批量分类。

工作流

  1. 获取未分类的交易。 调用 query MCP 工具:

    { "detail": true, "is_uncategorized": true, "period": "last_90d", "limit": 200, "sort": "-amount" }
    

    如果 $ARGUMENTS 中包含时间范围(例如“本月”“过去 30 天”),请使用该时间范围,而不是 last_90d。

  2. 调查未知交易。 对于仅凭描述无法识别的交易:

    • 优先进行网络搜索(如果可用):搜索商户名称、描述中的电话号码或域名,或原始描述。这通常有助于查明隐晦的支付处理商名称背后的商家。
    • 搜索用户的电子邮件(如果可用):搜索相关方或商户名称,查找订单确认邮件或收据。如果没有匹配结果,可搜索确切的金额(例如“$47.23”),以此查找收据。
  3. 按模式聚类。 按规范化后的描述或相关方名称对结果分组。记录每组的交易数量和总金额。

  4. 建议分类。 对每组提出以下建议:

    • 一个类别(从用户现有的类别中选择)
    • 一个相关方名称(简洁明确的商户或交易对手名称)
  5. 向用户展示。 用表格或列表展示各组,包含以下信息:

    • 模式/商户名称
    • 交易数量
    • 总金额
    • 建议类别
    • 是否建议创建规则

    请用户批准、修改或跳过每组。

  6. 优先创建规则,而非仅添加一次性注释。 如果某组包含多笔交易,或该商户可能再次出现(订阅、常去商店、公用事业等),请创建规则,而不是逐笔标注。规则也会自动为未来的交易分类。

    • 先预览:admin { "entity": "rule", "action": "preview", ... }
    • 展示预览结果(符合条件的现有交易数量)
    • 如果用户确认,则创建:admin { "entity": "rule", "action": "create", ... }
  7. 标注其余交易。 对于确实只发生一次且创建规则无济于事的交易,直接应用:

    { "action": "categorize", "filter": { "search": "<pattern>" }, "category_name": "<approved_category>" }
    

    如果用户批准了相关方名称,也一并设置:

    { "action": "set_party", "filter": { "search": "<pattern>" }, "party_name": "<approved_party>" }
    
  8. 汇总。 报告已分类的交易数量、已创建的规则数量,以及剩余未分类的交易数量。

语气

只陈述事实。客观呈现调查结果和建议,不对消费习惯发表评论。只提供清晰、通俗的观察结果和可执行的选项。

评论

支持 Markdown