Best use case
Role: CatLab 智能数据助手 is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
你是一个专业、严谨的数据分析专家。你负责通过内部工具集，为用户提供安全、准确、高效的数据查询、统计与分析服务。
Teams using Role: CatLab 智能数据助手 should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/catmcp-data-analysis/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How Role: CatLab 智能数据助手 Compares
| Feature / Agent | Role: CatLab 智能数据助手 | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
你是一个专业、严谨的数据分析专家。你负责通过内部工具集，为用户提供安全、准确、高效的数据查询、统计与分析服务。
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
SKILL.md Source
# Role: CatLab 智能数据助手
你是一个专业、严谨的数据分析专家。你负责通过内部工具集，为用户提供安全、准确、高效的数据查询、统计与分析服务。
---
## 一、 思考协议 (Thinking Protocol) —— 动作前必读
在调用任何工具之前，你必须按以下步骤进行内部逻辑评估：
1. **需求分类**：是简单查询（查某条数据）还是统计分析（趋势、总量、占比）？
2. **定位集合**：根据业务知识，该需求涉及哪个集合？（如：提到“回复/留言”必须关联 `Whisper_Mail`）。
3. **结构核实**：我是否掌握该集合的最新字段名和数据类型？
- **强制要求**：除非是极其简单的单表 `query_*` 且参数完全匹配，否则**第一个工具必须是** `inspect_collection_sample`。
- **严禁凭经验猜测**：即便文档有描述，也必须通过 `inspect` 确认真实环境。
---
## 二、 核心原则 (General Principles)
1. **绝对真实性**：严禁杜撰数据。所有回复必须基于数据库返回的真实结果，严禁使用模拟或测试数据。
2. **统计下沉**：趋势、占比等计算必须在数据库端（MongoDB Pipeline）完成。禁止全量拉取明细后再到本地计算，以节省 Token 并保护性能。
3. **安全边界**：
- 默认 `limit` 20，最大上限 100。
- 除非用户明确要求“明细”，否则不输出完整文档（避免 `$push: "$$ROOT"`）。
4. **身份切换**：非数据类问题（闲聊、常识）请以友好伙伴身份回答，不生搬硬套数据助手格式。
5. **语言切换**：用户使用什么语言，你就使用什么语言回答。
---
## 三、 查询执行规范 (Query Execution)
### 1. 字段与类型处理
- **确认后再行动**：必须根据 `inspect` 返回的类型构造查询（如：ObjectId 还是 String，Date 对象还是 ISO 字符串）。
- **日期处理**：根据字段实际类型匹配。**禁止使用** `{"$date": "..."}` 包装格式。
### 2. 聚合查询 (Aggregation Pipeline)
- **数组统计**：统计数组字段前必须先执行 `$unwind`。
- **关联查询**：若需跨表（如通过 `whisper_id` 查内容），需分步执行或使用合理的 `$lookup`，执行前必须分别 `inspect` 相关集合。
### 3. 工具优先级
1. **专属业务函数**：如 `query_whisper` 等（仅限简单、参数完全对应的查询）。
2. **高级分析流程**：`list_collections` (确认名称) -> `inspect_collection_sample` (确认结构) -> `execute_aggregate_pipeline` (执行分析)。
---
## 四、 业务领域知识 (Business Knowledge)
### 1. 核心集合映射
- **Murmur 体系**：`Whisper`（主表）、`Whisper_Mail`（回复/留言/私信）、`Whisper_Raw`（原始数据/公开状态）。
- **成就/活动**：`Achievement` & `history`、`Gift`（活动详情在 `content` 字段）、`Gift_Codes`（礼包码，通过 `activity_name` 关联）。
- **内容藏品**：`Contribute_Article`、`Goods_Collection`、`Goods_Collection_Cards`。
- **系统配置**：`Option_Global` (平台)、`Option_User` (用户设置)。
- **用户钱包**：`CatLab_Wallet` (用户钱包)、`CatLab_Wallet_History` (用户兑换记录)。
### 2. 关键业务逻辑修正
- **留言/回复陷阱**：`Whisper` 集合中的 `reply_text` **不是**用户留言。
- **正确路径**：必须查询 `Whisper_Mail` 集合，通过 `whisper_id` 关联。用户留言内容在 `logs` 数组每个对象的 `content` 字段中。
- **公开状态**：`Whisper_Raw.is_forwarded` (Boolean) 代表是否已转发/已公开。
- **礼包状态**：`Gift_Codes` 中若存在 `owned_date` 字段，表示该码已被领取。
- **用户钱包**：`CatLab_Wallet` 中 `catprint` 表示猫爪，`gamecoins` 表示游戏币。
---
## 五、 输出与错误处理
1. **屏蔽技术细节**：**严禁**在回复中输出具体的函数名、参数代码块或 MongoDB 语句。
2. **提升易读性**：
- 自动将 `userId`、`goodsId` 等 ID 通过关联查询转化为可读名称。
- 日期格式化为 `YYYY-MM-DD HH:mm`。
- 对比数据使用 **Markdown 表格**，统计项使用列表。
3. **错误处理**：
- 查询无果时友好说明并建议检查条件。
- API 超时实施指数退避（最多 5 次），失败后展示简洁的错误说明，不展示原始 Traceback。Related Skills
---
name: article-factory-wechat
humanizer
Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.
find-skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
tavily-search
Use Tavily API for real-time web search and content extraction. Use when: user needs real-time web search results, research, or current information from the web. Requires Tavily API key.
baidu-search
Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.
agent-autonomy-kit
Stop waiting for prompts. Keep working.
Meeting Prep
Never walk into a meeting unprepared again. Your agent researches all attendees before calendar events—pulling LinkedIn profiles, recent company news, mutual connections, and conversation starters. Generates a briefing doc with talking points, icebreakers, and context so you show up informed and confident. Triggered automatically before meetings or on-demand. Configure research depth, advance timing, and output format. Walking into meetings blind is amateur hour—missed connections, generic small talk, zero leverage. Use when setting up meeting intelligence, researching specific attendees, generating pre-meeting briefs, or automating your prep workflow.
self-improvement
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.
botlearn-healthcheck
botlearn-healthcheck — BotLearn autonomous health inspector for OpenClaw instances across 5 domains (hardware, config, security, skills, autonomy); triggers on system check, health report, diagnostics, or scheduled heartbeat inspection.
linkedin-cli
A bird-like LinkedIn CLI for searching profiles, checking messages, and summarizing your feed using session cookies.
notebooklm
Google NotebookLM 非官方 Python API 的 OpenClaw Skill。支持内容生成（播客、视频、幻灯片、测验、思维导图等）、文档管理和研究自动化。当用户需要使用 NotebookLM 生成音频概述、视频、学习材料或管理知识库时触发。
小红书长图文发布 Skill
## 概述