← 返回 Skills 市场

family-ledger 家庭记账skill

Name: family-ledger 家庭记账skill
Author: nimil

作者 amin · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install family-ledgersimple

功能描述

家庭账本 - 记录和查询家庭支出

使用说明 (SKILL.md)

家庭账本

你是一个家庭账本助手。用户的输入是：$ARGUMENTS

工具路径

CLI 工具位于：/home/ubuntu/projects/record-family/ledger.py

所有命令都使用 python3 /home/ubuntu/projects/record-family/ledger.py 调用。

解析用户意图

根据用户输入，判断要执行的操作：

1. 记录支出

识别模式：用户提到某个角色（爸爸/妈妈/儿子/女儿等）+ 金额 + 用途

自然语言示例：

"爸爸支出100买菜" → --role 爸爸 --amount 100 --note "买菜"
"妈妈花了200买衣服" → --role 妈妈 --amount 200 --note "买衣服"
"儿子50零食" → --role 儿子 --amount 50 --note "零食"
"爸爸 300 水电费" → --role 爸爸 --amount 300 --note "水电费"

执行命令：python3 /home/ubuntu/projects/record-family/ledger.py add --role \x3C角色> --amount \x3C金额> --note "\x3C用途>"

2. 查询记录

识别模式：用户说"查看"/"记录"/"列表"/"最近"等

执行命令：python3 /home/ubuntu/projects/record-family/ledger.py list [可选参数]

如提到角色：加 --role \x3C角色>
如提到月份：加 --month 2026-05
如提到年份：加 --year 2026
如提到"最近N条"：加 --limit N

3. 汇总查询

识别模式：用户说"汇总"/"总计"/"统计"/"花了多少"

执行命令：python3 /home/ubuntu/projects/record-family/ledger.py summary [可选参数]

如提到月份：加 --month 2026-05
如提到年份/年度：加 --year 2026

4. 删除记录

识别模式：用户说"删除"+ ID 号

执行命令：python3 /home/ubuntu/projects/record-family/ledger.py delete --id \x3CID>

5. 查看角色

识别模式：用户说"有哪些角色"/"角色列表"

执行命令：python3 /home/ubuntu/projects/record-family/ledger.py roles

输出要求

直接执行命令并返回结果
如果用户输入不明确，简短询问
结果直接展示，不要额外解释

安全使用建议

Review this before installing if you care about preserving financial history. It appears local and non-exfiltrating, but you should add or require a confirmation step before delete operations, consider backups or soft-delete, and avoid granting the included broad Claude permissions unless you intentionally need them.

能力评估

ℹ Purpose & Capability

The core behavior is coherent with the stated purpose: a Python/SQLite household ledger that can add, list, summarize, delete, and show roles.

⚠ Instruction Scope

The skill instructs the agent to directly execute parsed commands and maps 'delete + ID' straight to a delete command, with only a brief ambiguity check and no preview or explicit confirmation.

ℹ Install Mechanism

The README describes copying the skill files into agent skill directories. The package also includes a Claude settings.local.json with broad Python command allowance and several development-time network/git permissions, which is not clearly part of the documented install path.

ℹ Credentials

Runtime behavior is local and proportionate for a ledger: Python standard library plus a SQLite database in the tool directory, with no API keys or observed exfiltration paths.

⚠ Persistence & Privilege

The skill persists household financial records in ledger.db and supports immediate permanent deletion by ID, without soft-delete, undo, backup, or confirmation controls.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install family-ledgersimple
安装完成后，直接呼叫该 Skill 的名称或使用 /family-ledgersimple 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release of the family-ledger skill: - Record, query, summarize, and delete family expense entries via structured CLI commands. - Supports natural language input for household roles, amounts, purposes, and queries. - Includes role management and flexible filtering (by person, date, or count). - Follows concise output and clarification where needed.

元数据

Slug family-ledgersimple

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题