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

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/paperassePaperasse是一个开源项目它为 AI Agent 提供一套专精法国行政官僚事务的「Skill」技能包——会计师、公证人、税务稽查员等每个职业都对应一个独立目录。本文将带你通过 5 个简单步骤为 AI Agent 新增一个「职业」Skill并附上突尼斯、比利时两个社区 Fork 实例帮你快速上手贡献。第1步Fork 仓库并规划你的「职业」开始贡献前先想清楚一个问题你要自动化的职业是否是一个真实存在的岗位这是 Paperasse 的核心设计原则——skill 职业而非工具。判断标准很简单一个普通人会不会戴着这顶帽子出现在求职市场上会就值得做成 Skill否则它应该只是一个共享模块。操作很简单克隆仓库到本地git clone https://gitcode.com/gh_mirrors/pa/paperasseFork 仓库并创建自己的分支在根目录下新建一个法语、小写、带连字符的职业目录比如avocat律师或drh人力资源总监项目现有 6 个职业 Skill 可以作为参考Skill 目录对应职业comptable/注册会计师notaire/公证人fiscaliste/个人税务顾问syndic/公寓业委管理师controleur-fiscal/税务稽查员commissaire-aux-comptes/审计师第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% 增值税……精确到每一步。写好后运行测试需安装 uvuv 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 的架构足够灵活目录即职业、文件即知识、测试即保障。贡献清单速查步骤关键文件说明1. Fork 规划根目录新文件夹法语小写职业名2. 编写技能SKILL.mdfrontmatter 工作流程3. 参考资料references/、data/法条、税率、模板4. 自动化测试evals/evals.json测试用例 断言5. 提交 PRCONTRIBUTING.md遵循贡献指南 更多细节请查阅官方贡献指南 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考