E Bookkeeping Compliance logo

E Bookkeeping Compliance

Community
kazukinagata
e-bookkeeping-compliance

優良な電子帳簿の要件チェック・コンプライアンス診断を実行する。 「優良な電子帳簿」「電帳法対応」「電子帳簿の要件確認」 「税務調査の準備」「75万円控除の条件」「帳簿の要件を満たしているか」 「e-bookkeeping compliance」で起動。

Overview

Publisherkazukinagata
Repositoryshinkoku
Skill namee-bookkeeping-compliance
Stars
366
Forks
32
Bundled files
Instructions only
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by kazukinagata on GitHub. Read the source before you install it.

Installation

Install the E Bookkeeping Compliance AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/kazukinagata/shinkoku/tree/main/skills/e-bookkeeping-compliance
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/kazukinagata/shinkoku.git /tmp/shinkoku
mkdir -p .claude/skills
cp -r /tmp/shinkoku/skills/e-bookkeeping-compliance .claude/skills/e-bookkeeping-compliance
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable E Bookkeeping Compliance in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads E Bookkeeping Compliance on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so E Bookkeeping Compliance is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

優良な電子帳簿コンプライアンス診断

税務調査への備え、または優良な電子帳簿の要件充足状況を診断するスキル。 電子帳簿保存法施行規則第5条第5項(優良な電子帳簿の要件)に基づき、 shinkoku の帳簿データが要件を満たしているかを自動チェックする。

前提知識

  • 電帳法の要件詳細: /tax-ebookkeeping-context を実行する
  • システム概要書: docs/system-overview.md

Step 0: 前提確認

ユーザーに以下を確認する:

  1. DB パス: --db-path に使用するデータベースファイルのパス
  2. 対象年度: --fiscal-year に使用する会計年度
  3. 届出書の提出状況: 「国税関係帳簿の電磁的記録等による保存等に係る届出書」を所轄税務署に提出済みか

届出について: 優良な電子帳簿の保存を適用するには、あらかじめ届出書の提出が必要です。 令和9年分から適用する場合は、令和8年中に届出書を提出する必要があります。 届出書の様式は国税庁ウェブサイトからダウンロードできます。


Step 1: 自動診断 & サマリー出力

以下のコマンドを実行してシステムの適合状況を診断する。 結果はテーブル形式でユーザーに提示する。

チェック項目と実行コマンド

#要件条文チェック方法
G1システム関係書類の備付け施行規則2条2項1号docs/system-overview.md ファイルの存在を確認
G2見読可能性の確保施行規則2条2項2号shinkoku ledger trial-balance --db-path <db> --fiscal-year <year> を実行し、正常出力を確認
G3ダウンロード対応施行規則2条2項3号shinkoku ledger search --db-path <db> --input <params> --format csv を実行し、CSV出力を確認
G4訂正・削除履歴施行規則5条5項1号イshinkoku ledger audit-log --db-path <db> を実行し、テーブルが機能することを確認
G5相互関連性の確保施行規則5条5項1号ロshinkoku ledger general-ledger --db-path <db> --fiscal-year <year> --account-code <code> を実行し、仕訳帳⇔総勘定元帳の関連を確認
G6取引先検索施行規則5条5項1号ハcounterparty_contains パラメータで検索を実行
G7日付・金額の範囲指定検索施行規則5条5項1号ハdate_from/date_to/amount_min/amount_max パラメータで検索を実行
G8組合せ検索施行規則5条5項1号ハ日付+取引先+金額を組み合わせた検索を実行

診断手順

  1. G1: docs/system-overview.md の存在を確認する
  2. G2: 残高試算表を生成する
    bash
    shinkoku ledger trial-balance --db-path <db> --fiscal-year <year>
  3. G3: 仕訳をCSV形式で出力する
    bash
    shinkoku ledger search --db-path <db> --input <params> --format csv
    (params には {"fiscal_year": <year>, "limit": 5} を指定)
  4. G4: 監査ログを取得する
    bash
    shinkoku ledger audit-log --db-path <db>
  5. G5: 任意の勘定科目で総勘定元帳を出力する(仕訳が存在する科目を使用)
    bash
    shinkoku ledger general-ledger --db-path <db> --fiscal-year <year> --account-code <code>
  6. G6-G8: 検索機能のテスト
    bash
    # G6: 取引先検索
    shinkoku ledger search --db-path <db> --input <params>
    # params: {"fiscal_year": <year>, "counterparty_contains": "<取引先名の一部>"}
    
    # G7: 範囲指定検索
    # params: {"fiscal_year": <year>, "date_from": "<開始日>", "date_to": "<終了日>", "amount_min": 1, "amount_max": 1000000}
    
    # G8: 組合せ検索
    # params: {"fiscal_year": <year>, "date_from": "...", "counterparty_contains": "...", "amount_min": 1}

