financial-services贡献指南从Fork到PR的完整流程与注意事项【免费下载链接】financial-services项目地址: https://gitcode.com/GitHub_Trending/fi/financial-servicesfinancial-services是面向金融行业的Claude Agent 插件与技能Skills参考仓库涵盖投行、股权研究、私募股权、财富管理等垂直场景的 Agent 模板。它完全由Markdown YAML 文件构成没有构建步骤这让贡献门槛非常低——会写文档就能提交。本指南带你走通从 Fork、本地修改、自动校验到提交 PR 的完整贡献流程并总结 5 个最容易踩的坑。项目速览你可以贡献什么在动手之前先花两分钟了解仓库布局详见 README.md 与 CLAUDE.mdplugins/ agent-plugins/ # 命名 Agent —— 每个都是一个自包含插件 vertical-plugins/ # 各垂直领域的 Skills / 斜杠命令 / MCP 连接器技能源头 partner-built/ # 合作伙伴插件LSEG、SP Global managed-agent-cookbooks/ # Managed Agent 部署模板 —— 每个 Agent 一个目录 scripts/ # 校验与部署脚本check.py、sync-agent-skills.py 等核心设计技能在vertical-plugins/中只写一次source of truth各 Agent 插件里的是同步而来的捆绑副本。理解这一点是贡献顺利的关键。第一步Fork 仓库并克隆到本地在代码托管平台上 Fork 本仓库到你自己的账号下克隆你的 Fork 到本地git clone https://gitcode.com/GitHub_Trending/fi/financial-services准备本地环境Python 3 pyyaml校验脚本依赖pip install pyyaml 仓库是纯文件型的无需 Node、无需构建、无需启动服务改完即生效。第二步选对贡献路径——三类改动放哪里路径 A新增或修改一个 Skill最常用Skill 是 Agent 调用的领域知识统一放在垂直插件下plugins/vertical-plugins/vertical/skills/skill-name/SKILL.md以 comps-analysis 为例SKILL.md需要 YAML frontmatter包含name和description两个必填字段--- name: comps-analysis description: 构建机构级可比公司分析…… ---⚠️ 如果你在vertical-plugins/中修改了某个 Skill必须运行同步脚本把它传播到所有捆绑了该技能的 Agent 副本中python3 scripts/sync-agent-skills.py该脚本的逻辑非常直白扫描所有agent-plugins/*/skills/*捆绑目录从垂直插件源头整目录复制见 sync-agent-skills.py。路径 B新增一个命名 Agent新 Agent 需要在两处同时落地保持一份源头、两种部署方式Cowork 插件 Managed Agent位置内容plugins/agent-plugins/slug/.claude-plugin/plugin.json含 name/version/descriptionagents/slug.md系统提示词需 frontmatterskills/managed-agent-cookbooks/slug/agent.yamlsubagents/*.yamlsteering-examples.jsonREADME.md可参考 gl-reconciler 的 agent.yamlsystem.file指回插件中的系统提示词skills通过from_plugin引用 Agent 插件目录callable_agents列出叶子子代理清单。路径 C修改命令或 MCP 连接器斜杠命令/comps、/dcf等放在plugins/vertical-plugins/vertical/commands/MCP 连接器集中在 core 插件 financial-analysis 中维护。第三步本地校验——提交前必跑 check.py这是整个贡献流程中最重要的一环。推送前必须运行python3 scripts/check.pycheck.py 会一次性完成 6 项检查全部通过才允许提交YAML 可解析—— 所有managed-agent-cookbooks/下的*.yamlJSON 可解析—— 所有plugin.json/marketplace.json/steering-examples.jsonfrontmatter 合法—— 每个agents/*.md必须有namedescription交叉引用可解析——system.file、skills.path、callable_agents.manifest指向的文件必须存在捆绑 Skill 与垂直源头不能漂移driftedManaged Agent 必备文件—— 每个 cookbook 目录必须含agent.yaml、README.md、steering-examples.jsonPowerShell 纯 ASCII—— 无 BOM 的.ps1文件禁止非 ASCII 字符Windows PowerShell 5.1 会乱码解析失败如果涉及 Managed Agent 部署还可以跑一次 test-cookbooks.sh 对所有 cookbook 做 dry-run 验证。第四步提交并发起 PR版本号的秘密不用你手动改你可能会注意到插件清单里有version字段例如{ name: gl-reconciler, version: 0.1.0, ... }好消息是——版本号由 pre-commit 钩子自动处理。首次运行check.py时会自安装 git 钩子之后每次 commitversion_bump.py 会自动把有改动的插件的版本号在main基础上 1 个 patch 版本一条分支只 bump 一次幂等。CI 端还会做一次--check兜底确保没有遗漏。PR 提交建议分支名建议用feat/xxx、fix/xxx等清晰前缀PR 描述里写清改了什么、为什么改、是否已跑check.py一个小而聚焦的 PR 更容易被快速合并新增 Agent 这类大改动建议先在 issue 里讨论贡献注意事项5 个高频踩坑点#坑正确做法1直接改agent-plugins/里的捆绑 Skill 副本技能一律在vertical-plugins/源头修改再跑sync-agent-skills.py2忘记跑check.py导致引用悬空推送前必跑它是唯一且完整的本地门禁3在.ps1里写破折号—或弯引号用 ASCII--代替—或给文件加 UTF-8 BOM4手动乱改plugin.json的 version交给 pre-commit 钩子自动 bump别手动加5新 Agent 只建了插件目录漏了 cookbookagent-plugins/slug/与managed-agent-cookbooks/slug/必须成对出现另外两点提醒 本仓库采用Apache License 2.0见 LICENSE提交即视为同意内容不含投资/法律建议定位请勿混入投资建议性质的表述。 不要提交*.local.md用户配置文件它们已被 gitignore。总结financial-services的贡献流程可以浓缩为一句话在vertical-plugins/写源头 → 跑sync-agent-skills.py同步 → 跑check.py全量校验 → 提交 PR版本号自动 bump纯 Markdown 仓库 脚本化门禁是新手参与 AI Agent 开源项目的理想入口。挑一个你最熟悉的垂直场景比如你天天在用的估值建模或尽调清单从改一段 Skill 描述开始就是你的第一笔贡献。【免费下载链接】financial-services项目地址: https://gitcode.com/GitHub_Trending/fi/financial-services创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考