Back to Details

steuer-init

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Steuer-Archiv initialisieren

初始化税务归档

Overview

概览

Dieser Skill ist der Einstiegspunkt der Steuer-Suite und enthält bewusst kaum eigene Logik. Seine Aufgabe ist die Reihenfolge: Erst muss feststehen, wer der Nutzer steuerlich ist (
SOUL.md
), daraus folgt, welche Anlagen er braucht (Ordnerstruktur), und erst dann kann irgendetwas einsortiert werden. Wer die Reihenfolge umdreht, sortiert Dokumente in Ordner, die es nicht geben dürfte.
Die inhaltliche Arbeit machen die aufgerufenen Skills. Was hier steht, ist der Ablauf und die Konvention, die alle anderen später wiederfinden müssen.
Kein Steuerberater-Ersatz. Die Suite bereitet Unterlagen vor und rechnet Summen zusammen. Sie ersetzt keine steuerliche Beratung.
此 Skill 是税务套件的入口，并且有意几乎不包含自身的逻辑。它负责确定执行顺序：首先必须明确用户的税务档案情况（
SOUL.md
），由此确定用户需要哪些税务附表（文件夹结构），只有到这一步之后才能归类任何文档。如果颠倒顺序，就会把文档归入本不应存在的文件夹。
实际内容工作由调用的 Skills 完成。这里定义的是执行流程和约定，其他 Skills 后续都必须遵循。
不能替代税务顾问。 该套件用于整理资料并汇总金额，但不提供税务咨询。

Vorher prüfen: gibt es das Archiv schon?

开始前检查：归档是否已经存在？

  • CLAUDE.md
    oder 
    SOUL.md
    im Zielordner vorhanden     → das Archiv ist bereits initialisiert. Nicht neu aufsetzen und nichts überschreiben. Stattdessen fragen, was eigentlich gebraucht wird, und direkt an den richtigen Skill übergeben: neues Steuerjahr → 
    steuer-struktur-anlegen
    , geänderte Lebensumstände → 
    steuer-soul-pflegen
    , lose Dokumente → 
    steuer-dokument-einsortieren
    .
  • Ordner enthält bereits Dokumente in einer eigenen Struktur → diese Struktur lesen und in der 
    CLAUDE.md
    dokumentieren, statt sie stillschweigend umzubauen. Ein Umbau bestehender Ablagen ist eine eigene Entscheidung des Users, kein Nebeneffekt von 
    steuer-init
    .
  • 目标文件夹中已存在 
    CLAUDE.md
    或 
    SOUL.md
     → 归档已经初始化。不要重新设置或覆盖任何内容。相反，应询问用户实际需要什么，并直接移交给合适的 Skill：新的税务年度 → 
    steuer-struktur-anlegen
    ；个人情况发生变化 → 
    steuer-soul-pflegen
    ；零散文档 → 
    steuer-dokument-einsortieren
    。
  • 文件夹中的文档已按自有结构存放 → 应读取该结构并将其记录在 
    CLAUDE.md
    中，而不是悄悄重构。重构现有存储结构应由用户单独决定，不能作为 
    steuer-init
    的附带操作。

Workflow