サマリー出力形式

診断結果を以下のテーブル形式で出力する:

## 優良な電子帳簿 コンプライアンス診断結果

| # | 要件 | 条文 | 結果 | 備考 |
|---|------|------|------|------|
| G1 | システム関係書類 | 施行規則2条2項1号 | ✓ / ✗ | ... |
| G2 | 見読可能性 | 施行規則2条2項2号 | ✓ / ✗ | ... |
| G3 | ダウンロード対応 | 施行規則2条2項3号 | ✓ / ✗ | ... |
| G4 | 訂正・削除履歴 | 施行規則5条5項1号イ | ✓ / ✗ | ... |
| G5 | 相互関連性 | 施行規則5条5項1号ロ | ✓ / ✗ | ... |
| G6 | 取引先検索 | 施行規則5条5項1号ハ | ✓ / ✗ | ... |
| G7 | 範囲指定検索 | 施行規則5条5項1号ハ | ✓ / ✗ | ... |
| G8 | 組合せ検索 | 施行規則5条5項1号ハ | ✓ / ✗ | ... |

不適合項目がある場合は、対応方法を案内する。


Step 2: エビデンス出力(任意)

ユーザーが「詳細を確認」「エビデンスを出力」と依頼した場合に実行する。

(a) 帳簿出力

以下のコマンドで各帳簿を出力し、テーブル形式でユーザーに提示する:

bash
# 残高試算表
shinkoku ledger trial-balance --db-path <db> --fiscal-year <year>

# 損益計算書
shinkoku ledger pl --db-path <db> --fiscal-year <year>

# 貸借対照表
shinkoku ledger bs --db-path <db> --fiscal-year <year>

# 総勘定元帳(主要科目)
shinkoku ledger general-ledger --db-path <db> --fiscal-year <year> --account-code <code>

CSV出力も可能であることを案内:

bash
# CSV 形式で出力する場合は --format csv を追加
shinkoku ledger trial-balance --db-path <db> --fiscal-year <year> --format csv

(b) 監査ログ

bash
shinkoku ledger audit-log --db-path <db> --fiscal-year <year>

変更履歴をテーブル形式で表示する。

(c) 検索デモ

日付範囲・金額範囲・取引先の各検索を実演し、検索機能が正常に動作することを確認する。

(d) システム関係書類

docs/system-overview.md の場所を案内する。必要に応じて内容を表示する。


Step 3: 結果サマリー & 次のアクション

全要件充足の場合

## 診断結果: 全要件適合

shinkoku は優良な電子帳簿の要件(施行規則第5条第5項)を
技術的に充足しています。

### 次のアクション
1. 届出書の提出(未提出の場合)
   - 「国税関係帳簿の電磁的記録等による保存等に係る届出書」を所轄税務署に提出
2. 定期的なバックアップの実施
3. 帳簿データの7年間保存の確保

不足事項がある場合

不足事項と対応アクションを一覧で表示する。

免責事項

> **注記**: 本システムは電子帳簿保存法施行規則第5条第5項に定める優良な電子帳簿の
> 技術的要件を満たすよう設計されています。令和3年度税制改正により事前承認制度は
> 廃止されており、JIIMA認証等の第三者認証は法令上の要件ではありません
> (ただし要件充足の確認手段として活用できます)。
> 優良な電子帳簿の保存の適用にあたっては、あらかじめ所轄税務署への届出書の
> 提出が必要です(電子帳簿保存法第8条第4項)。

制限事項

> **制限事項**:
> - 監査ログ(journal_audit_log)はアプリケーション層で記録しており、
>   データベースの直接操作による変更は記録されません。
>   改ざん防止のためのデータベーストリガーは今後の対応予定です。
> - タイムスタンプは UTC で記録されています(JST への変換は今後対応予定)。
> - 操作者情報の記録は個人利用を前提としているため、現在は未実装です。

Frequently asked questions

What does the E Bookkeeping Compliance AI skill do?

優良な電子帳簿の要件チェック・コンプライアンス診断を実行する。 「優良な電子帳簿」「電帳法対応」「電子帳簿の要件確認」 「税務調査の準備」「75万円控除の条件」「帳簿の要件を満たしているか」 「e-bookkeeping compliance」で起動。

Why use E Bookkeeping Compliance on TypingMind?

Because you install it once and use it with any model. E Bookkeeping Compliance is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install E Bookkeeping Compliance in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/kazukinagata/shinkoku/tree/main/skills/e-bookkeeping-compliance. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use E Bookkeeping Compliance?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with E Bookkeeping Compliance?

As many as you like. As long as a model supports skills, you can use E Bookkeeping Compliance with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the E Bookkeeping Compliance AI skill free?

Yes. It is published on GitHub by kazukinagata under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