Role
Create invoices through a structured process. Gather client data, calculate taxes, generate PDF, send, track payment.
Key difference: This skill CREATES invoices to send. The invoices skill MANAGES received invoices.
Storage
CODEBLOCK0
Quick Reference
| Topic | File |
|---|
| Invoice creation phases | INLINECODE1 |
| Client data management |
clients.md |
| Template and PDF generation |
templates.md |
| Legal requirements by country |
legal.md |
| Invoice types (regular, simplified, credit) |
types.md |
Process Summary
- 1. Discovery — Identify client, service, amount. Load or create client record.
- Draft — Generate invoice with auto-calculated taxes and next number.
- Review — Show preview, allow edits.
- Finalize — Generate PDF, lock number.
- Send — Email to client (optional).
- Track — Monitor payment status.
See phases.md for detailed workflow.
Critical Rules
- - Never reuse numbers — Even cancelled invoices keep their number. Use credit notes for corrections.
- Correlative numbering — No gaps within a series. F-001, F-002, F-003.
- Tax calculation — Always show: base, rate, amount, total. Never hide taxes.
- Client data required — For B2B: company name, tax ID, address. No invoice without complete data.
Configuration Required
Before first invoice, collect:
- - User's business name, tax ID, address
- Bank details (IBAN) for payment
- Default tax rate
- Invoice series format (e.g., "F-2026-")
- Email for sending (optional)
角色
通过结构化流程创建发票。收集客户数据、计算税额、生成PDF、发送并跟踪付款。
关键区别： 此技能是创建要发送的发票。而 invoices 技能是管理收到的发票。
存储结构
~/billing/
├── drafts/ # 进行中的工作
│ └── {客户名称}/
│ ├── current.md # 最新版本
│ └── versions/ # v001.md, v002.md
├── sent/ # 已定稿的发票
│ └── 2026/
│ └── F-2026-001.pdf
├── clients/ # 客户数据库
│ └── index.json
├── config.json # 用户的业务数据、模板
└── series.json # 按系列编号
快速参考
| 主题 | 文件 |
|---|
| 发票创建阶段 | phases.md |
| 客户数据管理 |
clients.md |
| 模板与PDF生成 | templates.md |
| 各国法律要求 | legal.md |
| 发票类型（常规、简易、贷项） | types.md |
流程概要
- 1. 发现 — 识别客户、服务、金额。加载或创建客户记录。
- 草稿 — 生成发票，自动计算税额和下一个编号。
- 审核 — 显示预览，允许编辑。
- 定稿 — 生成PDF，锁定编号。
- 发送 — 通过电子邮件发送给客户（可选）。
- 跟踪 — 监控付款状态。
详细工作流程请参见 phases.md。
关键规则
- - 绝不重复使用编号 — 即使已取消的发票也保留其编号。更正时使用贷项通知单。
- 连续编号 — 同一系列内无间隔。F-001、F-002、F-003。
- 税额计算 — 始终显示：基数、税率、税额、总额。绝不隐藏税额。
- 客户数据必填 — 对于B2B：公司名称、税号、地址。数据不完整则不生成发票。
需要配置
在首次创建发票前，需收集：
- - 用户的业务名称、税号、地址
- 用于付款的银行信息（IBAN）
- 默认税率
- 发票系列格式（例如 F-2026-）
- 用于发送的电子邮件（可选）
