用途
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 # 可选,控制侧边栏排序
---
使用方式
创建工作流如下:
创建新笔记:
- 根据用户主题确定 slug(kebab-case 格式)
- 使用今天的日期或指定日期
- 在 src/content/notes/YYYY-MM-DD-slug.md 创建文件
- 写入包含 title、date 以及可选 tags/description 的 frontmatter
- 添加 Markdown 正文内容
创建新页面:
- 根据用户主题确定 slug(kebab-case 格式)
- 在 src/content/pages/slug.md 创建文件
- 写入包含 title 以及可选 description/order 的 frontmatter
- 添加 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 项目的目录结构与内容约定下工作。日期、标签、描述、标题等字段须符合上述校验规则,否则无法通过。资料未提供创建失败时的具体错误处理方式,也暂未提供该技能的具体安装命令。