mcpField
R
research-finance

research-finance

github.com/alirezarezvani其他28.9k133 次安装2 天前更新
代码仓库

关于 research-finance

面向 R&D 财务伙伴、项目控制人员和运营负责人,管理已获资金支持的研发项目预算、消耗与会计处理路由。工具为每个金额附上假设,并将资本化判断交由指定财务负责人审核,不会自动入账。

主要功能

  1. 01多期预算及 F&A 分摊
  2. 02消耗与资金跑道跟踪
  3. 03里程碑与现金匹配评估
  4. 04IAS 38/ASC 730 处理路由
  5. 05金额附带假设和负责人

适用场景

  1. 01制定含间接费用拆分的研发预算
  2. 02评估现金能否支撑下一里程碑
  3. 03将研发支出提交财务负责人审核

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/alirezarezvani/claude-skills --skill research-finance

安装后在 Claude Code 中输入/research-finance确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/
rd_program_budget_template.md
references/
burn_and_portfolio.md
indirect_rate_modeling.md
rd_program_finance_canon.md
scripts/
ar_evaluator.py
burn_runway_tracker.py
capex_vs_opex_router.py
config_loader.py
onboard.py
program_budget_planner.py

详细介绍

research-finance

内部研发项目和项目组合的财务管理:包含项目预算编制及 F&A、消耗速度/资金可支撑周期跟踪,以及资本化与费用化的处理路由。每个数字都附带其假设区块;会计处理判断会转交给具名财务负责人——此技能绝不记账。

目的

研发财务合作伙伴、项目控制人员和运营负责人管理的是已经分配或筹集到的资金——不是公司结账,不是下一轮融资,也不是寻找资助。此技能将三项常见决策结构化:

三个确定性工具:

  1. program_budget_planner.py — 根据工作包明细构建多期预算,将 F&A(间接成本)费率应用于类似 MTDC 的合格基数,并按期间汇总直接成本、F&A 和全负荷成本,同时明确列出假设区块。
  2. burn_runway_tracker.py — 计算平均消耗速度和近期消耗速度、按期数/月数计算资金可支撑周期,并判断每个价值拐点里程碑能否在资金耗尽前达成。标记消耗速度加快和资金可支撑周期低于阈值的情况。
  3. capex_vs_opex_router.py — 根据 IAS 38 开发阶段标准对每项研发成本评分(或标记按 US GAAP ASC 730 发生时计入费用),并将其路由为资本化候选 / 费用化 / 需财务负责人审核,同时指定具名负责人。绝不自动作出决定。

适用场景

在以下情况下调用此技能:

  • 你正在编制或修订研发项目预算,需要明确列出 F&A 的拆分。
  • 项目的资金可支撑周期存疑,需要评估里程碑与现金之间的关系。
  • 财务部门询问开发成本能否资本化,而你需要一个有依据的初步路由。
  • 你正在准备项目组合评审,需要确保各项目的消耗速度口径一致。

请勿将此技能用于:开展公司 DCF / 估值 / 结账(使用 finance/financial-analysis)、寻找或规划资助(使用 research/grants),或作出最终会计判断(这应由控制人员和审计师决定——此工具仅负责路由)。

工作流

  1. 列出项目内容 — 在 assets/rd_program_budget_template.md 中填写工作包明细、类别和各期金额。
  2. 编制预算 — 运行 program_budget_planner.py --input program.json --profile {pharma-rd|biotech|medtech|deep-tech|software-rd|university-lab} --fa-rate <negotiated rate>。查看直接成本 / F&A / 全负荷成本汇总及假设。
  3. 跟踪消耗速度和资金可支撑周期 — 运行 burn_runway_tracker.py --input ledger.json --threshold-months 6。查看资金可支撑周期、里程碑判断和标记。
  4. 路由会计处理 — 运行 capex_vs_opex_router.py --input costs.json --standard {ifrs|usgaap}。查看各项成本的路由;将资本化候选项和需财务负责人审核的项目发送给具名负责人。
  5. 整理评审材料 — 汇总成项目财务评审材料包。每个数字都附带其假设;处理判断都指定具名负责人。

脚本

脚本用途配置文件
scripts/program_budget_planner.py多期预算 + F&A 拆分 + 假设pharma-rd、biotech、medtech、deep-tech、software-rd、university-lab
scripts/burn_runway_tracker.py消耗速度、资金可支撑周期、里程碑与现金的匹配情况不适用(由分类账驱动)
scripts/capex_vs_opex_router.py根据 IAS 38 / ASC 730 将事项路由至具名财务负责人pharma-rd、biotech、medtech、deep-tech、software-rd、university-lab

三个脚本均仅使用标准库,支持 --help、--sample 和 --output {human,json}。

入门与自定义

开始前,请先运行一次入门问卷——它会记录你的默认设置,让此技能中的每个工具都预先完成配置。自定义是关键:你的回答确实会改变工具的行为。

python3 scripts/onboard.py            # interactive (also: --defaults, --set key=value, --reset)
python3 scripts/onboard.py --show     # see the questions + current effective config

答案会保存到 ~/.config/research-ops/research-finance.json(全局)或 ./.research-ops/research-finance.json(--scope project),并由 config_loader.py 自动读取。它们会设置默认研发领域档案、默认 F&A 费率、资金可维持月数预警阈值、会计准则,以及在资本化与费用化路由结果中显示的具名财务负责人。CLI 标志始终优先于已保存的配置;RESEARCH_OPS_NO_CONFIG=1 会忽略该配置。

**五个问题:**研发领域 · F&A 费率 · 资金可维持月数阈值 · 会计准则 · 财务负责人。

