AgentSkillsCN

gitsite-content-manager

自动管理GitSite静态网站生成器项目的博客、书籍与页面内容。当用户需要创建博客文章、书籍章节、书籍，或静态页面时，这一技能将自动构建正确的目录结构，生成带有完整Frontmatter的Markdown模板文件，并提供内容管理的Python脚本。适用于使用GitSite CLI构建的静态网站项目。

SKILL.md
--- frontmatter
name: gitsite-content-manager
description: 自动管理 GitSite 静态网站生成器项目的 blogs、books 和 pages 内容。当用户需要创建博客文章、书籍章节、书籍或静态页面时使用此 skill。该 skill 会自动创建正确的目录结构、生成带有完整 frontmatter 的 Markdown 模板文件，并提供内容管理的 Python 脚本。适用于使用 GitSite CLI 构建的静态网站项目。

GitSite Content Manager

Overview

此 skill 专为使用 GitSite 静态网站生成器的项目设计，用于自动化管理网站内容（blogs、books 和 pages）。GitSite 使用特定的目录结构和 YAML 配置文件，每次手动创建内容时容易忘记正确的配置格式和文件位置。此 skill 确保内容创建的一致性和正确性。

Quick Start

当用户请求创建以下任何内容时，使用此 skill：

  • •创建新的博客文章
  • •创建新的书籍
  • •创建新的书籍章节
  • •创建新的静态页面

Content Creation Workflow

1. 创建博客文章 (Blog Post)

目录结构：

code
source/blogs/tech/
└── YYYY-MM-DD-post-slug/
    └── README.md

使用 Python 脚本创建：

bash
python3 .claude/skills/gitsite-content-manager/scripts/manage_content.py blog \
  --title "My Blog Post Title" \
  --date "2025-01-15" \
  --description "A description of the post" \
  --tags tech tutorial \
  --author "Orangon"

手动创建步骤：

  1. •在 source/blogs/tech/ 下创建日期目录，格式：YYYY-MM-DD-title-slug/
  2. •创建 README.md 文件，包含以下 frontmatter：
yaml
---
title: "Blog Post Title"
date: 2025-01-15
description: "Blog post description"
tags:
  - tech
  - tutorial
author: Orangon
---

# Blog Post Title

<!-- Write your blog post content here -->

## Introduction

<!-- Add your introduction -->

## Main Content

<!-- Add your main content -->

## Conclusion

<!-- Add your conclusion -->

2. 创建书籍 (Book)

目录结构：

code
source/books/
└── book-name/
    ├── book.yml
    ├── index.md
    └── 01-Chapter-One/
        └── README.md

使用 Python 脚本创建：

bash
python3 .claude/skills/gitsite-content-manager/scripts/manage_content.py book \
  --name "My-Book" \
  --title "My Book Title" \
  --description "Book description" \
  --author "Orangon"

手动创建步骤：

  1. •在 source/books/ 下创建书籍目录
  2. •创建 book.yml 配置文件：
yaml
title: My Book Title
description: Book description
author: Orangon
  1. •创建 index.md 作为书籍索引页面

3. 创建书籍章节 (Book Chapter)

使用 Python 脚本创建：

bash
python3 .claude/skills/gitsite-content-manager/scripts/manage_content.py chapter \
  --book "My-Book" \
  --number "01" \
  --title "Chapter One" \
  --description "Chapter description"

手动创建步骤：

  1. •在书籍目录下创建章节目录，格式：XX-Chapter-Title/
  2. •创建 README.md 文件：
yaml
---
title: "Chapter One"
description: "Chapter description"
---

# 01. Chapter One

<!-- Write your chapter content here -->

## Overview

<!-- Add chapter overview -->

## Main Content

<!-- Add your main content -->

## Summary

<!-- Add chapter summary -->

## References

<!-- Add references if needed -->

4. 创建静态页面 (Page)

目录结构：

code
source/pages/
└── page-name/
    └── README.md

使用 Python 脚本创建：

bash
python3 .claude/skills/gitsite-content-manager/scripts/manage_content.py page \
  --name "about" \
  --title "About Us" \
  --description "About page description"

手动创建步骤：

  1. •在 source/pages/ 下创建页面目录
  2. •创建 README.md 文件：
yaml
---
title: "About Us"
description: "About page description"
---

# About Us

<!-- Write your page content here -->

Templates

使用 assets/templates/ 中的模板文件作为内容创建的基础：

  • •blog_post.md - 博客文章模板
  • •book_chapter.md - 书籍章节模板
  • •page.md - 静态页面模板

这些模板包含完整的 frontmatter 结构和内容大纲。

Important Notes

目录命名规范

  1. •博客文章：使用日期格式 YYYY-MM-DD-title-slug/
  2. •书籍章节：使用编号前缀 XX-Chapter-Title/ (如 01-Introduction/)
  3. •书籍目录：使用 kebab-case 命名 (如 AI-Coding/)
  4. •页面目录：使用 kebab-case 命名 (如 about-me/)

Frontmatter 格式

所有内容文件必须包含 YAML frontmatter，基本格式：

yaml
---
title: "Content Title"
description: "Content description"
---

博客文章额外需要：

  • •date: 发布日期
  • •tags: 标签列表
  • •author: 作者名称

配置文件位置

  • •网站配置：source/site.yml (主配置)
  • •博客配置：source/blogs/tech/blog.yml
  • •书籍配置：source/books/[book-name]/book.yml
  • •页面配置：无需单独配置文件

URL 生成规则

GitSite 自动根据目录结构生成 URL：

  • •博客：/blogs/tech/YYYY-MM-DD-title-slug/index.html
  • •书籍：/books/book-name/XX-Chapter-Title/index.html
  • •页面：/pages/page-name/index.html

Verification

创建内容后，验证构建是否成功：

bash
# 构建网站
gitsite-cli build -o _site -v

# 或启动开发服务器预览
gitsite-cli serve

检查生成的 HTML 文件是否存在于 _site/ 目录中。

Common Pitfalls

  1. •忘记创建 book.yml：书籍目录必须有 book.yml 配置文件
  2. •目录命名错误：使用空格或特殊字符会导致构建失败
  3. •缺少 README.md：每个内容目录必须有 README.md 文件
  4. •Frontmatter 格式错误：YAML 格式必须正确，注意引号和缩进
  5. •日期格式错误：博客日期必须使用 YYYY-MM-DD 格式

Resources

scripts/manage_content.py

Python 脚本提供命令行接口用于创建各种类型的内容。支持以下命令：

  • •blog - 创建博客文章
  • •book - 创建书籍
  • •chapter - 创建书籍章节
  • •page - 创建静态页面

使用 --help 查看完整参数说明。

assets/templates/

包含各类内容模板文件，可直接复制使用或作为参考：

  • •blog_post.md - 完整的博客文章模板
  • •book_chapter.md - 完整的书籍章节模板
  • •page.md - 完整的静态页面模板

模板文件使用 {{variable}} 占位符，使用时需要替换为实际内容。