写一个自己的 Skill：frontmatter 与正文契约

三条起步路线

1. 让工作台代写（推荐）——在AI 迭代工作台里描述需求，AI 起草、安装、挂载一条龙，和其他改动一样走 diff 审批
2. 管理面板里新建——技能管理面板的内嵌编辑器里直接写
3. 手写文件——想完全掌控措辞时的选择，往下看

手写 SKILL.md

---
name: my-skill-name
description: 一句话说明这个技能管什么
---

# my-skill-name

正文从这里开始。

• frontmatter——name 与 description 是必需的，描述写得越准，Agent 越容易在合适时机读它
• 正文——写法上要当「命令式文档」而不是百科：直接告诉 Agent "做什么、别做什么"
• 语气——写给模型看，不是写给运维手册的读者看，指令短句胜过铺陈
• 子文件——references/ 放延伸清单、examples/ 放范例，在正文里写明什么时候该去读哪个

篇幅与服务端限额

• 单次读取有约 50 KB 的硬上限，超长文件会被截断返回（Agent 可分段继续读）
• 所以最重要的规则放最前面——就算只读到前半段，契约也已经拿到

选作用域的经验法则

拿不准就先放全局，确认只跟一张卡有关再迁到卡作用域（面板里支持原子迁移）。

两个出厂实例的启示

• 反八股 Skill——单文件、约 3 KB、没有子文件：一条写作纪律就该这么轻
• 事件摘要纪律——约 12 KB 的密集 SKILL.md：给专职子代理的完整工作契约

共同点：单一职责、正文自包含、不追求大而全。

写完之后

在管理面板确认安装成功、作用域正确，再到编排器面板检查目标 Agent 能不能看到它，然后跑一两个回合验证效果，见用 Skill 调教文风。

限额与校验规则可能随版本调整，以官方最新版为准。