← 返回 Skills 市场
yukirang

customer-segment-eng

作者 yukirang · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
93
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install customer-segment-eng
功能描述
Analyze uploaded bank customer data to segment and profile customers by assets, transactions, and behavior, outputting clusters, statistics, and visual charts.
使用说明 (SKILL.md)

Customer Segmentation Skill

Financial customer segmentation analysis: Stratify customers based on assets, transaction behaviors, activity levels, and other dimensions, outputting actionable segmentation results and visualizations.

Workflow

Step 1 — Data Loading and Cleaning

Read user-uploaded CSV or Excel files, automatically identifying column names.

Priority fields to retain:

  • customer_id / 客户ID — Unique customer identifier
  • age / 年龄
  • gender / 性别
  • balance / 资产余额
  • txn_amount / 交易金额
  • txn_count / 交易次数
  • last_date / 最近交易日期
  • product_count / 持有产品数
  • branch / 网点

Missing value handling:

  • Numeric: Fill with median
  • Categorical: Fill with mode
  • Columns with >30% missing: Delete and notify user
import pandas as pd

df = pd.read_csv(file_path)
df.columns = df.columns.str.strip().str.lower()

Step 2 — Feature Engineering

Build RFM + extended features:

Feature Description
Recency Days since last transaction (smaller = more active)
Frequency Transaction frequency (number of transactions in specified period)
Monetary Transaction amount (total amount in specified period)
Tenure Customer duration (months)
Product_Depth Number of products held
Age Customer age

Data standardization: Use StandardScaler (Z-score) to normalize all numeric features.

Step 3 — Clustering Analysis

Use K-Means algorithm, automatically determine K value (Elbow Method, SSE inflection point).

from sklearn.cluster import KMeans
from sklearn.preprocessing import StandardScaler

scaler = StandardScaler()
X_scaled = scaler.fit_transform(features)

# Elbow method to find optimal K
sse = {}
for k in range(2, 10):
    km = KMeans(n_clusters=k, random_state=42, n_init=10)
    km.fit(X_scaled)
    sse[k] = km.inertia_
optimal_k = min(sse, key=sse.get)  # Simply take k with minimum SSE

K=5 can also be fixed based on business needs (high/medium-high/medium/medium-low/low value customers).

Step 4 — Segment Profiling

Output core statistics for each cluster:

Cluster 0 (High-Value Customers): Avg. assets 850k, Avg. transaction frequency 28/month, Gender distribution 62% male
Cluster 1 (Potential Customers): Avg. assets 320k,明显 younger trend
...

Recommended label system (five categories):

  • 🌟 High-Value Customers (VIP)
  • ⬆️ Potential Customers
  • 🟢 Stable Customers
  • 🔄 Active Transaction Customers
  • ⚠️ Dormant/Churn Warning Customers

Step 5 — Visualization

Generate the following charts (saved as PNG):

  1. Customer Asset Distribution Histogram — Asset distribution comparison across levels
  2. Radar Chart — Feature comparison across segments
  3. Heatmap — Cluster feature mean matrix
  4. Scatter Plot — Customer distribution with assets × transaction frequency as coordinates
import matplotlib.pyplot as plt
import matplotlib
matplotlib.use('Agg')
plt.rcParams['font.sans-serif'] = ['WenQuanYi Micro Hei', 'SimHei']

fig, axes = plt.subplots(1, 2, figsize=(14, 5))
# Asset distribution
axes[0].hist([g['balance'] for _, g in df.groupby('cluster')], bins=30, label=[f'C{i}' for i in range(k)])
axes[0].set_title('Customer Balance Distribution by Cluster')
# Heatmap
import seaborn as sns
sns.heatmap(cluster_means.T, annot=True, fmt='.1f', ax=axes[1])
axes[1].set_title('Cluster Feature Heatmap')
plt.tight_layout()
plt.savefig(output_path, dpi=150)

Step 6 — Output Results

