AgentSkillsCN

kakutey-bookkeeping

在 Kakutey 记账应用中录入单笔或批量分录,并列出各类分录。适用于日常记账、年终批量录入,以及复核已过账的分录。

SKILL.md
--- frontmatter
name: kakutey-bookkeeping
description: Register journal entries (single or bulk) and list journals in the kakutey bookkeeping app. Use for daily bookkeeping, year-end batch entry, and reviewing posted journals.

kakutey-bookkeeping

kakutey の仕訳登録ワークフローを支援するスキル。勘定科目の確認、単発・一括の仕訳登録、登録済み仕訳の一覧表示を行う。

前提条件

kakutey CLI がインストールされ、アプリが起動している必要があります。

bash
# インストール
npm install -g kakutey-cli

# 状態確認
kakutey health

リソース

  • API 仕様: api_journals.md
  • CLI ヘルプ: kakutey journals --help, kakutey accounts --help

ワークフロー

A. 年次一括記帳

仕訳データを JSON ファイルとして準備し、一括登録する。

  1. 勘定科目を確認して、科目名を把握する

    bash
    kakutey accounts list
    kakutey accounts list --category expense
    
  2. 仕訳データ JSON を準備する(配列形式)

    json
    [
      {
        "date": "2025-01-15",
        "description": "文房具購入",
        "lines": [
          {"side": "debit", "account": "消耗品費", "amount": 1000},
          {"side": "credit", "account": "現金", "amount": 1000}
        ]
      }
    ]
    
  3. 一括登録する

    bash
    kakutey journals bulk-add journals.json
    
  4. 登録内容を確認する

    bash
    kakutey journals list 2025-01-01 2025-12-31
    

B. 日常の仕訳登録

単発の取引を登録する。

bash
# 簡易形式(2行仕訳)
kakutey journals add '{"date":"2025-03-10","description":"サンプル商事 打ち合わせ交通費","debit_account":"旅費交通費","credit_account":"現金","amount":500}'

# 複合仕訳(3行以上)
kakutey journals add '{"date":"2025-01-01","description":"開始仕訳","lines":[{"side":"debit","account":"現金","amount":50000},{"side":"debit","account":"普通預金","amount":100000},{"side":"credit","account":"元入金","amount":150000}]}'

# ファイルから登録
kakutey journals add --file journal.json

CLI コマンド一覧

コマンド説明
kakutey accounts list [--category <type>]勘定科目一覧(entity_id, code, name, category)
kakutey journals add '<json>'仕訳を1件登録(簡易形式 or 複合仕訳形式)
kakutey journals add --file <path>JSON ファイルから仕訳を1件登録
kakutey journals bulk-add <file>JSON ファイルから仕訳を一括登録
kakutey journals list <start> <end>指定期間の仕訳一覧を表示(entity_id 付き)

関連スキル

  • kakutey-evidence: 仕訳に証憑(領収書等)を紐付ける場合に使用
  • kakutey-corrections: 登録済み仕訳の修正・削除を行う場合に使用