mirror of
https://git.openapi.site/https://github.com/desirecore/market.git
synced 2026-06-06 05:50:41 +08:00
feat(skills): 新增 markdown 全局内置技能
This commit is contained in:
@@ -9,6 +9,7 @@
|
||||
"mail-operations",
|
||||
"manage-skills",
|
||||
"manage-teams",
|
||||
"markdown",
|
||||
"minimax-music-gen",
|
||||
"minimax-video-gen",
|
||||
"nodejs-runtime",
|
||||
|
||||
184
skills/markdown/SKILL.md
Normal file
184
skills/markdown/SKILL.md
Normal file
@@ -0,0 +1,184 @@
|
||||
---
|
||||
name: markdown
|
||||
description: >-
|
||||
Use this skill whenever the user wants to create, write, organize, or draft
|
||||
Markdown documents (.md files). Triggers include: any mention of
|
||||
"md", ".md", "markdown", or requests to produce written deliverables such
|
||||
as reports, summaries, plans, outlines, meeting notes, lists, tables,
|
||||
contracts, memos, weekly reports, or any text-based document without a
|
||||
specific format requirement (Word/PDF/Excel/PPT). When the user asks to
|
||||
"write a report", "organize a table", "draft a plan", "make a list", or
|
||||
similar — and does not specify a particular file format — default to
|
||||
Markdown. Do NOT use for binary document formats (.docx, .pdf, .xlsx,
|
||||
.pptx) — use the corresponding skill instead.
|
||||
Use when 用户提到 整理、准备、汇总、梳理、归纳、制作、生成、起草、编写、
|
||||
创建、文档、报告、表格、清单、方案、计划、总结、大纲、合同、纪要、周报、
|
||||
月报、邮件、对比分析、会议记录、散文、文章、作文、md、markdown、report、
|
||||
summary、plan、outline、memo、table、list、draft、document、notes、
|
||||
write、create、organize。
|
||||
version: 1.0.0
|
||||
type: procedural
|
||||
risk_level: low
|
||||
status: enabled
|
||||
disable-model-invocation: false
|
||||
tags:
|
||||
- markdown
|
||||
- md
|
||||
- document
|
||||
- text
|
||||
metadata:
|
||||
author: desirecore
|
||||
updated_at: '2026-05-11'
|
||||
i18n:
|
||||
default_locale: en-US
|
||||
source_locale: zh-CN
|
||||
locales:
|
||||
- zh-CN
|
||||
- en-US
|
||||
zh-CN:
|
||||
name: Markdown 文档处理
|
||||
short_desc: 创建、编辑 Markdown 文档(.md),默认文本文档格式
|
||||
description: >-
|
||||
当用户要求创建、撰写、整理任何书面产物且未指定特定格式时,使用此技能。
|
||||
确保使用 Write 工具写入文件、告知绝对路径、并通过 SendUserMessage 发送附件。
|
||||
body: ./SKILL.zh-CN.md
|
||||
source_hash: sha256:0000000000000000
|
||||
translated_by: human
|
||||
en-US:
|
||||
name: Markdown Document Processing
|
||||
short_desc: Create and edit Markdown documents (.md), the default text format
|
||||
description: >-
|
||||
Use when the user requests any written deliverable without specifying a
|
||||
particular format. Ensures files are written via Write tool, absolute
|
||||
path is reported, and attachment is sent via SendUserMessage.
|
||||
body: ./SKILL.md
|
||||
source_hash: sha256:0000000000000000
|
||||
translated_by: human
|
||||
market:
|
||||
icon: >-
|
||||
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
|
||||
24 24" fill="none"><defs><linearGradient id="md-a" x1="4" y1="2" x2="20"
|
||||
y2="22" gradientUnits="userSpaceOnUse"><stop stop-color="#007AFF"/><stop
|
||||
offset="1" stop-color="#34C759"/></linearGradient></defs><path d="M14
|
||||
2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"
|
||||
fill="url(#md-a)" fill-opacity="0.1" stroke="url(#md-a)"
|
||||
stroke-width="1.5"/><path d="M14 2v6h6" stroke="url(#md-a)"
|
||||
stroke-width="1.5" stroke-linejoin="round"/><text x="7" y="17"
|
||||
font-size="7" font-weight="bold" fill="url(#md-a)"
|
||||
font-family="Arial">MD</text></svg>
|
||||
category: productivity
|
||||
maintainer:
|
||||
name: DesireCore Official
|
||||
verified: true
|
||||
channel: latest
|
||||
---
|
||||
|
||||
# markdown Skill
|
||||
|
||||
## L0: One-line Summary
|
||||
|
||||
Create Markdown documents (.md) using the Write tool, with proper file output and delivery to the user.
|
||||
|
||||
## L1: Overview and Use Cases
|
||||
|
||||
### Capability
|
||||
|
||||
markdown is a **Procedural Skill** that serves as the default document format when users request written deliverables without specifying Word/PDF/Excel/PPT. Markdown files can be directly opened and edited in DesireCore's built-in SuperDoc editor.
|
||||
|
||||
### Use Cases
|
||||
|
||||
- The user asks to create a report, summary, plan, outline, or any written document
|
||||
- The user asks to organize information into a table or list
|
||||
- The user asks to draft a memo, meeting notes, weekly report, etc.
|
||||
- The user asks to "write something" or "make a document" without specifying format
|
||||
- The user explicitly mentions "md", "markdown", or ".md"
|
||||
|
||||
## L2: Detailed Specification
|
||||
|
||||
### Output Rule (CRITICAL — violation = task failure)
|
||||
|
||||
After you create a .md file using the Write tool, you **MUST** complete these **two** final steps:
|
||||
|
||||
**Final Step 1:** Output a text reply containing:
|
||||
- A brief summary of what was created or changed
|
||||
- The file's full absolute path (copied from the Write tool result)
|
||||
|
||||
Template:
|
||||
```
|
||||
已为你创建「文档标题」,简要说明内容。
|
||||
|
||||
📄 文件位置:`/full/absolute/path/filename.md`
|
||||
```
|
||||
|
||||
**Final Step 2:** Call `SendUserMessage` with the file as attachment. This **MUST** be your very last action. Do NOT output any text after this call.
|
||||
|
||||
```
|
||||
SendUserMessage({
|
||||
message: "📄 点击下方附件打开文件",
|
||||
attachments: ["/full/absolute/path/filename.md"]
|
||||
})
|
||||
```
|
||||
|
||||
#### Correct vs Wrong
|
||||
|
||||
- ✅ Write → text reply (with absolute path) → SendUserMessage (with attachment) → done
|
||||
- ❌ Write → text reply without absolute path
|
||||
- ❌ Write → no SendUserMessage
|
||||
- ❌ Write → SendUserMessage → more text output (e.g. "任务完成")
|
||||
- ❌ No Write at all, content output directly in chat
|
||||
|
||||
#### Forbidden
|
||||
|
||||
- Outputting the full document content directly in the chat reply instead of writing to a file
|
||||
- Saying "好的,已完成" / "整理好了" / "以下是内容" without calling Write tool
|
||||
- Only giving a filename (e.g. "报告.md") without the full absolute path
|
||||
- Not calling SendUserMessage to deliver the file attachment
|
||||
- Outputting any text after SendUserMessage
|
||||
- Writing memory files about the document creation task — creating/editing a document is a one-time task, NOT a user preference or fact to remember
|
||||
|
||||
### Overview
|
||||
|
||||
Markdown (.md) is a lightweight text format. The Write tool accepts the content directly — no compilation, no external dependencies. The file is immediately available for viewing in DesireCore's SuperDoc editor.
|
||||
|
||||
### Creating New Documents
|
||||
|
||||
#### Workflow
|
||||
|
||||
1. Determine content structure (headings, sections, tables)
|
||||
2. Choose file path: user specified > workspace directory
|
||||
3. Call Write tool with full absolute path + complete content
|
||||
4. Output text reply with summary + absolute path
|
||||
5. Call SendUserMessage with file attachment (last action)
|
||||
|
||||
#### File Naming
|
||||
|
||||
- Use descriptive names: `2026-05-11-项目进度表.md`, `会议纪要-产品评审.md`
|
||||
- Avoid generic names like `output.md` or `document.md`
|
||||
- Use the workspace directory as default location
|
||||
|
||||
#### Complete Example
|
||||
|
||||
User: "帮我整理一份项目进度表"
|
||||
|
||||
**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 |"
|
||||
})
|
||||
```
|
||||
|
||||
**Final Step 1** — Text reply:
|
||||
```
|
||||
已为你整理好「项目进度表」,包含各模块的当前状态、负责人和截止日期。
|
||||
|
||||
📄 文件位置:`/Users/zhangxinyuan/.desirecore-dev/users/.../workspace/2026-05-11-项目进度表.md`
|
||||
```
|
||||
|
||||
**Final Step 2** — SendUserMessage (last action):
|
||||
```
|
||||
SendUserMessage({
|
||||
message: "📄 点击下方附件打开文件",
|
||||
attachments: ["/Users/zhangxinyuan/.desirecore-dev/users/.../workspace/2026-05-11-项目进度表.md"]
|
||||
})
|
||||
```
|
||||
109
skills/markdown/SKILL.zh-CN.md
Normal file
109
skills/markdown/SKILL.zh-CN.md
Normal 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"]
|
||||
})
|
||||
```
|
||||
Reference in New Issue
Block a user