CeeCore 技能开发入门：从零创建你的第一个自定义技能

技能市场里现在有 8 个技能——天气预报、日报生成、代码审查、英语陪练……但迟早，你会遇到一个需求：现有的技能都不太对，你想要的，市场上没有。

这时候你有两个选择：等别人做，或者自己动手。

自己动手，比你想象的要简单。CeeCore 的技能本质上是一个「说明书」——告诉 AI 你希望它做什么、怎么做、用什么工具。不需要编程基础，只需要想清楚一件事：你到底想让 AI 替你做什么。

这篇教程带你从零开始，创建一个真正能用的自定义技能。

技能是什么

一个 CeeCore 技能，包含三个文件：

my-skill/
├── manifest.json   # 技能的「身份证」：名称、版本、分类、权限
├── prompt.md       # 技能的「大脑」：告诉 AI 怎么干活
└── icon.svg        # 技能的「头像」：在技能市场里显示的图标

核心只有一个文件：prompt.md。它是一条指令，Agent 在激活这个技能时会读取它，然后按照你写的规则去执行任务。

换句话说，创建技能 = 给 AI 写一份「工作说明书」。

第一步：想清楚你的技能解决什么问题

在动手写之前，先回答三个问题：

这个技能做什么？ 一句话说清楚，能说清楚说明你真的想清楚了。
什么时候用？ 是用户主动触发，还是定时自动运行？
输出什么？ 用户最后拿到的是什么——一段文字、一个文件、一条通知？

举个例子。假设你每天要处理大量邮件，但你真正关心的只有两类：客户发来的需求变更，和团队发来的进度汇报。你希望 AI 帮你过滤掉无关邮件，只把这两类挑出来，按优先级排好。

那么你的技能定义就是：

做什么：自动筛选邮件，只保留客户需求变更和团队进度汇报
什么时候用：每天早上 8 点自动运行
输出什么：一份按优先级排序的邮件摘要

第二步：创建 manifest.json

先创建技能的「身份证」。在 src/content/skills/ 下新建一个文件夹，比如 email-filter，然后创建 manifest.json：

{
  "id": "email-filter",
  "name": "邮件智能筛选",
  "version": "1.0.0",
  "author": {
    "name": "你的名字",
    "avatar": "/images/default-avatar.svg",
    "url": ""
  },
  "description": "自动筛选邮件，只保留客户需求变更和团队进度汇报，按优先级排序输出",
  "category": "office",
  "tags": ["邮件", "筛选", "自动化", "办公"],
  "price": "free",
  "rating": 0,
  "installs": 0,
  "minCeeCoreVersion": "1.0.0",
  "dependencies": {},
  "permissions": ["email", "file-read"],
  "createdAt": "2026-08-31T00:00:00Z",
  "updatedAt": "2026-08-31T00:00:00Z"
}

几个关键字段说明：

字段	说明
`category`	分类，从 8 个大类中选：`chat`（对话）、`automation`（自动化）、`office`（办公）、`integration`（集成）、`data-analysis`（数据分析）、`lifestyle`（生活）、`developer`（开发）、`security`（安全）
`permissions`	技能需要的权限，如 `email`（邮件）、`file-read`（读文件）、`http`（网络请求）、`cron`（定时任务）
`minCeeCoreVersion`	最低要求的 CeeCore 版本

第三步：写 prompt.md——这是技能的灵魂

prompt.md 是技能的核心。Agent 会读取这个文件，然后按照里面的指令工作。

好 prompt 的结构：

# 角色定义

你是一个邮件筛选助手。你的任务是每天检查用户的收件箱，筛选出重要的邮件。

# 筛选规则

## 需要保留的邮件（满足任一条件即可）

1. **客户需求变更**：邮件主题或正文包含「需求变更」「需求调整」「需求更新」「scope change」等关键词
2. **团队进度汇报**：邮件主题或正文包含「进度」「周报」「日报」「进展」「完成」等关键词

## 需要忽略的邮件

- 新闻订阅、营销邮件、系统通知
- 自动回复、日历邀请
- 已标记为「不重要」的邮件

# 输出格式

按以下格式输出，每封邮件包含：

📧 邮件标题 发件人：xxx 时间：yyy 优先级：🔴高 / 🟡中 / 🟢低摘要：一句话概括邮件内容建议：是否需要回复 / 何时回复


# 优先级判断

- 🔴 高：客户需求变更，或邮件中提到「紧急」「ASAP」
- 🟡 中：团队进度汇报，或邮件中提到「本周内」
- 🟢 低：其他需要关注但不紧急的邮件

# 注意事项

- 如果当天没有需要保留的邮件，输出「今天没有需要关注的重要邮件 ✓」
- 对每封需要保留的邮件，给出明确的回复建议
- 不要输出邮件的完整正文，只给摘要

写 prompt 的四个原则

1. 定义角色，不要只给指令

开头写清楚「你是一个邮件筛选助手」，而不是直接说「检查邮件」。角色定义让 Agent 理解自己的定位，这比单纯列指令效果好得多。

2. 说清楚「不做什么」

很多 prompt 只写「要做什么」，忘了写「不要做什么」。但「不做什么」往往比「要做什么」更重要——它决定了 Agent 不会把时间浪费在无关的事情上。

3. 给输出格式，不给自由度

「整理一下邮件」这种模糊指令，Agent 会用自己的方式输出，结果可能跟你预期的不一样。直接给出输出格式模板，Agent 就能准确执行。

4. 考虑边界情况

当天没有需要保留的邮件怎么办？Agent 不知道该输出什么时，可能会自己编一封。提前写好「没有邮件时的输出」，就能避免这个问题。

第四步：创建图标

icon.svg 是技能在技能市场里显示的图标。可以是一个简单的 SVG：

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
  <rect width="512" height="512" rx="100" fill="#6366F1"/>
  <text x="256" y="320" font-size="280" text-anchor="middle" fill="white">📧</text>
</svg>

用 emoji 做图标就够了，不需要设计能力。把 #6366F1 换成你喜欢的颜色，📧 换成跟你技能相关的 emoji。

第五步：装到 CeeCore 上测试

把你的技能文件夹放到 CeeCore 设备的技能目录中，然后在 App 里激活它。

激活后，跟 Agent 说：

「用邮件筛选技能，帮我检查今天的邮件。」

Agent 会读取你的 prompt.md，按照你定义的规则执行筛选。如果结果不对，回头改 prompt.md——调整关键词、修改输出格式、补充边界条件。prompt 是可以迭代的，第一次不一定完美，用几次之后你会知道哪里需要改。

想让更多人用到你的技能？

如果你的技能解决了一个通用问题，可以考虑提交到技能市场。在 CeeCore 社区里提交一个 PR，附上你的技能文件夹和一段使用说明，审核通过后就会出现在技能市场里。

目前技能市场已经有 8 个技能——天气预报、日报生成、代码审查、英语陪练、飞书通知、数据看板、会议纪要、菜谱推荐。你的技能可能是第 9 个。

总结

创建一个 CeeCore 技能，只需要做五件事：

想清楚技能解决什么问题
写好 manifest.json（身份证）
写好 prompt.md（灵魂）
画一个 icon.svg（头像）
装到设备上测试，迭代

不需要写代码，不需要学框架。你只需要想清楚一件事，然后把它写下来。

试试看。你的第一个技能，可能就在今天。