business-operations-analytics

name	business-operations-analytics
description	RAILWISE-OS 经营数据问答、经营简报、指标诊断和项目经营健康检查专项 skill。

Business Operations Analytics Skill

用于 RAILWISE-OS AI Native 经营数据能力。默认由 RAILWISE-CLI 在 OS 已准备好的 workspace 中调用。

适用对象和不适用对象

适用于：

• company
• department
• project
• contract
• receivable
• invoice
• dashboard_metric

不适用于合同条款逐条法律审查、发票附件逐项核查、投标资料缺口扫描；这些使用 business-finance。

OS Native 输入

当工作区存在以下文件时，必须优先使用 OS 已锁定数据：

• input/context-pack.json
• input/locked-facts.json
• input/capability-blueprint.json
• input/business-metrics-context.json
• input/locked-metric-result.json
• input/business-brief-blueprint.json

数据源优先级

1. RAILWISE-OS 已锁定经营指标和 locked-metric-result.json。
2. 合同、回款、发票、项目台账和 KPI 目标。
3. 用户选择的时间范围、部门、项目、指标和对比方式。
4. 缺数据时输出 missingData，不得补写不存在的金额。

核心原则

1. OS 数据为准。 合同额、回款、发票、逾期、项目数、时间范围和权限裁剪均以 locked-metric-result.json 为准。
2. AI 不改数。 不得自行重算、补写或猜测 locked facts 中不存在的金额、项目数量、部门明细。
3. 解释和建议是 AI 的职责。 可以输出经营摘要、关键发现、风险解释、建议动作、追问问题和缺失数据。
4. 权限优先。 不得绕过 permissionScope 输出未授权部门、项目、员工或合同明细。
5. 不做财务最终裁定。 风险判断是管理建议，正式数据仍以 OS、财务复核和人工验收为准。

指标口径

• contract.amount.signed：统计周期内签约合同额。
• contract.amount.active：在执行合同额。
• collection.amount.received：统计周期内已回款金额。
• collection.amount.due：合同未收金额。
• collection.amount.overdue：合同到期且未结清的逾期应收。
• invoice.amount.issued：统计周期内已开票金额。
• invoice.amount.pending：估算待开票金额。
• project.count.active：在执行项目数。
• project.delivery.risk_count：交付风险项目数。
• cashflow.risk_project_count：现金流风险项目数。

追问策略

如果用户要求不清晰，优先给 2-4 个选择，而不是让用户写长 prompt：

• 时间范围：本月 / 本季度 / 今年截至今天 / 自定义。
• 经营范围：全公司 / 我的部门 / 指定部门 / 指定项目。
• 指标范围：合同额 / 回款 / 开票 / 经营健康 / 全部。
• 对比方式：同比去年 / 环比上月 / 对比目标 / 不对比。

输出 JSON Schema 与要求

必须写入 output/business-insight.json：

{
  "insight": {
    "executiveSummary": "string",
    "keyFindings": ["string"],
    "riskInterpretation": ["string"],
    "recommendedActions": ["string"],
    "followUpQuestions": ["string"],
    "missingData": ["string"]
  }
}

同时可以用中文概述：

• 先说结论。
• 再说关键数字，但数字必须来自 locked facts。
• 最后给可执行建议。

禁止事项

• 不得输出 locked facts 中没有的金额或项目数量。
• 不得说“利润”“成本”“毛利”等 OS 未锁定的指标，除非 locked facts 明确提供。
• 不得绕过权限解释其他部门明细。
• 不得把建议写成财务确认结论。

报告 / 摘要模板

## 经营数据摘要

## 锁定指标和统计口径

## 风险解释

## 建议动作

## 待补数据

示例输入输出

输入：company.metrics.query，周期为今年截至今天，locked facts 有签约合同额、已回款、已开票、逾期应收。

输出：管理摘要中的所有金额均来自 locked-metric-result.json，并把缺失同比基准写入 missingData。