IDFA Operations（idfa-ops）提供一组脚本，用于与符合 IDFA 规范的 Excel 财务模型进行程序化交互。它属于 IDFA Financial Architect 插件，负责解决“如何操作”，而方法论技能负责回答“做什么”。
用途与触发时机 当 idfa-financial-architect 方法论技能需要与模型交互时，可启用本技能，具体包括五类操作：写入假设（设置 Named Range 输入值）、读取结果（重算后获取计算输出）、检查结构（列出所有 Named Range、公式与依赖）、审计合规（检查全部四项 IDFA 护栏）、重算（通过 LibreOffice 触发确定性公式求值）。
前置条件 运行环境需要 Python 3.10+（脚本运行时）与 uv（用于 PEP 723 内联依赖解析），二者均为必需。重算功能还需要 LibreOffice；Anthropic 的 xlsx 技能为推荐项，可提供经过验证的 recalc.py。脚本使用 PEP 723 内联元数据，由 uv run 自动处理依赖安装，无需手动执行 pip install。
操作命令参考 写入假设：uv run scripts/idfa_ops.py write <file> <name> <value>，设置 Named Range 输入值。读取结果：uv run scripts/idfa_ops.py read <file> <name> [name2...]，读取一个或多个 Named Range 的值。检查模型：uv run scripts/idfa_ops.py inspect <file>，列出所有 Named Range、值与公式。读取公式：uv run scripts/idfa_ops.py formula <file> <name>，返回某 Named Range 的公式文本。创建 Named Range：uv run scripts/idfa_ops.py create-range <file> <name> <sheet> <cell>。重算：uv run scripts/recalc_bridge.py <file>，触发 LibreOffice 确定性重算。审计合规：uv run scripts/idfa_audit.py <file>，检查四项 IDFA 护栏并返回 JSON 报告。以上脚本路径均相对于本技能目录（skills/idfa-ops/）。
写入-重算-读取模式 这是 IDFA 模型操作的基本交互模式。智能体负责推理应设置哪些值，而所有算术由电子表格引擎完成。示例：第一步执行 write model.xlsx Inp_Rev_Y1 12000000 写入假设，此时值已存储但依赖公式尚未重算；第二步执行 recalc_bridge.py model.xlsx，让 LibreOffice 对工作簿中每个公式进行确定性求值，这一步必不可少，因为 openpyxl 无法计算公式；第三步执行 read model.xlsx Gross_Profit_Y1 Gross_Profit_Y2 Gross_Profit_Y3，读取重算后的结果。返回的是模型的确定性输出，而非智能体的估算值。
与 xlsx 技能的协同 当同时安装 Anthropic 的 xlsx 技能时，recalc_bridge.py 会自动委托给 xlsx 技能的 recalc.py 进行基于 LibreOffice 的公式求值。若只安装 idfa-ops，recalc_bridge.py 会运行自带的 LibreOffice 宏。两种情况下接口一致，智能体调用相同的命令，无需关心底层使用哪种重算后端。
输出格式 所有脚本均以 JSON 输出到标准输出，供智能体消费。读取成功示例：{"status": "ok", "values": { "Gross_Profit_Y1": 4000000, "Gross_Profit_Y2": 4510000 }}；检查成功示例：{"status": "ok", "named_ranges": [...], "count": 16}；错误示例：{ "error": "Named Range not found: Bad_Name" }。退出码约定为：0 表示成功，1 表示未找到 Named Range，2 表示文件或用法错误。
输出最佳实践 任何修改或分析模型的任务都必须生成 Markdown 结果文件并保存到输出目录。仅有 xlsx 文件不够，还需要文本产物用于审查、评分与审计留痕。对于多步操作（what-if、目标求解、多写入场景），应记录每一步运行的命令及其返回内容，包含前后值对比的汇总表，并说明所用方法（例如“所有值通过写入-重算-读取模式获得”或“因 LibreOffice 不可用而通过公式追踪计算”），保存为 <task>_results.md，与修改后的 xlsx 放在一起。结果文件本身即为交付物，xlsx 是佐证产物。
错误处理 未找到 Named Range（退出码 1）：应先检查模型以确认正确名称。文件未找到（退出码 2）：核实路径后重试。LibreOffice 未安装（退出码 1）：提示用户；读写仍可用，但重算不可用。权限被拒（退出码 2）：检查文件是否在 Excel 中打开。当 LibreOffice 不可用时，仍可写入假设并读取缓存值，但写入-重算-读取模式无法完整执行，应告知用户结果可能未反映最新假设。
归属 IDFA Operations 属于 IDFA Financial Architect 插件，由 Panaversity 团队开发（https://panaversity.org）。专有软件，详见 LICENSE。