工作流

  1. Archiv-Root und Steuerjahr klären. Wo liegt das Archiv, für welches Jahr wird erklärt? Nicht ableitbar → fragen. Nicht das aktuelle Kalenderjahr annehmen; Erklärungen werden fast immer rückwirkend gemacht.
  2. CLAUDE.md
    im Archiv-Root schreiben     (Template unten). Sie ist der Träger der Konvention: Alle anderen Skills lesen sie, bevor sie Ordner- oder Namensentscheidungen treffen. Ohne sie fallen sie auf Vermutungen zurück.
  3. steuer-soul-pflegen
    aufrufen     → 
    SOUL.md
    . Der Skill grillt den User zu seinen Lebensumständen (eine Frage nach der anderen) und leitet ab, was sich aus schon vorhandenen Dokumenten ablesen lässt. Hier wird nicht abgekürzt — jede Lücke in 
    SOUL.md
    wird später zu einer fehlenden Anlage.
  4. steuer-struktur-anlegen
    aufrufen     → 
    <Jahr>/00_Quellen/
    , 
    <Jahr>/NN_Anlage_*/
    je Anlage, 
    <Jahr>/99_Privat/
    , 
    raw/
    .
  5. steuer-index-aktualisieren
    aufrufen     → 
    INDEX.md
    über das ganze Archiv.
  6. Abschlussbericht: Welche Anlagen wurden angelegt und warum (welcher Fakt aus 
    SOUL.md
    hat sie ausgelöst), welche bewusst nicht. Danach der nächste Schritt für den User: Unterlagen nach 
    raw/
    legen und 
    steuer-dokument-einsortieren
    laufen lassen.
  1. 明确归档根目录和税务年度。 归档位于哪里？申报的是哪个年度？无法推断 → 询问。不要假定为当前日历年；税务申报几乎总是追溯进行的。
  2. 在归档根目录写入 
    CLAUDE.md
    （见下方模板）。它是约定的载体：所有其他 Skills 都会在作出文件夹或命名决策前读取它。没有该文件，它们就只能依赖猜测。
  3. 调用 
    steuer-soul-pflegen
     → 
    SOUL.md
    。该 Skill 会就用户的生活情况逐一追问（每次只问一个问题），并推断现有文档中可以读取的信息。这里绝不能省略——
    SOUL.md
    中的每一处缺口，之后都会变成一项缺失的税务附表。
  4. 调用 
    steuer-struktur-anlegen
     → 
    <Jahr>/00_Quellen/
    、每个税务附表对应的 
    <Jahr>/NN_Anlage_*/
    、
    <Jahr>/99_Privat/
    、
    raw/
    。
  5. 调用 
    steuer-index-aktualisieren
     → 为整个归档更新 
    INDEX.md
    。
  6. 完成报告： 创建了哪些税务附表及其原因（由 
    SOUL.md
    中的哪项事实触发），以及有意未创建哪些。随后告知用户下一步：将资料放入 
    raw/
    ，并运行 
    steuer-dokument-einsortieren
    。

CLAUDE.md
-Template für das Archiv

适用于归档的 
CLAUDE.md
模板

Beim Schreiben an das konkrete Archiv anpassen (Jahre, tatsächlich angelegte Anlagen), aber die Regeln inhaltlich beibehalten — die anderen Skills verlassen sich darauf.
markdown
undefined
写入具体归档时需根据实际情况调整（年份、实际创建的税务附表），但应保留规则的实质内容——其他 Skills 依赖这些规则。
markdown
undefined

Steuer-Dokumentenarchiv

税务文档归档

Gepflegt mit der 
steuer-*
-Skill-Suite. Diese Datei ist die verbindliche Konvention des Archivs; die Skills lesen sie, bevor sie Ordner- oder Namensentscheidungen treffen.
由 
steuer-*
Skill 套件维护。本文件是归档的强制性约定；Skills 会在作出文件夹或命名决策前读取本文件。

Struktur

结构

<Archiv>/
├── CLAUDE.md      # diese Datei
├── SOUL.md        # steuerliches Personenprofil, jahresübergreifend
├── INDEX.md       # Struktur-Index über das ganze Archiv
├── raw/           # Eingang für neue Dokumente, jahresübergreifend
└── <Jahr>/
    ├── 00_Quellen/<Institution>/     # Rohquellen + Dokumente mit Mehrfachbezug
    ├── NN_Anlage_*/                  # je Steuer-Anlage
    │   ├── _UEBERSICHT.md            # Summen mit Belegverweis
    │   └── <Institution>/            # Belege dieser Anlage, nach Absender
    └── 99_Privat/                    # steuerlich irrelevant, wird nie summiert
