SuperAPI AI 工具集

create-content

写作与研究

查看项目

更新于 10-16 06:57

技能介绍

用途

create-content 技能用于在 readme-pages 这个 Astro 站点项目中创建新的 Markdown 内容文件。当用户要求创建、添加或撰写新页面、笔记、文章或博客文章时,可以使用此技能。

主要内容类型

笔记(Notes)

存放于 src/content/notes/ 目录。适合博客文章、更新记录或时效性内容等带日期的条目。

  • 文件名约定:YYYY-MM-DD-slug.md(日期前缀可选,但建议加上)
  • 示例:2025-12-25-my-new-note.md
  • 日期会从文件名前缀自动提取

Frontmatter 示例字段:

---
title: "Note Title"           # 必填(省略时由文件名自动生成)
date: 2025-12-25              # 必填(从文件名自动提取或默认为今天)
description: "Summary"        # 可选,最多 500 字符
tags:                         # 可选,小写字母数字加连字符
  - javascript
  - tutorial
draft: false                  # 可选,设为 true 则不从发布中显示
---

页面(Pages)

存放于 src/content/pages/ 目录。属于无日期的常青文档页面。

  • 文件名约定:slug.md
  • 示例:getting-started.md

Frontmatter 示例字段:

---
title: "Page Title"           # 必填(省略时由文件名自动生成)
description: "Description"    # 可选,最多 500 字符
order: 1                      # 可选,控制侧边栏排序
---

使用方式

创建工作流如下:

创建新笔记:

  1. 根据用户主题确定 slug(kebab-case 格式)
  2. 使用今天的日期或指定日期
  3. 在 src/content/notes/YYYY-MM-DD-slug.md 创建文件
  4. 写入包含 title、date 以及可选 tags/description 的 frontmatter
  5. 添加 Markdown 正文内容

创建新页面:

  1. 根据用户主题确定 slug(kebab-case 格式)
  2. 在 src/content/pages/slug.md 创建文件
  3. 写入包含 title 以及可选 description/order 的 frontmatter
  4. 添加 Markdown 正文内容

创建内容时需向用户收集的信息:内容类型(笔记还是页面)、标题、正文内容(或询问是否由用户提供)、标签(仅笔记)、是否立即发布还是保存为草稿。

校验规则

  • 标题:1–200 字符,必填
  • 日期(仅笔记):必须在 2000-01-01 到当天之间(不得使用未来日期)
  • 标签:仅小写字母数字加连字符,每个 1–50 字符
  • 描述:最多 500 字符

自动生成

站点会自动处理以下内容:

  • 缺失的标题:由文件名生成(转换为 Title Case)
  • 缺失的日期(笔记):从 YYYY-MM-DD- 前缀提取,或默认为今天
  • 从标题生成目录
  • 阅读时间估算
  • 从 git 历史获取最后修改日期
  • 基于标签重叠生成相关笔记

示例

最简笔记:

---
title: "Getting Started with TypeScript"
date: 2025-12-25
tags:
  - typescript
  - tutorial
---

Your content here...

最简页面:

---
title: "Installation Guide"
order: 1
---

Your content here...

适用场景

适用于已使用 readme-pages(Astro)项目的用户,需要快速、规范地新建笔记或页面内容时。技能通过固定的目录结构、文件命名约定和 frontmatter 校验,保证内容格式一致。

限制

仅在 readme-pages 项目的目录结构与内容约定下工作。日期、标签、描述、标题等字段须符合上述校验规则,否则无法通过。资料未提供创建失败时的具体错误处理方式,也暂未提供该技能的具体安装命令。