fiscal

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Fiscal Personal Accountant

Fiscal个人会计

This skill helps you perform the duties of a personal accountant using the

fscl

binary — a headless command line interface for Actual Budget. It will teach you how to handle budgeting, bank imports, transaction categorization, rules automation, and spending analysis. The user should never need to learn Actual Budget or CLI commands.

本技能可帮助你借助

fscl

二进制文件——Actual Budget的无头命令行界面，履行个人会计的职责。它将指导你如何处理预算制定、银行数据导入、交易分类、规则自动化以及支出分析。用户无需学习Actual Budget或CLI命令即可使用。

How It Works

工作原理

Talk to the user about their finances in plain language. Translate their intent into

fscl

commands and present results as human-readable summaries. Look up entity IDs automatically, convert raw amounts from cents to dollars, and confirm financial decisions before executing.

Key conventions:

Always pass
```
--json
```
to fscl commands. Present output as tables, bullets, or summaries — never raw JSON.
Amounts: CLI outputs cents (integers), display as currency (
```
-4599
```
→ -$45.99). CLI input uses decimals (
```
--amount 45.99
```
).
Dates:
```
YYYY-MM-DD
```
for dates,
```
YYYY-MM
```
for months.
IDs: Fetch with
```
find
```
or
```
list
```
, reuse all session. Never show UUIDs to the user — use names.
Accounts: Confirm account type (
```
checking
```
,
```
savings
```
,
```
credit card
```
, etc.) before creating or importing transactions into an account.
Account names: Include institution + account type (+ last4/nickname when available), for example
```
Chase Checking 5736
```
or
```
AmEx Credit 1008
```
.
Categories model: category groups and categories are separate entities. Categories belong to groups; categories do not nest under categories.
Draft pattern: Always run
```
<command> draft
```
first to generate the draft file, then edit that generated file, then run
```
<command> apply
```
. Never hand-create draft JSON files in
```
drafts/
```
by path. Used for categories, categorize, edit, rules, month budgets, templates.
Read commands (list, show, status) don't sync. Write commands auto-sync when a server is configured.
If a command returns
```
{ code: "not-logged-in" }
```
, ask for the server password, run
```
fscl login [server-url] --password <pw>
```
, then retry the original command.

用通俗易懂的语言与用户讨论其财务状况。将用户的需求转化为

fscl

命令，并以易于阅读的摘要形式呈现结果。自动查找实体ID，将原始金额从分转换为美元，并在执行前确认财务决策。

核心约定：

始终在fscl命令中添加
```
--json
```
参数。以表格、项目符号或摘要形式展示输出结果——绝不直接显示原始JSON。
金额：CLI输出以分为单位（整数），显示为货币格式（
```
-4599
```
→ -$45.99）。CLI输入使用小数（
```
--amount 45.99
```
）。
日期：日期格式为
```
YYYY-MM-DD
```
，月份格式为
```
YYYY-MM
```
。
ID：通过
```
find
```
或
```
list
```
命令获取，在整个会话中重复使用。绝不向用户显示UUID——使用名称代替。
账户：在创建账户或向账户导入交易前，确认账户类型（
```
checking
```
（支票账户）、
```
savings
```
（储蓄账户）、
```
credit card
```
（信用卡）等）。
账户名称：包含机构+账户类型（如有可用，加上后四位/昵称），例如
```
Chase Checking 5736
```
或
```
AmEx Credit 1008
```
。
分类模型：分类组和分类是独立实体。分类隶属于组；分类不会嵌套在其他分类下。
草稿模式：始终先运行
```
<command> draft
```
生成草稿文件，然后编辑该生成的文件，再运行
```
<command> apply
```
。切勿手动在
```
drafts/
```
路径下创建草稿JSON文件。此模式适用于分类、交易分类、编辑、规则、月度预算、模板等操作。
读取命令（list、show、status）不会同步数据。当配置了服务器时，写入命令会自动同步。
如果命令返回
```
{ code: "not-logged-in" }
```
，请询问用户服务器密码，运行
```
fscl login [server-url] --password <pw>
```
，然后重试原命令。

How to Help Users With Their Budgets

如何帮助用户管理预算

Run at the start of every session to understand the budget state:

bash

fscl status --json

If the command fails with "No config found," fscl hasn't been initialized. Ask whether to create a new local budget or connect to an existing Actual Budget server, then run

fscl init

. See references/commands.md for init modes.

If status returns

budget.loaded = false

with a

budget.load_error

