← 返回 Skills 市场
richard052317

Cost Report Generator

作者 Richard052317 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
64
总下载
0
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install cost-report-generator
功能描述
从项目费用 Excel 文件（如 EVP 项目费用.xlsx）自动生成按客户分类的成本分析报告。支持帝国、BAT、MT、ITMS 等客户分类，包含 2025 年和 2026 年成本分析，自动计算年度汇总、月度明细、月均数据。使用场景：用户发送类似"EVP 项目费用.xlsx"的文件并要求生成成本分析报告，或提到"...
使用说明 (SKILL.md)

成本分析报告生成器

从项目费用 Excel 文件自动生成按客户分类的成本分析报告。

触发条件

当用户：

  • 上传类似 EVP 项目费用.xlsx 的文件并要求生成成本分析报告
  • 提到"按客户分类生成成本报告"、"提炼成本分析"、"整理项目费用"
  • 发送包含客户费用数据的 Excel 文件

核心功能

  1. 自动识别客户分类：帝国、BAT、MT、ITMS 等
  2. 费用分类汇总：
    • HR 费用（人工费用）
    • 试产/打样费用（打样 + 制造 + 物料耗用）
    • 测试费用（测试 + 外发认证）
    • 开发投资（开模 + 改模）
    • 其他费用（IDC、品烟、其它、手板）
  3. 时间维度：2025 年（12 个月）、2026 年（1-2 月）
  4. 数据指标：年度汇总、月均、月度明细
  5. 格式化输出：千分符、两位小数、美化样式

使用方法

方式 1：直接运行脚本

python3 ~/.openclaw/workspace/skills/cost-report-generator/scripts/generate_cost_report.py \x3C源文件路径> [输出目录]

示例：

python3 ~/.openclaw/workspace/skills/cost-report-generator/scripts/generate_cost_report.py ~/Desktop/EVP_项目费用.xlsx

方式 2：通过 Python 调用

from scripts.generate_cost_report import generate_cost_report

output_file = generate_cost_report(
    source_file="/path/to/EVP_项目费用.xlsx",
    output_dir="/path/to/output"  # 可选，默认为源文件所在目录
)

输入文件格式

必需列

  • 客户大类：客户分类（帝国、BAT、MT、ITMS 等）
  • 项目大类：项目名称/类别
  • 内部订单号：订单编号

费用列（按年份和月份）

支持的费用类型：

  • 人工费用
  • 打样费用
  • 制造费用
  • 物料耗用
  • 测试费用
  • 外发认证费用
  • 开模费用
  • 改模费用
  • IDC 费用
  • 品烟费用
  • 其它费用
  • 手板费用

列名格式：{年份} 年{月份} 月{费用类型}，如：

  • 25 年 1 月人工费用
  • 25 年打样费用（年度汇总）
  • 26 年 1-2 月人工费用

表头位置

脚本默认使用第 4 行（索引 3）作为表头。如果源文件格式不同，需要调整 header 参数。

输出报告结构

工作表

  1. 2025 年成本分析：按客户分类展示 2025 年 1-12 月数据
  2. 2026 年成本分析：按客户分类展示 2026 年 1-2 月数据

列结构（每个客户分类）

列范围 内容
A-C 基本信息（客户大类、项目大类、内部订单号）
D-E HR 费用（汇总、月均）
F-R HR 费用月度明细（1-12 月）
S-T 试产/打样费用（汇总、月均）
U-AG 试产/打样费用月度明细
... 其他费用类别同理
最后两列 总计（汇总、月度合计）