<Archiv>/
├── CLAUDE.md      # 本文件
├── SOUL.md        # 跨年度的用户税务档案
├── INDEX.md       # 整个归档的结构索引
├── raw/           # 跨年度的新文档入口
└── <Jahr>/
    ├── 00_Quellen/<Institution>/     # 原始来源 + 涉及多个附表的文档
    ├── NN_Anlage_*/                  # 每个税务附表
    │   ├── _UEBERSICHT.md            # 包含凭证引用的金额汇总
    │   └── <Institution>/            # 该附表的凭证，按发送方分类
    └── 99_Privat/                    # 与税务无关，永不汇总

Regeln

规则

  1. Vom Agenten gepflegte Dateien sind GROSS geschrieben (
    CLAUDE.md
    , 
    SOUL.md
    , 
    INDEX.md
    , 
    _UEBERSICHT.md
    ) und dadurch von den eigentlichen Dokumenten unterscheidbar. Umlaute darin als 
    UE
    /
    OE
    /
    AE
    (Cloud-Sync).
  2. Dokumente heißen 
    Datum_Absender_Betreff.pdf
     (
    2025-01-31_GEOMAR_ Lohnsteuerbescheinigung.pdf
    ). Umlaute bleiben erhalten, Leerzeichen im Betreff werden zu Bindestrichen. Volles Datum 
    YYYY-MM-DD
    , bei Sammeldokumenten ohne einheitliches Tagesdatum nur 
    YYYY
    .
  3. Ablageort nach Anlagenbezug:
    • Bezug zu genau einer Anlage → 
      <Jahr>/NN_Anlage_X/<Institution>/
    • Bezug zu mehreren Anlagen oder Rohquelle (Kontoauszug, PayPal-Export) → 
      <Jahr>/00_Quellen/<Institution>/
      . Die 
      _UEBERSICHT.md
      der betroffenen Anlagen verweist per relativem Pfad darauf. Nie duplizieren.
    • Steuerlich irrelevant → 
      <Jahr>/99_Privat/
  4. Maßgeblich für das Jahr ist das Leistungs-/Bezugsjahr, nicht das Ausstellungsdatum. Eine Bescheinigung vom Januar 2026 über das Jahr 2025 gehört nach 
    2025/
    .
  5. Anlagen-Nummern sind fix, nicht fortlaufend. Lücken (
    10_
    , 
    30_
    , 
    99_
    ) sind gewollt: Anlage N heißt in jedem Jahr 
    10_Anlage_N
    . Die kanonische Nummernvergabe steht in der 
    REFERENCE.md
    von 
    steuer-struktur-anlegen
    .
  6. Jede Struktur-Änderung schlägt sich im selben Arbeitsschritt in 
    INDEX.md
    nieder     (via 
    steuer-index-aktualisieren
    ), sonst driftet die Übersicht.
  7. Jede Zahl in einer 
    _UEBERSICHT.md
    trägt ihren Beleg     (Datei + Seite). Nicht sicher Lesbares wird 
    OFFEN
    — nie geschätzt.
  8. Keine sensiblen Identifikatoren (Steuer-ID, IBAN, Geburtsdatum, RV-Nummer) in 
    SOUL.md
    , 
    INDEX.md
    oder 
    _UEBERSICHT.md
    übernehmen. Sie stehen in den Quelldokumenten und müssen nicht dupliziert werden.
  1. 由 Agent 维护的文件采用大写名称（
    CLAUDE.md
    、 
    SOUL.md
    、
    INDEX.md
    、
    _UEBERSICHT.md
    ），因此可与实际文档区分。其中的德语变音字符写作 
    UE
    /
    OE
    /
    AE
    （云同步）。
  2. 文档命名为 
    Datum_Absender_Betreff.pdf
    （
    2025-01-31_GEOMAR_Lohnsteuerbescheinigung.pdf
    ）。主题中的空格替换为连字符。完整日期采用 
    YYYY-MM-DD
    ；对于没有统一日期的汇总文档，仅使用 
    YYYY
    。
  3. 按税务附表关联关系确定存放位置：
    • 仅关联一个税务附表 → 
      <Jahr>/NN_Anlage_X/<Institution>/
    • 关联多个税务附表或属于原始来源（银行对账单、PayPal 导出） → 
      <Jahr>/00_Quellen/<Institution>/
      。相关税务附表的 
      _UEBERSICHT.md
      通过相对路径指向该文件。绝不复制。
    • 与税务无关 → 
      <Jahr>/99_Privat/
  4. 归档年份应以收入/关联年度为准，而不是出具日期。 2026 年 1 月出具、但涉及 2025 年的证明应归入 
    2025/
    。
  5. 税务附表编号是固定的，不采用连续编号。 编号空缺（
    10_
    、
    30_
    、
    99_
    ）是刻意保留的：附表 N 在每个年度中都命名为 
    10_Anlage_N
    。规范编号分配方式见 
    steuer-struktur-anlegen
    的 
    REFERENCE.md
    。
  6. 每次结构变更都必须在同一工作步骤中通过 
    steuer-index-aktualisieren
    同步到 
    INDEX.md
    ，否则总览会逐渐失准。
  7. _UEBERSICHT.md
    中的每个数字都必须附有凭证来源    （文件 + 页码）。无法确定读取的内容标记为 
    OFFEN
    ——绝不估算。
  8. 不得将敏感标识符（税号、IBAN、出生日期、RV-Nummer）写入 
    SOUL.md
    、
    INDEX.md
    或 
    _UEBERSICHT.md
    。这些信息保留在源文档中，无需复制。

