企业官网建设流程全解析

Paperasse 贡献指南：5步为 AI Agent 新增一个「职业」Skill（附突尼斯、比利时 Fork 实例）

【免费下载链接】paperasse🇫🇷 Skills pour agents IA spécialisés dans la bureaucratie française : Comptable, Notaire, ...项目地址: https://gitcode.com/gh_mirrors/pa/paperasse

Paperasse是一个开源项目，它为 AI Agent 提供一套专精法国行政官僚事务的「Skill」技能包——会计师、公证人、税务稽查员等每个职业都对应一个独立目录。本文将带你通过 5 个简单步骤，为 AI Agent 新增一个「职业」Skill，并附上突尼斯、比利时两个社区 Fork 实例，帮你快速上手贡献。

第1步：Fork 仓库并规划你的「职业」

开始贡献前，先想清楚一个问题：你要自动化的职业，是否是一个真实存在的岗位？

这是 Paperasse 的核心设计原则——"skill = 职业，而非工具"。判断标准很简单：一个普通人会不会戴着这顶"帽子"出现在求职市场上？会，就值得做成 Skill；否则它应该只是一个共享模块。

操作很简单：

1. 克隆仓库到本地：git clone https://gitcode.com/gh_mirrors/pa/paperasse
2. Fork 仓库并创建自己的分支
3. 在根目录下新建一个法语、小写、带连字符的职业目录，比如avocat（律师）或drh（人力资源总监）

项目现有 6 个职业 Skill 可以作为参考：

第2步：编写 SKILL.md 核心文件

每个 Skill 的灵魂是一个 SKILL.md 文件，它告诉 AI Agent「你是谁、该怎么做」。

文件顶部需要一个 YAML frontmatter，包含 4 个关键字段：

• name：技能显示名称
• description：一行描述 + 触发词列表（让 Agent 知道何时激活该技能）
• last_updated：最后更新日期（超过 6 个月，Agent 会主动提示数据可能过期）
• includes：需要包含的共享资源路径

一个最小示例：

--- name: avocat description: 商事律师，负责合同起草与公司法务 metadata: last_updated: 2026-06-01 ---

写正文时，参考现有技能的风格：明确前置条件（如先读取公司信息）、给出决策流程、附上禁止事项（例如"不确定的法律条文绝不编造"，这是 notaire/SKILL.md 的第一条铁律）。

第3步：搭建 references/ 参考资料

Agent 的智能来自资料，而非模型本身。在你的职业目录下建一个references/文件夹，放入：

• 相关法条、税率的 Markdown 文档
• 参考 references 的命名方式，如succession.md（继承）、tarifs-emoluments.md（收费标准）

如果还需要结构化数据（税率表、部门代码等），放入data/目录；需要生成文档模板则放入templates/，例如 notaire/templates/testament-olographe.md。

💡小技巧：共享资源通过符号链接复用。例如 comptable/ 目录下的data、scripts实际都指向仓库根目录，避免代码重复——你可以参考 CONTRIBUTING.md 中的 "symlink 共享" 章节。

第4步：添加 evals/ 自动化测试

这是区分"玩具技能"和"专业技能"的关键一步。在evals/目录下创建一个evals.json，为每个测试场景定义三要素：

• prompt：模拟真实用户提问
• expected_output：期望的回答要点
• assertions：逐条可验证的断言

以 notaire/evals/evals.json 为例，一个测试场景问"购买 28 万欧元老房子，公证费多少？"，断言则要求：按省份税率算 DMTO、逐档计算公证人报酬、加上 20% 增值税……精确到每一步。

写好后运行测试（需安装 uv）：

uv run --project evals python evals/run_evals.py --skill notaire

完整的评估框架位于 evals/run_evals.py，支持缓存与增量运行，提交前务必跑绿。

第5步：提交 PR，并看看社区 Fork 实例

测试通过后，提交 PR 等待维护者审阅。贡献即自动采用 MIT 许可证。

如果你的目标不是法国本土，而是把 Paperasse 适配到其他国家的行政体系，社区已有两个优秀 Fork 实例可以参考：

• 🇹🇳paperasse-tn（突尼斯）：包含 3 个本地化 Skill——mo7aseb（会计）、bct-shield（外汇管制）、3adel-ichhad（税务申报），覆盖突尼斯的 IRPP 个税、BCT 外汇、SUARL 公司形式
• 🇧🇪paperasse-be（比利时）：16 个适配比利时法律的 Skill，支持法/荷/德/英四语，每个 Skill 附 FR/BE 对照表，由社区团队 Atelya 维护

这两个 Fork 证明了 Paperasse 的架构足够灵活：目录即职业、文件即知识、测试即保障。

贡献清单速查

📚 更多细节请查阅官方贡献指南 CONTRIBUTING.md 和项目文档 docs/manual-install.md。记住 Paperasse 的幽默座右铭：总得有人去做这件事，而那个人不需要咖啡休息。现在，轮到你了。

【免费下载链接】paperasse🇫🇷 Skills pour agents IA spécialisés dans la bureaucratie française : Comptable, Notaire, ...项目地址: https://gitcode.com/gh_mirrors/pa/paperasse