样式特点（必须严格遵守）

  • 表头：深蓝色背景 (#2E74B5) + 白色文字，微软雅黑字体
  • 子标题：浅蓝色背景 (#D6EAF8) + 深色文字
  • 数据行：交替使用白色/浅灰色背景 (#F8F9FA)，便于阅读
  • 总计列：黄色高亮 (#FFEB9C) + 粗体，突出显示
  • 月度合计：绿色高亮 (#C6EFCE) + 粗体
  • 数字格式：#,##0.00（千分符 + 两位小数），所有数值统一
  • 对齐方式：文本左对齐，数字右对齐
  • 列宽：基本信息列加宽（14-20），月度列统一（10），总计列加宽（14）
  • 边框：细边框 + 浅灰色 (#CCCCCC)

月均计算逻辑

  • 2025 年：年度汇总 ÷ 12
  • 2026 年：年度汇总 ÷ 2（因为只有 1-2 月数据）

脚本会自动统计实际有数据的月份数，并按以下规则计算：

max_months = 2 if year == 2026 else 12
divisor = min(actual_months_count, max_months)
monthly_avg = monthly_sum / divisor

注意事项

  1. 表头位置：确保源文件的表头在第 4 行（索引 3），否则需要调整 header 参数
  2. 客户分类：只处理"帝国"、"BAT"、"MT"、"ITMS"四类，其他会被忽略
  3. 数据完整性：如果某些月份数据缺失，月均计算会自动调整除数
  4. 输出位置：默认保存到源文件所在目录，可通过 output_dir 参数指定

故障排除

问题：读取数据为空

原因：表头位置不正确

解决：检查源文件的表头位置，修改脚本中的 header 参数：

df = pd.read_excel(source_file, sheet_name='Sheet1', header=3)  # 调整为正确的行号

问题：费用数据为 0

原因：列名格式不匹配

解决：检查源文件的列名格式，确保包含"年"、"月"等关键字，如25 年 1 月人工费用

问题：客户分类缺失

原因：客户大类列的值与预期不符

解决：检查"客户大类"列的实际值，必要时在脚本的 valid_customers 列表中添加新的客户类型

相关文件

  • 脚本：scripts/generate_cost_report.py - 核心生成脚本

分享与发布

本地使用（当前用户）

技能已安装在 ~/.openclaw/workspace/skills/cost-report-generator/，当前 OpenClaw 会话可直接使用。

分享给其他飞书用户

方式 1：通过 ClawHub 发布（推荐）

# 1. 登录 ClawHub
clawhub login

# 2. 发布技能
clawhub publish ~/.openclaw/workspace/skills/cost-report-generator \
  --slug cost-report-generator \
  --name "成本分析报告生成器" \
  --version 1.0.0 \
  --changelog "初始版本：支持 EVP 项目费用文件自动生成成本分析报告"

其他用户安装：

clawhub install cost-report-generator

方式 2：直接共享技能文件夹

将 ~/.openclaw/workspace/skills/cost-report-generator/ 打包发送给其他用户，让他们放到自己的 ~/.openclaw/workspace/skills/ 目录下。

方式 3：通过 OpenClaw 团队空间

如果多个用户共享同一个 OpenClaw workspace，技能会自动对所有用户可见。

技能元数据（发布用）

name: cost-report-generator
version: 1.0.0
description: 从项目费用 Excel 自动生成按客户分类的成本分析报告
author: Richard 张
tags: [成本分析，财务报告，Excel, 飞书]
安全使用建议
This skill appears to be what it says (an Excel cost-report generator) and shows no network/exfiltration behavior, but there are practical inconsistencies you should address before trusting it with real data: - Header-row mismatch: SKILL.md instructs the header is on row 4 (index 3) but the script currently reads header=1. Test the script on a representative Excel file and adjust the header parameter in code or when calling the function to ensure correct parsing. Incorrect header selection will produce empty or wrong aggregations. - Missing dependency instructions: The script requires pandas and openpyxl. Install them (e.g., pip install pandas openpyxl) before running. - CLI behavior: The SKILL.md shows a CLI usage pattern; inspect the rest of the script (end of file) to confirm it implements argument parsing. If not, call the function from Python as shown. - Styling/fonts: The script uses the font '微软雅黑' and strict colors; if that font isn't available on your system, Excel output may render differently. This is a usability issue, not a security issue. - Data scope: Only rows with customer types ['帝国','BAT','MT','ITMS'] are processed; other customer values will be ignored. Make sure your data matches these values or update valid_customers. Recommended safe steps: run the script on a small non-sensitive sample first, inspect the generated workbook, and if you plan to use it in production add a requirements note or a small install script to install dependencies and confirm header/column naming expectations.
能力评估
ℹ Purpose & Capability
Name/description align with the included Python script: the script reads an Excel file, aggregates costs by customer categories, and writes a styled workbook. However, the SKILL.md does not declare required Python packages (pandas, openpyxl) and the documentation's claimed default header row (第 4 行 / index 3) does not match the script's current pd.read_excel header=1; that mismatch is functionally important.
⚠ Instruction Scope
Instructions tell the agent/user to run the provided script locally and to call generate_cost_report() from Python. The script itself performs only local file I/O and Excel processing (no network, no env var access). The main concern: SKILL.md and the script disagree about default header row and some examples/comments in the script mention different header behavior (header=1 vs header index 3). This can cause empty reads or incorrect aggregation. Also SKILL.md requires very strict styling; the script attempts to apply those styles but relies on local fonts (微软雅黑) which may not exist.
ℹ Install Mechanism
There is no install spec (instruction-only), which is low risk, but the script has runtime dependencies (pandas, openpyxl) that are not declared. Users must install these themselves; the lack of declared dependencies is a usability and maintenance gap.
✓ Credentials
The skill does not request environment variables, credentials, or external config paths. It only works on local files supplied by the user and writes output locally — proportional to its purpose.
✓ Persistence & Privilege
always is false and the skill does not request persistent elevated privileges or modify other skills. Normal local execution only.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install cost-report-generator
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /cost-report-generator 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
- 首个版本发布，支持从项目费用 Excel 文件自动生成按客户分类的成本分析报告 - 自动识别客户分类（帝国、BAT、MT、ITMS），并进行多项费用和时间维度的详细分析 - 年度汇总、月均、月度明细等核心财务指标自动生成 - 输出报告严格美化，包括颜色、格式、对齐、边框和列宽等细节 - 支持命令行和 Python 两种方式调用，按需调整输入输出参数 - 提供完整的输入格式说明、常见问题排查和多种团队共享方式
元数据
Slug cost-report-generator
版本 1.0.0
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 1
常见问题

Cost Report Generator 是什么？

从项目费用 Excel 文件（如 EVP 项目费用.xlsx）自动生成按客户分类的成本分析报告。支持帝国、BAT、MT、ITMS 等客户分类，包含 2025 年和 2026 年成本分析，自动计算年度汇总、月度明细、月均数据。使用场景：用户发送类似"EVP 项目费用.xlsx"的文件并要求生成成本分析报告，或提到"... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 64 次。

如何安装 Cost Report Generator？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install cost-report-generator」即可一键安装，无需额外配置。

Cost Report Generator 是免费的吗？

是的，Cost Report Generator 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Cost Report Generator 支持哪些平台？

Cost Report Generator 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Cost Report Generator？

由 Richard052317（@richard052317）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论