romainsimon/paperasse
GitHub: romainsimon/paperasse
为 AI 编程助手提供法国财税、会计、审计、公证等专业行政 skills 的开源集合,让 AI 能够熟练处理法国官僚体系的各类文书工作。
Stars: 1559 | Forks: 90
Paperasse
为专注于法国行政和税务体系的 AI 代理提供的 skills。
因为总得有人做这件事,而且这个人还不需要喝咖啡休息。
## Paperasse 是什么? Paperasse 是一个为专注于法国企业的会计、税务、发票开具、公证和审计的 AI 代理([Claude Code](https://claude.com/product/claude-code)、[Claude Cowork](https://claude.com/product/cowork)、[Codex](https://openai.com/codex/)、[Mistral Vibe](https://vibe.mistral.ai)、[Cursor](https://cursor.com)、[Windsurf](https://windsurf.com)、[Cline](https://cline.bot)、[Aider](https://aider.chat))打造的 skills 集合。 每个 skill 都能将您的代理变成熟悉文书工作的专业副驾驶:会计(PCG、TVA、IS、年终结账、FEC、税务申报表)、发票开具(强制要素、2026 电子发票、认证平台、e-reporting)、税务稽查、CAC 审计、个人税务(IR、IFI、PFU、PEA、AV、LMNP、RSU、BSPCE、crypto、PER)、公证法(房地产、继承、赠与)和物业管理(AG、费用、工程、欠款)。它熟悉相关法规(CGI、BOFiP、NEP、1965 年法律)、表格、截止日期,并且不会在税务申报表中填错格子。 这些 skills 都是 Markdown 格式。它们可与任何能够读取文件的代理或工具配合使用。Paperasse 还包含连接器,可自动获取您的银行交易(Qonto)和付款(Stripe)记录。 ## 快速安装 ### 选项 1:通过 agentskill.sh 安装(推荐) 从 [agentskill.sh](https://agentskill.sh/skillsets/paperasse) 注册表安装 skills。 无需克隆代码库,并可通过 [ags](https://github.com/agentskill-sh/ags) 保持所有 skills 自动更新,同时包含安全扫描、skills 自动审查等功能。 将以下指令复制并粘贴到您的 AI 代理中: ``` Suis les instructions pour installer le skillset Paperasse depuis https://agentskill.sh/skillsets/paperasse Lance ensuite le setup pour la gestion de toute ma paperasse ``` ### 选项 2:通过 GitHub 安装 将以下指令复制并粘贴到您的 AI 代理中: ``` Installe tous les skills du repo github https://github.com/romainsimon/paperasse Lance ensuite le setup pour la gestion de toute ma paperasse ``` 代理将克隆代码库,安装 skills,并启动引导式设置,向您提出一些问题(公司名称、TVA 税制、银行账户)以配置您的环境。 ## 6 个 skills | Skill | 角色 | 功能 | |-------|------|------| | **`comptable`** | 专家会计师 | 会计分录(800+ PCG 账户)、TVA、IS/IR、完整的 12 步年终结账、FEC、税务申报表、PDFs、银行对账、发票开具(强制要素、2026 电子发票、认证平台、Factur-X、e-reporting) | | **`controleur-fiscal`** | 税务稽查员 | 模拟 8 个维度的 DGFIP 税务稽查,附带法律依据和金额的补税理由 | | **`commissaire-aux-comptes`** | 审计师 | 7 个阶段的 NEP 审计,资产负债表/利润表/税务申报表交叉验证,有依据的审计意见 | | **`fiscaliste`** | 个人税务专家 | 个人税务:IR(税率、QF、折扣、上限)、IFI、PFU 与税率表对比、PEA、人寿保险、LMNP(micro/实际)、RSU/BSPCE/股票期权、crypto(PAMC)、PER、例外收入商数、CEHR | | **`notaire`** | 公证人 | 公证费、房地产资本利得、继承、赠与、SCI、PACS、诊断、财富管理建议 | | **`syndic`** | 物业管理者 | 物业组合管理:AG、资金催缴、会计(2005 年法令)、工程、供应商、欠款、物业管理者交接 | ## 使用示例 ``` > Voici mes transactions bancaires. Catégorise-les et génère les écritures. > Fais la clôture annuelle de ma société pour l'exercice 2025. > Simule un contrôle fiscal sur mes comptes 2025. > Audite mes comptes annuels avant approbation. > Calcule les frais de notaire pour un appartement à 350 000 EUR à Paris. > Ma mère est décédée, nous sommes 3 enfants. Calcule les droits de succession. > Rédige les statuts d'une SCI familiale pour gérer un immeuble locatif. > Prépare la convocation de l'AG annuelle pour ma copropriété. > Donne-moi un tableau de bord de toutes mes copropriétés. > Le copropriétaire du lot 7 n'a pas payé depuis 6 mois. Que faire ? > Génère une facture conforme pour mon client TechSolutions SAS. > Suis-je prêt pour la facturation électronique obligatoire 2026 ? > Quelle plateforme agréée gratuite me recommandes-tu ? > Je suis célibataire, salaire 50 000 EUR, calcule mon impôt 2025. > J'ai 5 000 EUR de dividendes. PFU ou barème ? > Vesting RSU 100 000 EUR cette année : puis-je utiliser le quotient pour revenus exceptionnels ? > Mon patrimoine immobilier net est de 1,4 M EUR, suis-je redevable de l'IFI ? ``` ## 工作流:从零到年终结账 您可以通过复制并粘贴以下 prompt 来启动完整的年终结账工作流: ``` Fais la clôture annuelle de ma société ``` 这 4 个 skills 相互衔接,覆盖整个会计周期: 1. **日常会计** (`comptable`):费用分类、会计分录、TVA、银行对账 2. **年终结账** (`comptable`):截账、折旧、减值准备、IS、FEC、税务申报表、PDFs 3. **审计** (`commissaire-aux-comptes`):验证 FEC,资产负债表/利润表/税务申报表交叉核对,审计意见 4. **税务稽查** (`controleur-fiscal`):在 8 个维度上模拟 DGFIP 稽查,补税理由 ## 集成 (Qonto, Stripe) 用于自动获取银行交易和付款的连接器。在 `company.json` 中配置,API 密钥作为环境变量。 ``` npm run fetch # Récupère Qonto + Stripe npm run fetch:qonto # Qonto seulement npm run fetch:stripe # Stripe seulement ``` 支持多个 Stripe 账户和 Stripe Connect。有关配置详情,请参见 `integrations/`。 ## 脚本和模板 代码库包含用于生成文档的 Node.js 脚本和模板: ``` npm run closing # Génère tout d'un coup (états financiers + FEC + PDFs) ``` | 脚本 / 模板 | 生成内容 | |-------------------|--------| | `calc.js` | 确定性计算(CCA、折旧、IS、简化 TVA、比例分配) | | `generate-statements.js` | 资产负债表、利润表、试算平衡表 | | `generate-fec.js` | 18 列 FEC(art. L. 47 A-I LPF) | | `generate-pdfs.js` | 附带公司页眉的专业 PDFs | | `templates/2065-sd.html` | 2065-SD 表格(IS 申报) | | `templates/liasse-fiscale-2033.md` | 2033 税务申报表(草稿) | | `templates/approbation-comptes.md` | 账目批准会议纪要 | | `templates/declaration-confidentialite.html` | 保密声明 | | `templates/depot-greffe-checklist.md` | 法院书记室提交清单 | 前置条件:`npm install`,然后执行 `cp company.example.json company.json` 并填写您的信息。 ## 安全防护 - **企业上下文**:每个 skill 在继续操作之前都会检查基本信息(公司名称、SIREN、法律形式、TVA 税制)。如果存在 `company.json`,它将被自动读取。否则,skill 会主动提问。 - **税务截止日期**:comptable skill 在每次对话中都会显示即将到来的截止日期(IS 预付款、TVA 等)。 - **数据新鲜度**:每个 skill 都有一个 `last_updated` 日期。如果超过 6 个月,代理会在回答之前在线核实数据。法国立法者修改规则的频率比您更改密码的频率还要高。与您的密码不同,这可能会让您付出高昂的代价。 - **开源数据**:完整的 PCG 和税务申报表命名规范来自 [data.gouv.fr](https://www.data.gouv.fr)。用于获取 BOFiP 和企业目录(Sirene)的公共 API。数据来源记录在 `data/sources.json` 中。 ## 手动安装(按平台) 这些 skills 是 Markdown 格式。只要代理能够读取文件,它们就能在任何平台上运行。 | 平台 | Skills 复制目标位置 | |------------|---------------------| | **Claude Code** | `~/.claude/skills/` | | **Cursor** | `~/.cursor/skills/` | | **Windsurf** | `~/.windsurf/skills/` | | **Codex** | `~/.codex/skills/` | | **Mistral Vibe** | `~/.vibe/skills/` | | **Cline** | `~/.cline/skills/` | | **Aider** | `~/.aider/skills/` | ## Evals 每个 skill 都会在使用和不使用 SKILL.md 的情况下进行自动评估,以衡量其附加价值。运行器在隔离环境中使用 `claude --bare`,采用 LLM-as-judge 进行评分,并行执行(完整套件约需 20 分钟),并使用基于内容的缓存,以便在迭代之间重复使用未更改的运行。 ``` # 运行 evals uv run --project evals python evals/run_evals.py # 单个 skill uv run --project evals python evals/run_evals.py --skill notaire # 重用跨迭代 cache uv run --project evals python evals/run_evals.py --reuse-cache # 仅运行受当前分支影响的 skills uv run --project evals python evals/run_evals.py --changed-only --reuse-cache # 在浏览器中查看结果 python evals/generate_review.py evals-workspace/iteration-xxx/ ``` 对于 PRs,一个 `Evals Smoke` 的 GitHub Actions 工作流会解析相对于基线分支受影响的 skills,还原 `evals-workspace/cache` 缓存,并仅执行必要的所选部分。 **最新结果** (claude-sonnet-4-6, haiku 评分) : | Skill | With Skill | Without Skill | Delta | |-------|-----------|--------------|-------| | commissaire-aux-comptes | 100% | 75% | **+25%** | | notaire | 96% | 92% | +4% | | controleur-fiscal | 91% | 87% | +4% | | comptable | 89% | 77% | **+12%** | | fiscaliste | 84% | 64% | **+20%** | | syndic | 83% | 68% | **+16%** | | **汇总** | **88%** | **75%** | **+13%** | `evals.json` 格式与 [anthropics/skills 官方框架](https://github.com/anthropics/skills/tree/main/skills/skill-creator) 兼容。 ## 法律声明 **这些 skills 不能替代在协会注册的专家会计师、经过认证的审计师或执业公证人。** 它们被设计为决策辅助和准备工具。 对于复杂情况(纠纷、税务筹划、正在进行中的税务稽查),请咨询拥有职业责任保险 (RC Pro) 和 SIRET 号码的专业人士。 ## 致谢 - **法国行政系统** — 因为它创造了一个如此复杂的系统,以至于需要 AI 才能理解 - **通用会计计划 (PCG)** — 真的需要 800 个账户吗? - **综合税收法典 (CGI)** — 2000 篇文章,而且每年都在增加 - **CNCC** — 感谢那些没人读但人人都引用的 NEP 文件 - **data.gouv.fr** — 感谢为 skills 提供数据的开放数据平台
文书工作就像胆固醇:有好有坏,但主要是太多了。
— 没有任何名人曾如此说过
在法国的某个地方,用 🥐 和大量的 ☕ 制作 | MIT 许可证
标签:AI应用, Claude, Copilot, Cursor, CVE检测, LLM, MITM代理, RAG, Skills, Unmanaged PE, 个人所得税, 会计, 公证, 区块链, 发票, 审计, 房产, 报税, 提示词模板, 智能助手, 暗色界面, 法务, 法国会计, 法国官僚体系, 法国法律, 电子发票, 税务审查, 网络调试, 自动化, 财务机器人, 财税, 财税合规, 逆向工具, 防御加固