feat(skills): 新增 markdown 全局内置技能

This commit is contained in:
张馨元
2026-05-11 22:00:10 +08:00
parent 35e749e9f7
commit 0f68e665ac
3 changed files with 294 additions and 0 deletions

View File

@@ -0,0 +1,109 @@
# markdown Skill
## L0: 一句话摘要
使用 Write 工具创建 Markdown 文档(.md确保文件正确输出并交付给用户。
## L1: 概述与使用场景
### 能力
markdown 是一个**程序化技能**,作为用户请求书面产物时的默认文档格式(当用户未指定 Word/PDF/Excel/PPT 时。Markdown 文件可在 DesireCore 内置的 SuperDoc 编辑器中直接打开和编辑。
### 使用场景
- 用户要求创建报告、总结、方案、大纲或任何书面文档
- 用户要求整理信息为表格或清单
- 用户要求起草备忘录、会议纪要、周报等
- 用户说"写一份"、"整理一下"、"做一个文档"但未指定格式
- 用户明确提到"md"、"markdown"、".md"
## L2: 详细规范
### Output Rule关键规则 — 违反 = 任务失败)
当你使用 Write 工具创建 .md 文件后,**必须**完成以下两个最终步骤:
**最终步骤 1** 输出一段文字回复,包含:
- 内容简要说明(创建了什么 / 修改了什么)
- 文件的完整绝对路径(从 Write 工具返回结果中复制)
模板:
```
已为你创建「文档标题」,简要说明内容。
📄 文件位置:`/完整绝对路径/文件名.md`
```
**最终步骤 2** 调用 `SendUserMessage` 将文件作为附件发送。**必须是最后一个动作,之后不再输出任何文字。**
```
SendUserMessage({
message: "📄 点击下方附件打开文件",
attachments: ["/完整绝对路径/文件名.md"]
})
```
#### 正确 vs 错误
- ✅ Write → 文字回复(含绝对路径)→ SendUserMessage含附件→ 结束
- ❌ Write → 文字回复中没有绝对路径
- ❌ Write → 没有调用 SendUserMessage
- ❌ Write → SendUserMessage → 又输出文字(如"任务完成"
- ❌ 没有调用 Write内容直接输出在对话中
#### 禁止行为
- 将完整文档内容直接输出在回复中,不调用 Write 工具
- 回复"好的,已完成"、"整理好了"、"以下是内容"但未调用 Write
- 只给文件名(如"报告.md")不给完整绝对路径
- 不调用 SendUserMessage 发送附件
- 在 SendUserMessage 之后再输出任何文字
- 为文档创建/编辑任务写入记忆文件——创建或编辑文档是一次性任务,不是用户偏好或需要记住的事实
### 概述
Markdown.md是轻量级文本格式。Write 工具直接接受内容写入——无需编译、无需外部依赖。文件写入后可立即在 DesireCore 的 SuperDoc 编辑器中查看。
### 创建新文档
#### 工作流
1. 确定内容结构(标题、章节、表格)
2. 确定文件路径:用户指定 > 工作目录
3. 调用 Write 工具,使用完整绝对路径 + 完整内容
4. 输出文字回复:内容摘要 + 绝对路径
5. 调用 SendUserMessage 发送文件附件(最后一步)
#### 文件命名
- 使用描述性名称:`2026-05-11-项目进度表.md``会议纪要-产品评审.md`
- 避免泛用名称如 `output.md``document.md`
- 默认保存到工作目录
#### 完整示例
用户:"帮我整理一份项目进度表"
**Write**
```
Write({
file_path: "/Users/zhangxinyuan/.desirecore-dev/users/.../workspace/2026-05-11-项目进度表.md",
content: "# 项目进度表\n\n| 模块 | 状态 | 负责人 | 截止日期 |\n|------|------|--------|----------|\n| 认证模块 | 已完成 | 张三 | 2026-05-01 |\n| 支付模块 | 进行中 | 李四 | 2026-05-15 |"
})
```
**最终步骤 1** — 文字回复:
```
已为你整理好「项目进度表」,包含各模块的当前状态、负责人和截止日期。
📄 文件位置:`/Users/zhangxinyuan/.desirecore-dev/users/.../workspace/2026-05-11-项目进度表.md`
```
**最终步骤 2** — SendUserMessage最后一步
```
SendUserMessage({
message: "📄 点击下方附件打开文件",
attachments: ["/Users/zhangxinyuan/.desirecore-dev/users/.../workspace/2026-05-11-项目进度表.md"]
})
```