使用 autoresearch 优化(可选启用)

此技能提供了一个隔离、可选启用的桥接工具,连接到 engineering/autoresearch-agent。只有当你要求“优化”/“延长资金可维持时间”/“运行循环”时,autoresearch 实验才会迭代改进项目计划,以符合此技能的资金可维持月数指标。scripts/ar_evaluator.py 是权威评估器;它会输出 runway_months: <float>(越高越好)。

/ar:setup --domain custom --name extend-runway \
  --target ledger.json \
  --eval "python3 ar_evaluator.py --target ledger.json" \
  --metric runway_months --direction higher
/ar:loop custom/extend-runway

隔离运行:没有硬性依赖——autoresearch 仅按需运行,循环只会编辑 ledger.json,不会编辑评估器。

参考资料

  • references/rd_program_finance_canon.md — IAS 38(研究与开发);ASC 730 + ASC 985-20;Uniform Guidance 2 CFR 200(F&A);FASB/IFRS 资本化标准;NICRA 基础知识。
  • references/burn_and_portfolio.md — Cooper 阶段门;研发的 rNPV/实物期权;经风险调整的投资组合 ROI;烧钱率/资金可维持月数框架;基于里程碑的预算编制。
  • references/indirect_rate_modeling.md — F&A 费用池构成(设施 + 行政管理);MTDC 基数;最低限度 10%;福利/间接费用加载;CAS 入门。

假设

  • F&A 费率是最容易出错的输入。规划器会采用你提供的费率;它会提醒你确认这是经协商确定的 NICRA,而非估算值。
  • 烧钱率/资金可维持月数使用过去一段时间(近期数据权重更高)的烧钱率作为未来运行速率,并假设未来支出保持不变,除非你的分类账记录了增长过程。
  • 资本支出路由器会根据你的输入判断标准是否满足;声称“技术可行”并不意味着事实如此——具名财务负责人和审计师会进行验证。
  • 档案会补充背景说明(例如“大多数药物研发支出会费用化”),但不会改变会计测试标准。

反模式

  • 陈述预算数字时不说明假设。 F&A 费率、升级幅度和基数必须与数字一并提供。
  • 自动决定资本化还是费用化。 此工具负责路由;由财务总监(以及必要时的审计师)作出决定。
  • 使用生命周期平均烧钱率计算资金可维持月数。 近期烧钱率才是可靠的未来运行速率;平均值会掩盖放缓或增长。
  • 对整个基数应用 F&A。 资本设备、大部分分包金额和某些类别不计入 MTDC。
  • 将此工具与企业财务混为一谈。 估值、结账和融资属于 finance/。

与以下项目不同

同类/相邻项目范围差异
finance/financial-analysis企业 DCF、比率、结账、滚动预测、SaaS 指标该项目面向公司层面;此项目面向研发项目层面
research/grantsNIH 资金发现与定位该项目寻找资金;此项目管理已获得的资金
clinical-research(同类项目)研究设计 + 可行性 + 预算关卡检查该项目为研究确定范围;此项目为项目提供资金 + 跟踪进度
ra-qm-team法规/QM 申报无关——不涉及财务

快速示例

python3 scripts/program_budget_planner.py --sample
python3 scripts/program_budget_planner.py --input program.json --profile university-lab --fa-rate 0.585
python3 scripts/burn_runway_tracker.py --sample --output json
python3 scripts/capex_vs_opex_router.py --sample --standard ifrs

示例预算将测序仪(资本设备)和 CRO 分包款排除在 F&A 基数之外;资本支出路由器将探索性筛选归为 EXPENSE,将完全满足标准的试点项目归为 CAPITALIZE-CANDIDATE,并将部分满足标准的软件开发归为 FINANCE-OWNER-REVIEW。

追问问题库(Matt Pocock 式严谨追问)

由 /cs-grill-research-ops 或编排器逐一提问。每个问题都附有推荐答案和规范引用。绝不打包提问。

  1. “这笔支出属于研究阶段还是开发阶段——你能提供技术可行性的证据吗?” 推荐答案:研究阶段 = 费用;开发阶段 = 仅在有可行性证据时才考虑资本化,并交由指定的财务负责人处理。 规范:IAS 38.54-57;ASC 730。

  2. “你采用的财务与行政费用(F&A)/间接费率是多少?这是协商确定的 NICRA、最低 10%,还是一项假设?” 推荐答案:采用协商确定的费率;如果是估算值,明确标注。 规范:2 CFR 200(Uniform Guidance);NICRA 基础知识。

  3. “按当前消耗速度,资金还能维持几个月?能否撑到下一个价值拐点里程碑?” 推荐答案:资金应能覆盖里程碑所需时间,并留有缓冲;明确指出缺口。 规范:Cooper 阶段关卡;SaaS/初创企业效率框架(a16z、Bessemer)。

  4. “投资组合 ROI 是否经过风险调整(rNPV / 按成功概率加权),还是原始 NPV?” 推荐答案:进行风险调整;原始 NPV 会高估研发价值。 规范:药物开发估值中的 rNPV;实物期权文献。

  5. “负责签署资本化或费用化处理的指定财务负责人/主计长是谁?” 推荐答案:明确其姓名——此工具只提供建议,绝不会入账。 规范:ASC 730 / IAS 38 治理要求;审计师签署要求。

按深度优先方式逐项提问。确定问题 1-2 的答案后,再提出问题 3-5。全部回答完毕后,调用 program_budget_planner.py → burn_runway_tracker.py → capex_vs_opex_router.py。

评论

支持 Markdown