Workflow

工作流

SituationSkill
Neue Unterlagen liegen in 
raw/
steuer-dokument-einsortieren
Kontoauszug/PayPal-Export einordnen
steuer-transaktionen-kategorisieren
Neues Steuerjahr beginnt
steuer-struktur-anlegen
Lebensumstände haben sich geändert
steuer-soul-pflegen
Summen sollen neu gezogen werden
steuer-uebersicht
undefined
情况Skill
raw/
中有新资料
steuer-dokument-einsortieren
整理银行对账单/PayPal 导出
steuer-transaktionen-kategorisieren
新税务年度开始
steuer-struktur-anlegen
个人情况发生变化
steuer-soul-pflegen
需要重新汇总金额
steuer-uebersicht
undefined

Anti-Patterns

反模式

  • NICHT ein bereits initialisiertes Archiv neu aufsetzen oder eine bestehende 
    CLAUDE.md
    /
    SOUL.md
    überschreiben — prüfen, dann an den passenden Skill übergeben.
  • NICHT eine bestehende, gewachsene Ablage stillschweigend auf die Anlagen-Struktur umbauen. Erst fragen.
  • NICHT die Reihenfolge drehen. Ohne 
    SOUL.md
    keine Struktur, ohne Struktur kein Einsortieren.
  • NICHT die Grill-Fragen zu den Lebensumständen selbst stellen — das ist 
    steuer-soul-pflegen
    . Zwei Stellen mit Grill-Logik driften auseinander.
  • NICHT Dokumente einsortieren. 
    steuer-init
    bereitet nur das leere Archiv vor; das Einsortieren ist ein eigener, expliziter Schritt.
  • NICHT das Steuerjahr raten.
  • 不要重新初始化已经初始化的归档，也不要覆盖现有的 
    CLAUDE.md
    /
    SOUL.md
    ——先检查，再移交给合适的 Skill。
  • 不要悄悄将现有且不断扩展的存储结构重构为税务附表结构。应先询问。
  • 不要颠倒顺序。没有 
    SOUL.md
    就没有结构，没有结构就无法归类文档。
  • 不要自行询问用户的生活情况——这属于 
    steuer-soul-pflegen
    的职责。两处分别实现追问逻辑会发生偏差。
  • 不要归类文档。
    steuer-init
    只准备空白归档；归类文档是单独且明确的步骤。
  • 不要猜测税务年度。