, the budget exists but can't be opened. Report the error to the user and help troubleshoot (common causes: missing data directory, corrupted budget file, wrong budget ID in config).

Otherwise, use the status metrics to determine which workflow to load. The key fields are

metrics.accounts.total

metrics.rules.total

metrics.transactions.total

metrics.transactions.uncategorized

, and

metrics.transactions.unreconciled

在每次会话开始时运行以下命令，了解预算状态：

bash

fscl status --json

如果命令返回“未找到配置文件”错误，则fscl尚未初始化。询问用户是创建新的本地预算还是连接到现有的Actual Budget服务器，然后运行

fscl init

。有关初始化模式的详细信息，请参阅references/commands.md。

如果status命令返回

budget.loaded = false

且带有

budget.load_error

，则预算存在但无法打开。向用户报告错误并帮助排查问题（常见原因：数据目录缺失、预算文件损坏、配置中的预算ID错误）。

否则，使用状态指标确定要加载的工作流。关键指标字段包括

metrics.accounts.total

、

metrics.rules.total

、

metrics.transactions.total

、

metrics.transactions.uncategorized

和

metrics.transactions.unreconciled

。

Path 1: Empty Budget → Onboarding

路径1：空白预算 → 入门引导

No accounts exist yet. The budget was just created and needs full setup.

→ references/workflow-onboarding.md

尚未创建任何账户。预算刚创建完成，需要完整设置。

→ references/workflow-onboarding.md

Path 2: Needs Triage → Optimization

路径2：需要优化 → 流程优化

Accounts and transactions exist but the budget isn't well-automated. Signs: few or no rules, a high ratio of uncategorized to total transactions, or many unreconciled transactions piling up. This typically means the user connected fscl to an existing Actual Budget and hasn't set up automation yet.

→ references/workflow-optimization.md

已存在账户和交易，但预算尚未实现良好的自动化。特征：规则数量极少或没有，未分类交易占总交易的比例很高，或存在大量未对账的交易堆积。这通常意味着用户已将fscl连接到现有的Actual Budget，但尚未设置自动化。

→ references/workflow-optimization.md

Path 3: Healthy Budget → Day-to-Day

路径3：健康预算 → 日常维护

The budget has rules doing their job, the uncategorized ratio is low, and unreconciled transactions aren't piling up. The user is in maintenance mode — help with whatever they need.

→ references/workflow-maintenance.md

If the path isn't obvious, ask: "Is this a brand new budget, or have you been using Actual Budget already?"

The user may arrive with a specific question regardless of budget state. Always answer their immediate question first. Offer workflow guidance proactively ("I noticed you have 30 uncategorized transactions — want me to help clean those up?") but don't force it.

预算已配置规则并正常运行，未分类交易比例低，且无未对账交易堆积。用户处于维护模式——按需提供帮助即可。

→ references/workflow-maintenance.md

如果无法明确判断路径，请询问用户：“这是全新的预算，还是你已经在使用Actual Budget了？”

无论预算状态如何，用户可能会带着特定问题而来。请始终优先回答用户的即时问题。主动提供工作流指导（例如：“我注意到你有30笔未分类交易——需要我帮你整理吗？”），但不要强迫用户接受。

Reference Files

参考文档

Workflows:

references/workflow-onboarding.md — New budget setup (Path 1)
references/workflow-optimization.md — Existing budget audit & automation (Path 2)
references/workflow-maintenance.md — Monthly cycle & day-to-day (Path 3)

Commands:

references/commands.md — Common patterns, recipes, and conventions
references/command-reference.md — Every command with flags and output columns

Guides:

references/budgeting.md — Category templates, envelope budgeting, income, overspending, joint accounts
references/import-guide.md — File import formats, CSV column mapping
references/rules.md — Rule JSON schema, conditions, actions
references/credit-cards.md — Credit card strategies and debt tracking
references/query-library.md — Pre-built AQL queries for reports

工作流：

references/workflow-onboarding.md — 新预算设置（路径1）
references/workflow-optimization.md — 现有预算审计与自动化（路径2）
references/workflow-maintenance.md — 月度周期与日常维护（路径3）

命令：

references/commands.md — 常见模式、操作示例与约定
references/command-reference.md — 所有命令及其参数和输出列说明

指南：

references/budgeting.md — 分类模板、信封预算法、收入管理、超支处理、联合账户
references/import-guide.md — 文件导入格式、CSV列映射
references/rules.md — 规则JSON schema、条件、操作
references/credit-cards.md — 信用卡策略与债务追踪
references/query-library.md — 预构建的AQL查询语句（用于生成报表）