关于 research-finance
面向 R&D 财务伙伴、项目控制人员和运营负责人,管理已获资金支持的研发项目预算、消耗与会计处理路由。工具为每个金额附上假设,并将资本化判断交由指定财务负责人审核,不会自动入账。
主要功能
- 01多期预算及 F&A 分摊
- 02消耗与资金跑道跟踪
- 03里程碑与现金匹配评估
- 04IAS 38/ASC 730 处理路由
- 05金额附带假设和负责人
适用场景
- 01制定含间接费用拆分的研发预算
- 02评估现金能否支撑下一里程碑
- 03将研发支出提交财务负责人审核
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ alirezarezvani/ claude-skills --skill research-finance安装后在 Claude Code 中输入/research-finance确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
assets/rd_program_budget_template.mdreferences/burn_and_portfolio.mdindirect_rate_modeling.mdrd_program_finance_canon.mdscripts/ar_evaluator.pyburn_runway_tracker.pycapex_vs_opex_router.pyconfig_loader.pyonboard.pyprogram_budget_planner.py详细介绍
research-finance
内部研发项目和项目组合的财务管理:包含项目预算编制及 F&A、消耗速度/资金可支撑周期跟踪,以及资本化与费用化的处理路由。每个数字都附带其假设区块;会计处理判断会转交给具名财务负责人——此技能绝不记账。
目的
研发财务合作伙伴、项目控制人员和运营负责人管理的是已经分配或筹集到的资金——不是公司结账,不是下一轮融资,也不是寻找资助。此技能将三项常见决策结构化:
三个确定性工具:
program_budget_planner.py— 根据工作包明细构建多期预算,将 F&A(间接成本)费率应用于类似 MTDC 的合格基数,并按期间汇总直接成本、F&A 和全负荷成本,同时明确列出假设区块。burn_runway_tracker.py— 计算平均消耗速度和近期消耗速度、按期数/月数计算资金可支撑周期,并判断每个价值拐点里程碑能否在资金耗尽前达成。标记消耗速度加快和资金可支撑周期低于阈值的情况。capex_vs_opex_router.py— 根据 IAS 38 开发阶段标准对每项研发成本评分(或标记按 US GAAP ASC 730 发生时计入费用),并将其路由为资本化候选 / 费用化 / 需财务负责人审核,同时指定具名负责人。绝不自动作出决定。
适用场景
在以下情况下调用此技能:
- 你正在编制或修订研发项目预算,需要明确列出 F&A 的拆分。
- 项目的资金可支撑周期存疑,需要评估里程碑与现金之间的关系。
- 财务部门询问开发成本能否资本化,而你需要一个有依据的初步路由。
- 你正在准备项目组合评审,需要确保各项目的消耗速度口径一致。
请勿将此技能用于:开展公司 DCF / 估值 / 结账(使用 finance/financial-analysis)、寻找或规划资助(使用 research/grants),或作出最终会计判断(这应由控制人员和审计师决定——此工具仅负责路由)。
工作流
- 列出项目内容 — 在
assets/rd_program_budget_template.md中填写工作包明细、类别和各期金额。 - 编制预算 — 运行
program_budget_planner.py --input program.json --profile {pharma-rd|biotech|medtech|deep-tech|software-rd|university-lab} --fa-rate <negotiated rate>。查看直接成本 / F&A / 全负荷成本汇总及假设。 - 跟踪消耗速度和资金可支撑周期 — 运行
burn_runway_tracker.py --input ledger.json --threshold-months 6。查看资金可支撑周期、里程碑判断和标记。 - 路由会计处理 — 运行
capex_vs_opex_router.py --input costs.json --standard {ifrs|usgaap}。查看各项成本的路由;将资本化候选项和需财务负责人审核的项目发送给具名负责人。 - 整理评审材料 — 汇总成项目财务评审材料包。每个数字都附带其假设;处理判断都指定具名负责人。
脚本
| 脚本 | 用途 | 配置文件 |
|---|---|---|
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/grants | NIH 资金发现与定位 | 该项目寻找资金;此项目管理已获得的资金 |
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 或编排器逐一提问。每个问题都附有推荐答案和规范引用。绝不打包提问。
-
“这笔支出属于研究阶段还是开发阶段——你能提供技术可行性的证据吗?” 推荐答案:研究阶段 = 费用;开发阶段 = 仅在有可行性证据时才考虑资本化,并交由指定的财务负责人处理。 规范:IAS 38.54-57;ASC 730。
-
“你采用的财务与行政费用(F&A)/间接费率是多少?这是协商确定的 NICRA、最低 10%,还是一项假设?” 推荐答案:采用协商确定的费率;如果是估算值,明确标注。 规范:2 CFR 200(Uniform Guidance);NICRA 基础知识。
-
“按当前消耗速度,资金还能维持几个月?能否撑到下一个价值拐点里程碑?” 推荐答案:资金应能覆盖里程碑所需时间,并留有缓冲;明确指出缺口。 规范:Cooper 阶段关卡;SaaS/初创企业效率框架(a16z、Bessemer)。
-
“投资组合 ROI 是否经过风险调整(rNPV / 按成功概率加权),还是原始 NPV?” 推荐答案:进行风险调整;原始 NPV 会高估研发价值。 规范:药物开发估值中的 rNPV;实物期权文献。
-
“负责签署资本化或费用化处理的指定财务负责人/主计长是谁?” 推荐答案:明确其姓名——此工具只提供建议,绝不会入账。 规范:ASC 730 / IAS 38 治理要求;审计师签署要求。
按深度优先方式逐项提问。确定问题 1-2 的答案后,再提出问题 3-5。全部回答完毕后,调用 program_budget_planner.py → burn_runway_tracker.py → capex_vs_opex_router.py。