性注釋（Variance Commentary）技能深度解析：從閾值篩選到驅(qū)動(dòng)歸因的完整實(shí)戰(zhàn)指南)
Month-End Closer 波動(dòng)性注釋Variance Commentary技能深度解析從閾值篩選到驅(qū)動(dòng)歸因的完整實(shí)戰(zhàn)指南【免費(fèi)下載鏈接】financial-services項(xiàng)目地址: https://gitcode.com/GitHub_Trending/fi/financial-services導(dǎo)讀波動(dòng)性注釋Variance Commentary是財(cái)務(wù)月末結(jié)賬month-end close中不可或缺的一環(huán)管理層需要一份為什么本期利潤(rùn)表與資產(chǎn)負(fù)債表與上期或預(yù)算不同的可讀解釋而不是一堆原始數(shù)字。本指南以 financial-services 倉(cāng)庫(kù)中 month-end-closer 插件的 variance-commentary 技能 為核心完整解析其閾值判定規(guī)則、逐行注釋表結(jié)構(gòu)、驅(qū)動(dòng)歸因driver的寫作規(guī)范、數(shù)據(jù)溯源方式與最終交付形態(tài)并結(jié)合倉(cāng)庫(kù)內(nèi)的 Agent 定義、Managed Agent 編排配置與配套技能展示該技能在月末結(jié)賬閉環(huán)中的真實(shí)調(diào)用位置與落地方式。讀完本文你將掌握如何讓 AI 會(huì)計(jì)助手輸出一份可審計(jì)、可簽字、不編造的波動(dòng)性注釋。技能定位month-end-closer 結(jié)賬包中的第四環(huán)variance-commentary 技能歸屬于 plugins/agent-plugins/month-end-closer 插件其前置元數(shù)據(jù)定義如下--- name: variance-commentary description: Write flux commentary for every PL and balance-sheet line over threshold — current vs prior period and vs budget, with the driver explained from underlying activity. Use for the month-end close package and management reporting. ---從 month-end-closer 的 Agent 定義 可以看出一次完整結(jié)賬要交付四類產(chǎn)物而波動(dòng)性注釋是其中第三環(huán)應(yīng)計(jì)項(xiàng)目表Accrual schedule—— 每筆應(yīng)計(jì)的計(jì)算、支持憑證引用與 JE 草稿滾動(dòng)對(duì)賬表Roll-forward schedules—— 期初 本期活動(dòng) ? 沖銷 期末并與總賬勾稽波動(dòng)性注釋Variance commentary—— 對(duì)超過閾值的 PL 與資產(chǎn)負(fù)債表科目做本期 vs 上期、本期 vs 預(yù)算的波動(dòng)解釋結(jié)賬包Close package—— 將上述內(nèi)容整理成可供財(cái)務(wù)總監(jiān)controller復(fù)核與簽字的正式文件。Agent 的系統(tǒng)提示中明確了該技能的工作語(yǔ)境Draft variance commentary. Flux every line over threshold; explain from the underlying activity.起草波動(dòng)性注釋對(duì)每個(gè)超過閾值的科目做通量分析并從底層業(yè)務(wù)活動(dòng)出發(fā)解釋原因。這意味著variance-commentary 不是孤立工具而是 month-end-closer Agent 聲明的五大技能之一accrual-schedule·roll-forward·variance-commentary·audit-xls·xlsx-author——它在拿到應(yīng)計(jì)表與滾動(dòng)對(duì)賬表之后執(zhí)行再交由 xlsx-author 組裝成結(jié)賬包。值得注意的是同一份技能內(nèi)容也以 fund-admin 垂直插件的 variance-commentary 形式存在內(nèi)容一致說明該技能在基金行政管理等后臺(tái)財(cái)務(wù)場(chǎng)景同樣適用。輸入三要素與閾值Threshold判定規(guī)則輸入三個(gè)口徑的數(shù)值技能開篇即定義了輸入契約——在相同范圍same scope下同時(shí)提供三組數(shù)值本期實(shí)際值current-period actuals上期實(shí)際值prior-period actuals預(yù)算值budget相同范圍是嚴(yán)謹(jǐn)性的關(guān)鍵只有實(shí)體、科目、幣種、期間口徑完全一致的三個(gè)數(shù)才具備可比性否則波動(dòng)百分比本身會(huì)失真。閾值什么行必須寫注釋技能的篩選邏輯是二者滿足其一即標(biāo)記Flag a line for commentary ifeitheris true絕對(duì)值波動(dòng) ≥ 公司重要性閾值materiality threshold使用調(diào)用方提供的數(shù)值默認(rèn)取該科目金額的 5%與一個(gè)固定底線金額fixed floor中的較大者。這個(gè)取較大者設(shè)計(jì)非常實(shí)用——它同時(shí)防止了兩個(gè)方向的問題對(duì)巨額頭寸5% 可能絕對(duì)金額巨大避免注釋轟炸對(duì)小額科目5% 可能低到?jīng)]有意義固定底線確保任何金額超過 floor 的科目都不會(huì)被漏掉?？颇课挥诒仨氉⑨屒鍐蝍lways comment list上技能明確點(diǎn)名的三類科目是收入revenue、人頭成本headcount cost、現(xiàn)金cash。這三類對(duì)管理層決策最敏感——收入波動(dòng)直接反映業(yè)務(wù)基本面人頭成本是可控性最強(qiáng)的費(fèi)用現(xiàn)金則是流動(dòng)性安全的直接信號(hào)——因此無論波動(dòng)是否達(dá)到閾值都必須解釋。從 month-end-closer Agent 的工作流 看閾值參數(shù)由結(jié)賬任務(wù)上下文攜帶例如管理報(bào)告制度中定義的 5% 與固定金額底線技能本身只負(fù)責(zé)按規(guī)則執(zhí)行不自行決定閾值——這保證了注釋口徑在全公司范圍內(nèi)的一致性。逐行注釋表列結(jié)構(gòu)與驅(qū)動(dòng)歸因?qū)懽饕?guī)范注釋表的五列結(jié)構(gòu)對(duì)每個(gè)被標(biāo)記的科目技能要求輸出如下表格ColumnContentLineAccount or captionCurrent / Prior / BudgetThe three valuesΔ vs priorandΔ vs budgetAmount and %DriverOne sentence explaining the movement from underlying activity — not a restatement of the number即每個(gè)被標(biāo)記科目需要科目名稱、三個(gè)口徑數(shù)值、相對(duì)上期與相對(duì)預(yù)算的金額差與百分比差、以及一句話驅(qū)動(dòng)歸因。Driver 寫作規(guī)范解釋 why而不是復(fù)述 what技能用一段話專門強(qiáng)調(diào)了 Driver 列的核心紀(jì)律——這是本技能與普通數(shù)字變動(dòng)羅列的本質(zhì)區(qū)別A driver explainswhy, notwhat: Cloud spend up $1.2M on incremental GPU reservations for the May launch — not Cloud spend increased $1.2M (18%).技能給出了正反兩個(gè)例子合格寫法driver云支出增加 120 萬(wàn)美元源于 5 月發(fā)布活動(dòng)新增的 GPU 預(yù)留——直接點(diǎn)出底層業(yè)務(wù)活動(dòng)incremental GPU reservations / May launch不合格寫法復(fù)述數(shù)字云支出增加了 120 萬(wàn)美元18%——只是把 Δ 列的數(shù)字翻譯成一句話沒有解釋任何原因。這條規(guī)范的價(jià)值在于管理層讀注釋包時(shí)真正想要的是發(fā)生了什么業(yè)務(wù)變化新增 GPU 預(yù)留、新項(xiàng)目立項(xiàng)、供應(yīng)商切換而不是數(shù)字變成了多少表格里已經(jīng)寫明了。Driver 必須做到可追溯到真實(shí)業(yè)務(wù)活動(dòng)而不是數(shù)字的二次陳述。數(shù)據(jù)溯源通過 internal-gl MCP 挖掘驅(qū)動(dòng)因素技能的Sourcing the driver一節(jié)規(guī)定了驅(qū)動(dòng)歸因的證據(jù)來源與邊界Look at the activity behind the line (journal-source breakdown, vendor mix, headcount delta, volume × rate) via the internal-gl MCP. If the driver isnt clear from the data, write driver unclear — flag for controller rather than inventing one.具體而言Agent 應(yīng)通過internal-gl MCP 服務(wù)器內(nèi)部總賬查詢接口查看科目背后的活動(dòng)分解憑證來源分解journal-source breakdown例如本期新增的預(yù)提憑證、付款憑證、調(diào)賬憑證各貢獻(xiàn)了多少供應(yīng)商組合vendor mix費(fèi)用集中在哪些供應(yīng)商是否有新供應(yīng)商進(jìn)入人頭變動(dòng)headcount delta解釋薪資、福利類科目波動(dòng)的直接依據(jù)量 × 價(jià)volume × rate收入或成本科目的標(biāo)準(zhǔn)分解框架拆出量效應(yīng)與價(jià)效應(yīng)。這正是 roll-forward 技能 所強(qiáng)調(diào)的每條活動(dòng)行都要有 GL 查詢account date range journal-source filter支撐的方法在注釋場(chǎng)景的延伸——注釋中的每個(gè) driver 背后都應(yīng)該能對(duì)應(yīng)到一條可重跑的總賬查詢。技能在此設(shè)置了最重要的一條安全邊界如果數(shù)據(jù)里找不到清晰的驅(qū)動(dòng)因素就寫 driver unclear — flag for controller驅(qū)動(dòng)不明確——標(biāo)記給財(cái)務(wù)總監(jiān)而不是編造一個(gè)。這條規(guī)定把誠(chéng)實(shí)的不知道制度化財(cái)務(wù)總監(jiān)寧可看到一個(gè)明確標(biāo)注待查的行也不愿意在簽字文件里出現(xiàn)一個(gè)無法驗(yàn)證的解釋——后者在審計(jì)場(chǎng)景中可能升級(jí)為披露風(fēng)險(xiǎn)。輸出形態(tài)注釋表 摘要敘述技能定義的最終產(chǎn)出是兩部分注釋表the commentary table即上文逐行注釋表中的完整表格覆蓋所有被標(biāo)記科目短摘要敘述a short narrative3–5 句總結(jié)本期最大的幾個(gè)變動(dòng)項(xiàng)biggest movers讓讀者無需逐行讀表就能先抓住本期財(cái)務(wù)狀況的核心變化。這段 3–5 句的敘述是管理報(bào)告的標(biāo)準(zhǔn)做法先給結(jié)論性的最大變動(dòng)再讓讀者按需查看表格細(xì)節(jié)。在結(jié)賬閉環(huán)中的落地從技能到結(jié)賬包Managed Agent 編排中的實(shí)際調(diào)用鏈managed-agent-cookbooks/month-end-closer 目錄提供了該技能的 Managed Agent 部署形態(tài)面向POST /v1/agents接口。從 agent.yaml 可以看到完整編排name: month-end-closer model: claude-opus-4-7 system: file: ../../plugins/agent-plugins/month-end-closer/agents/month-end-closer.md append: You are running headless. Produce files in ./out/; do not assume an open Office document. tools: - type: agent_toolset_20260401 default_config: { enabled: false } configs: - { name: read, enabled: true } - { name: grep, enabled: true } - { name: glob, enabled: true } - { type: mcp_toolset, mcp_server_name: internal-gl, default_config: { enabled: true } } mcp_servers: - { type: url, name: internal-gl, url: ${GL_MCP_URL} } skills: - { from_plugin: ../../plugins/agent-plugins/month-end-closer } callable_agents: - { manifest: ./subagents/ledger-reader.yaml } - { manifest: ./subagents/rollforward.yaml } - { manifest: ./subagents/poster.yaml } # only leaf with Write關(guān)鍵點(diǎn)在于variance-commentary 技能被整體打包進(jìn) month-end-closer 插件的 skills 集合中from_plugin而驅(qū)動(dòng)歸因所需的總賬數(shù)據(jù)來自internal-gl這個(gè) URL 型 MCP 服務(wù)器地址由環(huán)境變量GL_MCP_URL注入。部署命令為export ANTHROPIC_API_KEYsk-ant-... export GL_MCP_URL... ../../scripts/deploy-managed-agent.sh month-end-closer三層隔離與權(quán)限邊界month-end-closer cookbook 的 README 明確了結(jié)賬流程的三層安全架構(gòu)這也界定了注釋撰寫環(huán)節(jié)的數(shù)據(jù)邊界TierTouches untrusted docs?ToolsConnectorsledger-readerYesRead,GreponlyNonerollforward/ OrchestratorNoRead,Grep,Glob,Agentinternal-gl (read-only)poster(Write-holder)NoRead,Write,EditNoneledger-reader專門讀取不可信的支持性文檔供應(yīng)商發(fā)票、對(duì)賬單其 worker 定義 只授予Read/Grep無 MCP、無寫工具且必須返回 schema 校驗(yàn)過的 JSONentity、period、support[]rollforward / Orchestrator通過只讀的 internal-gl MCP 查詢總賬是注釋與滾動(dòng)對(duì)賬表的數(shù)據(jù)來源見 rollforward worker 定義poster是唯一持有Write權(quán)限的葉節(jié)點(diǎn)負(fù)責(zé)把 JE 草稿、滾動(dòng)對(duì)賬表與注釋組裝成./out/close-package-entity-period.xlsx見 poster worker 定義。這條鏈路對(duì) variance-commentary 的含義是注釋的 driver 只能基于只讀總賬數(shù)據(jù)與已校驗(yàn)的支持性數(shù)據(jù)生成——Agent 本身沒有寫總賬的工具JE 一律以草稿形態(tài)進(jìn)入結(jié)賬包實(shí)際過賬必須由財(cái)務(wù)總監(jiān)在 Agent 外部審批No GL posting. This agent drafts JEs; posting requires controller approval outside the agent.。注釋中driver unclear — flag for controller的行恰好會(huì)被 controller 在簽字環(huán)節(jié)重點(diǎn)關(guān)注。結(jié)賬包的組裝規(guī)范注釋表與摘要敘述最終由 xlsx-author 技能寫入結(jié)賬包。從 xlsx-author 技能 可以看到 headless 模式下的輸出契約寫入./out/name.xlsx目錄不存在則創(chuàng)建并在最終消息中返回相對(duì)路徑供編排層收集遵循與 audit-xls 技能 一致的著色約定藍(lán)色 硬編碼輸入、黑色 公式、綠色 跨表/跨文件引用計(jì)算單元格一律為公式、輸入統(tǒng)一放在 Inputs 頁(yè)使用 openpyxl 編寫短 Python 腳本生成工作簿并建議包含 Checks 頁(yè)做勾稽校驗(yàn)TRUE/FALSE。這意味著注釋表在交付時(shí)應(yīng)保持輸入數(shù)據(jù)三口徑數(shù)值、閾值參數(shù)與計(jì)算列Δ 金額、Δ %分離的結(jié)構(gòu)方便財(cái)務(wù)總監(jiān)與審計(jì)復(fù)核時(shí)追溯每個(gè)百分比的計(jì)算口徑。二次結(jié)賬與后續(xù)調(diào)整注釋的可重復(fù)性cookbook 的 steering-examples.json 展示了三種典型觸發(fā)場(chǎng)景[ { event: Close entity US-OPCO for period 2026-04, description: Standard month-end close }, { event: Close entity UK-HOLDCO for period 2026-03, scope: accruals only, description: Partial close, accruals only }, { event: Re-draft variance commentary for entity US-OPCO 2026-04 after late JEs, description: Follow-up after adjustments post } ]第三種場(chǎng)景尤其值得注意滯后過賬后的注釋重寫——當(dāng)某些 JE 在首次結(jié)賬后才過賬期末數(shù)發(fā)生變化注釋必須隨之重跑。這要求注釋生成過程完全可重復(fù)、可重跑輸入三口徑數(shù)值變了閾值篩選、Δ 計(jì)算與 driver 溯源邏輯保持不變重新執(zhí)行即可得到更新后的注釋包。這一設(shè)計(jì)印證了技能定義中輸入契約驅(qū)動(dòng)輸出的工程化思路——注釋不是一次性的人工敘述而是可參數(shù)化重跑的確定性流程。此外month-end-closer README 還提到該 Agent 會(huì)接收來自gl-reconciler總賬對(duì)賬 Agent的handoff_request事件——把已驗(yàn)證的對(duì)賬差異verified breaks納入結(jié)賬注釋實(shí)現(xiàn)對(duì)賬發(fā)現(xiàn)問題 → 結(jié)賬解釋問題的跨 Agent 協(xié)作。實(shí)戰(zhàn)要點(diǎn)速查閾值取較大者默認(rèn)規(guī)則是max(科目金額 × 5%, 固定底線金額)防止巨額頭寸注釋轟炸與小額科目漏判三類必注釋科目收入、人頭成本、現(xiàn)金即使未達(dá)閾值也必須寫Driver 三問是否回答了 why是否指向底層業(yè)務(wù)活動(dòng)憑證來源、供應(yīng)商、人頭、量×價(jià)是否可被總賬查詢重跑驗(yàn)證寧缺毋濫數(shù)據(jù)不支持解釋時(shí)寫driver unclear — flag for controller絕不編造這是審計(jì)友好設(shè)計(jì)不是能力缺陷交付物兩件套逐行注釋表 3–5 句摘要敘述前者供細(xì)節(jié)核查后者供快速瀏覽寫權(quán)限邊界注釋生成全程只讀總賬internal-gl MCPJE 只以草稿進(jìn)入./out/close-package-entity-period.xlsx過賬必須由 controller 在 Agent 外部批準(zhǔn)。延伸閱讀variance-commentary 技能本體fund-admin 垂直插件中的同款技能month-end-closer Agent 定義Managed Agent 編排配置 與 部署說明應(yīng)計(jì)項(xiàng)目表技能、滾動(dòng)對(duì)賬表技能xlsx-author 輸出契約、audit-xls 審計(jì)規(guī)范【免費(fèi)下載鏈接】financial-services項(xiàng)目地址: https://gitcode.com/GitHub_Trending/fi/financial-services創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Month-End Closer 波動(dòng)性注釋（Variance Commentary）技能深度解析：從閾值篩選到驅(qū)動(dòng)歸因的完整實(shí)戰(zhàn)指南
Month-End Closer 波動(dòng)性注釋Variance Commentary技能深度解析從閾值篩選到驅(qū)動(dòng)歸因的完整實(shí)戰(zhàn)指南【免費(fèi)下載鏈接】financial-services項(xiàng)目地址: https://gitcode.com/GitHub_Trending/fi/financial-services導(dǎo)讀波動(dòng)性注釋Variance Commentary是財(cái)務(wù)月末結(jié)賬month-end close中不可或缺的一環(huán)管理層需要一份為什么本期利潤(rùn)表與資產(chǎn)負(fù)債表與上期或預(yù)算不同的可讀解釋而不是一堆原始數(shù)字。本指南以 financial-services 倉(cāng)庫(kù)中 month-end-closer 插件的 variance-commentary 技能 為核心完整解析其閾值判定規(guī)則、逐行注釋表結(jié)構(gòu)、驅(qū)動(dòng)歸因driver的寫作規(guī)范、數(shù)據(jù)溯源方式與最終交付形態(tài)并結(jié)合倉(cāng)庫(kù)內(nèi)的 Agent 定義、Managed Agent 編排配置與配套技能展示該技能在月末結(jié)賬閉環(huán)中的真實(shí)調(diào)用位置與落地方式。讀完本文你將掌握如何讓 AI 會(huì)計(jì)助手輸出一份可審計(jì)、可簽字、不編造的波動(dòng)性注釋。技能定位month-end-closer 結(jié)賬包中的第四環(huán)variance-commentary 技能歸屬于 plugins/agent-plugins/month-end-closer 插件其前置元數(shù)據(jù)定義如下--- name: variance-commentary description: Write flux commentary for every PL and balance-sheet line over threshold — current vs prior period and vs budget, with the driver explained from underlying activity. Use for the month-end close package and management reporting. ---從 month-end-closer 的 Agent 定義 可以看出一次完整結(jié)賬要交付四類產(chǎn)物而波動(dòng)性注釋是其中第三環(huán)應(yīng)計(jì)項(xiàng)目表Accrual schedule—— 每筆應(yīng)計(jì)的計(jì)算、支持憑證引用與 JE 草稿滾動(dòng)對(duì)賬表Roll-forward schedules—— 期初 本期活動(dòng) ? 沖銷 期末并與總賬勾稽波動(dòng)性注釋Variance commentary—— 對(duì)超過閾值的 PL 與資產(chǎn)負(fù)債表科目做本期 vs 上期、本期 vs 預(yù)算的波動(dòng)解釋結(jié)賬包Close package—— 將上述內(nèi)容整理成可供財(cái)務(wù)總監(jiān)controller復(fù)核與簽字的正式文件。Agent 的系統(tǒng)提示中明確了該技能的工作語(yǔ)境Draft variance commentary. Flux every line over threshold; explain from the underlying activity.起草波動(dòng)性注釋對(duì)每個(gè)超過閾值的科目做通量分析并從底層業(yè)務(wù)活動(dòng)出發(fā)解釋原因。這意味著variance-commentary 不是孤立工具而是 month-end-closer Agent 聲明的五大技能之一accrual-schedule·roll-forward·variance-commentary·audit-xls·xlsx-author——它在拿到應(yīng)計(jì)表與滾動(dòng)對(duì)賬表之后執(zhí)行再交由 xlsx-author 組裝成結(jié)賬包。值得注意的是同一份技能內(nèi)容也以 fund-admin 垂直插件的 variance-commentary 形式存在內(nèi)容一致說明該技能在基金行政管理等后臺(tái)財(cái)務(wù)場(chǎng)景同樣適用。輸入三要素與閾值Threshold判定規(guī)則輸入三個(gè)口徑的數(shù)值技能開篇即定義了輸入契約——在相同范圍same scope下同時(shí)提供三組數(shù)值本期實(shí)際值current-period actuals上期實(shí)際值prior-period actuals預(yù)算值budget相同范圍是嚴(yán)謹(jǐn)性的關(guān)鍵只有實(shí)體、科目、幣種、期間口徑完全一致的三個(gè)數(shù)才具備可比性否則波動(dòng)百分比本身會(huì)失真。閾值什么行必須寫注釋技能的篩選邏輯是二者滿足其一即標(biāo)記Flag a line for commentary ifeitheris true絕對(duì)值波動(dòng) ≥ 公司重要性閾值materiality threshold使用調(diào)用方提供的數(shù)值默認(rèn)取該科目金額的 5%與一個(gè)固定底線金額fixed floor中的較大者。這個(gè)取較大者設(shè)計(jì)非常實(shí)用——它同時(shí)防止了兩個(gè)方向的問題對(duì)巨額頭寸5% 可能絕對(duì)金額巨大避免注釋轟炸對(duì)小額科目5% 可能低到?jīng)]有意義固定底線確保任何金額超過 floor 的科目都不會(huì)被漏掉?？颇课挥诒仨氉⑨屒鍐蝍lways comment list上技能明確點(diǎn)名的三類科目是收入revenue、人頭成本headcount cost、現(xiàn)金cash。這三類對(duì)管理層決策最敏感——收入波動(dòng)直接反映業(yè)務(wù)基本面人頭成本是可控性最強(qiáng)的費(fèi)用現(xiàn)金則是流動(dòng)性安全的直接信號(hào)——因此無論波動(dòng)是否達(dá)到閾值都必須解釋。從 month-end-closer Agent 的工作流 看閾值參數(shù)由結(jié)賬任務(wù)上下文攜帶例如管理報(bào)告制度中定義的 5% 與固定金額底線技能本身只負(fù)責(zé)按規(guī)則執(zhí)行不自行決定閾值——這保證了注釋口徑在全公司范圍內(nèi)的一致性。逐行注釋表列結(jié)構(gòu)與驅(qū)動(dòng)歸因?qū)懽饕?guī)范注釋表的五列結(jié)構(gòu)對(duì)每個(gè)被標(biāo)記的科目技能要求輸出如下表格ColumnContentLineAccount or captionCurrent / Prior / BudgetThe three valuesΔ vs priorandΔ vs budgetAmount and %DriverOne sentence explaining the movement from underlying activity — not a restatement of the number即每個(gè)被標(biāo)記科目需要科目名稱、三個(gè)口徑數(shù)值、相對(duì)上期與相對(duì)預(yù)算的金額差與百分比差、以及一句話驅(qū)動(dòng)歸因。Driver 寫作規(guī)范解釋 why而不是復(fù)述 what技能用一段話專門強(qiáng)調(diào)了 Driver 列的核心紀(jì)律——這是本技能與普通數(shù)字變動(dòng)羅列的本質(zhì)區(qū)別A driver explainswhy, notwhat: Cloud spend up $1.2M on incremental GPU reservations for the May launch — not Cloud spend increased $1.2M (18%).技能給出了正反兩個(gè)例子合格寫法driver云支出增加 120 萬(wàn)美元源于 5 月發(fā)布活動(dòng)新增的 GPU 預(yù)留——直接點(diǎn)出底層業(yè)務(wù)活動(dòng)incremental GPU reservations / May launch不合格寫法復(fù)述數(shù)字云支出增加了 120 萬(wàn)美元18%——只是把 Δ 列的數(shù)字翻譯成一句話沒有解釋任何原因。這條規(guī)范的價(jià)值在于管理層讀注釋包時(shí)真正想要的是發(fā)生了什么業(yè)務(wù)變化新增 GPU 預(yù)留、新項(xiàng)目立項(xiàng)、供應(yīng)商切換而不是數(shù)字變成了多少表格里已經(jīng)寫明了。Driver 必須做到可追溯到真實(shí)業(yè)務(wù)活動(dòng)而不是數(shù)字的二次陳述。數(shù)據(jù)溯源通過 internal-gl MCP 挖掘驅(qū)動(dòng)因素技能的Sourcing the driver一節(jié)規(guī)定了驅(qū)動(dòng)歸因的證據(jù)來源與邊界Look at the activity behind the line (journal-source breakdown, vendor mix, headcount delta, volume × rate) via the internal-gl MCP. If the driver isnt clear from the data, write driver unclear — flag for controller rather than inventing one.具體而言Agent 應(yīng)通過internal-gl MCP 服務(wù)器內(nèi)部總賬查詢接口查看科目背后的活動(dòng)分解憑證來源分解journal-source breakdown例如本期新增的預(yù)提憑證、付款憑證、調(diào)賬憑證各貢獻(xiàn)了多少供應(yīng)商組合vendor mix費(fèi)用集中在哪些供應(yīng)商是否有新供應(yīng)商進(jìn)入人頭變動(dòng)headcount delta解釋薪資、福利類科目波動(dòng)的直接依據(jù)量 × 價(jià)volume × rate收入或成本科目的標(biāo)準(zhǔn)分解框架拆出量效應(yīng)與價(jià)效應(yīng)。這正是 roll-forward 技能 所強(qiáng)調(diào)的每條活動(dòng)行都要有 GL 查詢account date range journal-source filter支撐的方法在注釋場(chǎng)景的延伸——注釋中的每個(gè) driver 背后都應(yīng)該能對(duì)應(yīng)到一條可重跑的總賬查詢。技能在此設(shè)置了最重要的一條安全邊界如果數(shù)據(jù)里找不到清晰的驅(qū)動(dòng)因素就寫 driver unclear — flag for controller驅(qū)動(dòng)不明確——標(biāo)記給財(cái)務(wù)總監(jiān)而不是編造一個(gè)。這條規(guī)定把誠(chéng)實(shí)的不知道制度化財(cái)務(wù)總監(jiān)寧可看到一個(gè)明確標(biāo)注待查的行也不愿意在簽字文件里出現(xiàn)一個(gè)無法驗(yàn)證的解釋——后者在審計(jì)場(chǎng)景中可能升級(jí)為披露風(fēng)險(xiǎn)。輸出形態(tài)注釋表 摘要敘述技能定義的最終產(chǎn)出是兩部分注釋表the commentary table即上文逐行注釋表中的完整表格覆蓋所有被標(biāo)記科目短摘要敘述a short narrative3–5 句總結(jié)本期最大的幾個(gè)變動(dòng)項(xiàng)biggest movers讓讀者無需逐行讀表就能先抓住本期財(cái)務(wù)狀況的核心變化。這段 3–5 句的敘述是管理報(bào)告的標(biāo)準(zhǔn)做法先給結(jié)論性的最大變動(dòng)再讓讀者按需查看表格細(xì)節(jié)。在結(jié)賬閉環(huán)中的落地從技能到結(jié)賬包Managed Agent 編排中的實(shí)際調(diào)用鏈managed-agent-cookbooks/month-end-closer 目錄提供了該技能的 Managed Agent 部署形態(tài)面向POST /v1/agents接口。從 agent.yaml 可以看到完整編排name: month-end-closer model: claude-opus-4-7 system: file: ../../plugins/agent-plugins/month-end-closer/agents/month-end-closer.md append: You are running headless. Produce files in ./out/; do not assume an open Office document. tools: - type: agent_toolset_20260401 default_config: { enabled: false } configs: - { name: read, enabled: true } - { name: grep, enabled: true } - { name: glob, enabled: true } - { type: mcp_toolset, mcp_server_name: internal-gl, default_config: { enabled: true } } mcp_servers: - { type: url, name: internal-gl, url: ${GL_MCP_URL} } skills: - { from_plugin: ../../plugins/agent-plugins/month-end-closer } callable_agents: - { manifest: ./subagents/ledger-reader.yaml } - { manifest: ./subagents/rollforward.yaml } - { manifest: ./subagents/poster.yaml } # only leaf with Write關(guān)鍵點(diǎn)在于variance-commentary 技能被整體打包進(jìn) month-end-closer 插件的 skills 集合中from_plugin而驅(qū)動(dòng)歸因所需的總賬數(shù)據(jù)來自internal-gl這個(gè) URL 型 MCP 服務(wù)器地址由環(huán)境變量GL_MCP_URL注入。部署命令為export ANTHROPIC_API_KEYsk-ant-... export GL_MCP_URL... ../../scripts/deploy-managed-agent.sh month-end-closer三層隔離與權(quán)限邊界month-end-closer cookbook 的 README 明確了結(jié)賬流程的三層安全架構(gòu)這也界定了注釋撰寫環(huán)節(jié)的數(shù)據(jù)邊界TierTouches untrusted docs?ToolsConnectorsledger-readerYesRead,GreponlyNonerollforward/ OrchestratorNoRead,Grep,Glob,Agentinternal-gl (read-only)poster(Write-holder)NoRead,Write,EditNoneledger-reader專門讀取不可信的支持性文檔供應(yīng)商發(fā)票、對(duì)賬單其 worker 定義 只授予Read/Grep無 MCP、無寫工具且必須返回 schema 校驗(yàn)過的 JSONentity、period、support[]rollforward / Orchestrator通過只讀的 internal-gl MCP 查詢總賬是注釋與滾動(dòng)對(duì)賬表的數(shù)據(jù)來源見 rollforward worker 定義poster是唯一持有Write權(quán)限的葉節(jié)點(diǎn)負(fù)責(zé)把 JE 草稿、滾動(dòng)對(duì)賬表與注釋組裝成./out/close-package-entity-period.xlsx見 poster worker 定義。這條鏈路對(duì) variance-commentary 的含義是注釋的 driver 只能基于只讀總賬數(shù)據(jù)與已校驗(yàn)的支持性數(shù)據(jù)生成——Agent 本身沒有寫總賬的工具JE 一律以草稿形態(tài)進(jìn)入結(jié)賬包實(shí)際過賬必須由財(cái)務(wù)總監(jiān)在 Agent 外部審批No GL posting. This agent drafts JEs; posting requires controller approval outside the agent.。注釋中driver unclear — flag for controller的行恰好會(huì)被 controller 在簽字環(huán)節(jié)重點(diǎn)關(guān)注。結(jié)賬包的組裝規(guī)范注釋表與摘要敘述最終由 xlsx-author 技能寫入結(jié)賬包。從 xlsx-author 技能 可以看到 headless 模式下的輸出契約寫入./out/name.xlsx目錄不存在則創(chuàng)建并在最終消息中返回相對(duì)路徑供編排層收集遵循與 audit-xls 技能 一致的著色約定藍(lán)色 硬編碼輸入、黑色 公式、綠色 跨表/跨文件引用計(jì)算單元格一律為公式、輸入統(tǒng)一放在 Inputs 頁(yè)使用 openpyxl 編寫短 Python 腳本生成工作簿并建議包含 Checks 頁(yè)做勾稽校驗(yàn)TRUE/FALSE。這意味著注釋表在交付時(shí)應(yīng)保持輸入數(shù)據(jù)三口徑數(shù)值、閾值參數(shù)與計(jì)算列Δ 金額、Δ %分離的結(jié)構(gòu)方便財(cái)務(wù)總監(jiān)與審計(jì)復(fù)核時(shí)追溯每個(gè)百分比的計(jì)算口徑。二次結(jié)賬與后續(xù)調(diào)整注釋的可重復(fù)性cookbook 的 steering-examples.json 展示了三種典型觸發(fā)場(chǎng)景[ { event: Close entity US-OPCO for period 2026-04, description: Standard month-end close }, { event: Close entity UK-HOLDCO for period 2026-03, scope: accruals only, description: Partial close, accruals only }, { event: Re-draft variance commentary for entity US-OPCO 2026-04 after late JEs, description: Follow-up after adjustments post } ]第三種場(chǎng)景尤其值得注意滯后過賬后的注釋重寫——當(dāng)某些 JE 在首次結(jié)賬后才過賬期末數(shù)發(fā)生變化注釋必須隨之重跑。這要求注釋生成過程完全可重復(fù)、可重跑輸入三口徑數(shù)值變了閾值篩選、Δ 計(jì)算與 driver 溯源邏輯保持不變重新執(zhí)行即可得到更新后的注釋包。這一設(shè)計(jì)印證了技能定義中輸入契約驅(qū)動(dòng)輸出的工程化思路——注釋不是一次性的人工敘述而是可參數(shù)化重跑的確定性流程。此外month-end-closer README 還提到該 Agent 會(huì)接收來自gl-reconciler總賬對(duì)賬 Agent的handoff_request事件——把已驗(yàn)證的對(duì)賬差異verified breaks納入結(jié)賬注釋實(shí)現(xiàn)對(duì)賬發(fā)現(xiàn)問題 → 結(jié)賬解釋問題的跨 Agent 協(xié)作。實(shí)戰(zhàn)要點(diǎn)速查閾值取較大者默認(rèn)規(guī)則是max(科目金額 × 5%, 固定底線金額)防止巨額頭寸注釋轟炸與小額科目漏判三類必注釋科目收入、人頭成本、現(xiàn)金即使未達(dá)閾值也必須寫Driver 三問是否回答了 why是否指向底層業(yè)務(wù)活動(dòng)憑證來源、供應(yīng)商、人頭、量×價(jià)是否可被總賬查詢重跑驗(yàn)證寧缺毋濫數(shù)據(jù)不支持解釋時(shí)寫driver unclear — flag for controller絕不編造這是審計(jì)友好設(shè)計(jì)不是能力缺陷交付物兩件套逐行注釋表 3–5 句摘要敘述前者供細(xì)節(jié)核查后者供快速瀏覽寫權(quán)限邊界注釋生成全程只讀總賬internal-gl MCPJE 只以草稿進(jìn)入./out/close-package-entity-period.xlsx過賬必須由 controller 在 Agent 外部批準(zhǔn)。延伸閱讀variance-commentary 技能本體fund-admin 垂直插件中的同款技能month-end-closer Agent 定義Managed Agent 編排配置 與 部署說明應(yīng)計(jì)項(xiàng)目表技能、滾動(dòng)對(duì)賬表技能xlsx-author 輸出契約、audit-xls 審計(jì)規(guī)范【免費(fèi)下載鏈接】financial-services項(xiàng)目地址: https://gitcode.com/GitHub_Trending/fi/financial-services創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考