Output content:

  1. Segmentation result table (including customer ID, cluster, segmentation label) → segmentation_results.csv
  2. Cluster feature statistics → cluster_summary.csv
  3. Visualization charts → segmentation_charts.png
  4. Analysis summary (Markdown format) → segmentation_report.md

For detailed clustering and parameter documentation:

  • RFM model explanation: Refer to references/rfm-guide.md
  • Clustering parameter explanation: Refer to references/clustering-guide.md
安全使用建议
This skill appears coherent and implements customer segmentation as advertised, but it processes sensitive financial and personally identifiable data. Before installing/running: (1) Verify where outputs are written and ensure they stay on trusted storage; (2) Confirm the runtime environment has no network egress or is monitored if data must remain private; (3) Review and test the script on synthetic or anonymized data first (there are minor logic issues such as a simplistic 'optimal_k' selection in the SKILL.md example); (4) Ensure compliance with data protection rules (masking/desensitization, retention policies, and non-discriminatory use); (5) Pin or vet Python package versions you install to avoid dependency supply-chain risks. If those controls are acceptable, the skill is internally consistent with its stated purpose.
功能分析
Type: OpenClaw Skill Name: customer-segment-eng Version: 1.0.0 The skill bundle provides a legitimate customer segmentation tool using K-Means clustering for financial data analysis. The Python script (scripts/segment.py) and instructions (SKILL.md) focus entirely on data processing, feature engineering, and visualization using standard libraries like pandas and scikit-learn, with no evidence of data exfiltration, unauthorized execution, or malicious prompt injection.
能力评估
Purpose & Capability
Name/description match the provided SKILL.md and the included scripts. The Python script implements feature engineering, K-Means clustering, profiling, and chart generation — exactly what the skill says it will do. There are no unrelated environment variables, binaries, or config paths requested.
Instruction Scope
Instructions and code focus on reading user-uploaded CSV/Excel files, cleaning, feature engineering, clustering, and producing CSV/PNG/MD outputs. The skill will therefore handle sensitive bank/customer data (PII/financial). There are no instructions to read other system files, environment variables, or to transmit data externally, but the operator should confirm the runtime environment prevents unintended exfiltration.
Install Mechanism
No install spec is provided (instruction-only plus included script). Nothing is downloaded or extracted; the skill relies on standard Python libraries (pandas, scikit-learn, matplotlib, seaborn) which are expected for this task.
Credentials
The skill requests no credentials, env vars, or config paths. Its resource needs (CPU/memory when clustering large datasets) are proportional to the task. No broad or unrelated secrets are requested.
Persistence & Privilege
always is false and the skill does not request permanent system presence or attempt to modify other skills. It writes output files to a provided output directory (normal for this use case).
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install customer-segment-eng
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /customer-segment-eng 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Customer Segmentation Skill v1.0.0 - Automatically analyzes financial customer data upon CSV/Excel upload or user request (“analyze customers”, “customer segmentation”). - Performs data cleaning, missing value handling, and feature engineering (RFM model + extended attributes). - Applies K-Means clustering (auto K detection or fixed K=5) to generate customer segments. - Outputs segmentation labels, statistical summaries, and assigns five intuitive customer categories. - Produces key visualizations (histogram, radar chart, heatmap, scatter plot) and exports all results (tables, charts, Markdown reports) for easy sharing. - All major processing steps (cleaning, clustering, profiling, visualization, output) are automated for streamlined analysis.
元数据
Slug customer-segment-eng
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

customer-segment-eng 是什么?

Analyze uploaded bank customer data to segment and profile customers by assets, transactions, and behavior, outputting clusters, statistics, and visual charts. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 93 次。

如何安装 customer-segment-eng?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install customer-segment-eng」即可一键安装,无需额外配置。

customer-segment-eng 是免费的吗?

是的,customer-segment-eng 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

customer-segment-eng 支持哪些平台?

customer-segment-eng 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 customer-segment-eng?

由 yukirang(@yukirang)开发并维护,当前版本 v1.0.0。

💬 留言讨论