1
src/
2
├── content/
3
│   └── posts/
4
│       └── example-post/
5
│           └── index.md
6
├── content.config.ts
7
├── config/
8
│   ├── navBarConfig.ts
9
│   ├── sidebarConfig.ts
10
│   └── siteConfig.ts
11
└── pages/
12

13
public/
14
├── images/
15
└── assets/
16

17
package.json

1
src/content/posts/my-new-post/
2
├── index.md
3
└── image.png

1
请先阅读这个 Astro 博客项目的文章目录、content schema 和 package.json，
2
总结新建一篇文章需要遵守哪些 frontmatter 字段、目录结构和验证命令。
3
暂时不要修改文件。

1
# Project Guide
2

3
## Overview
4

5
- This is an Astro static blog.
6
- Use pnpm for dependency management.
7
- Blog posts live in `src/content/posts`.
8
- Each post should be a folder containing `index.md`.
9

10
## Writing Rules
11

12
- Write posts in Simplified Chinese unless the user asks otherwise.
13
- Use existing frontmatter style from nearby posts.
14
- Prefer practical tutorials with clear steps, commands, and notes.
15
- Do not invent external facts. Ask to verify or cite official sources when needed.
16

17
## Commands
18

19
- Start dev server: `pnpm dev`
20
- Type/content check: `pnpm check`
21
- Unit tests: `pnpm test`
22
- Production build: `pnpm build`
23

24
## Safety
25

26
- Do not edit generated files in `dist/`.
27
- Do not delete existing posts unless explicitly requested.
28
- Do not print secrets from `.env`.
29
- Ask before changing dependencies, deployment config, or licenses.
30

31
## Verification
32

33
- For content-only changes, run `pnpm check` when frontmatter or schema may be affected.
34
- Run `pnpm build` before publishing if routes, config, Markdown plugins, or images changed.
35
- Report any command that fails and include the relevant error summary.

1
帮我新建一篇文章，主题是“用 Cloudflare Workers 部署 Umami 代理”，
2
要求沿用当前博客的 frontmatter 格式，放在 src/content/posts/umami-worker-proxy-guide/index.md。
3
文章写成中文技术教程，包含背景、准备工作、部署步骤、常见问题和发布前检查。

1
我想写一篇关于 Astro 博客 SEO 优化的文章。
2
请先阅读现有文章风格，然后给我 3 个选题角度和推荐大纲。
3
暂时不要创建文件。

1
按你推荐的第 1 个方向写完整文章。
2
要求：
3
- 新建目录 src/content/posts/astro-seo-practical-checklist
4
- 正文不少于 2500 字
5
- 包含可执行命令
6
- 不要修改其它文章
7
- 写完后运行 pnpm check

1
帮我写篇博客。

1
帮我写一篇中文技术教程，主题是“WSL2 中安装 Kali Linux 并配置开发环境”。
2
读者是刚接触 Linux 的 Windows 用户。
3
文章结构包括：适用场景、安装 WSL2、安装 Kali、更新源、安装常用工具、VS Code 连接、常见问题。
4
放到 src/content/posts/wsl2-kali-linux-guide/index.md。

1
请帮我把导航栏里增加一个“AI工具”入口。
2
先阅读 src/config/navBarConfig.ts 和相关页面路由，
3
确认现有写法后再修改。
4
修改完成后运行 pnpm check。

1
请检查 src/content/posts 下所有文章的 tags，
2
找出“AI编程”“AI 编程”“人工智能编程”这类可能重复的标签。
3
先给我一份归并建议，不要直接修改。

1
按刚才的归并建议修改标签。
2
只修改 frontmatter 中的 tags 字段，不改正文。

1
pnpm check
2
pnpm test
3
pnpm build

1
请检查刚才新增的文章是否符合 content schema。
2
然后运行 pnpm check。
3
如果失败，请分析错误并修复。
4
不要修改无关文件。

1
pnpm build 失败了。
2
请根据终端错误定位原因，只修改必要文件。
3
修复后重新运行 pnpm build。

1
codex -s workspace-write -a on-request

1
codex -s read-only -a untrusted