# awsome_ai_idea

**Repository Path**: objcat/awsome_ai_idea

## Basic Information

- **Project Name**: awsome_ai_idea
- **Description**: No description available
- **Primary Language**: HTML/CSS
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-15
- **Last Updated**: 2026-08-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# README — 怎么跟我（狗）合作维护这个灵感库

我是「狗」，你的 AI 伙伴。这个仓库是一个**内容驱动**的纯静态网站（Next.js + Tailwind）：所有页面都由 `content/` 下的 Markdown 在**构建时**自动生成，没有数据库、没有手写页面。

下面记两件事：
1. **你能给我下什么指令**（也就是我接哪些活）；
2. **我生成「主题」和「任务」的方法**（你想自己照着做也行）。

> 注：网站给终端用户看的「怎么加内容 / 怎么浏览」写在 `使用手册.md`，那本给用人看；本文件是给你——我的主人——看怎么指挥我干活。

---

## 一、我能接什么指令

围绕这个项目，你可以直接这么使唤我：

| 你想做的事 | 可以这么跟我说 |
|-----------|---------------|
| 开一个新主题 | 「生成主题 <名字>」「新增主题 <领域>」「帮我做个 <XX> 主题」 |
| 给已有主题加任务 | 「给 <主题> 加几个任务」「<主题> 里补一个关于 <XX> 的任务」 |
| 改 / 重写某个任务 | 「重写 <主题> 里 <slug> 的提问词」「把 <主题> 的 <slug> 改得更适合新手」 |
| 校验内容能不能构建 | 「检查一下 content 能不能正常构建」「跑一下校验」 |
| 构建 / 部署 | 「build 一下」「推到 Gitee」「部署到 Vercel」 |
| 用主题学东西 | 「带我过一遍 Go GUI 主题的第一个任务」「解释下 Fyne 那个例子」 |
| 其他杂活 | 写代码、查资料、做分析、写文档，按你习惯来 |

**几条让产出更准的提示：**
- 说清「这个主题**面向谁**、想**覆盖哪些点**」。例如：「生成主题 Go GUI 桌面开发，面向有 Go 基础、想做跨平台桌面程序的新手」。
- 短语我也能懂（「生成主题 Go GUI」），但多给一句背景，我写出来的提问词就更贴你心意。
- 默认我用**集中式 `_modules.md`** 格式（一个文件管一个主题的全部任务），不拆成散文件。
- 每次新增 / 改完内容，我都会提醒你：**必须重新 build / 部署才上线**（Vercel 在 push 后自动重部署）。

---

## 二、我生成「主题 + 任务」的方法

### 总体流程

```
1. 定主题文件夹名（英文短横线，如 go-gui-desktop）
        ↓
2. 写 _topic.md        ← 主题元信息（title / tags / date / summary）
        ↓
3. 写 _modules.md      ← 集中存放该主题所有「可交给 AI 做的任务」
        ↓
4. 每个任务写一段「AI 优化提问词」（question 字段）
        ↓
5. 用项目自带的 gray-matter 校验 frontmatter 能正常解析
        ↓
6. 提醒你重新 build / 部署才上线
```

### 第 1 步：定文件夹名
- 放在 `content/<topic>/`，名字用**英文短横线**（URL 友好），例如 `go-gui-desktop`、`java`、`python`。
- 给人看的中文都写在 frontmatter 里，不在文件名。

### 第 2 步：写 `_topic.md`（主题元信息）
```yaml
---
title: Go 语言 GUI 桌面开发      # 主题名（给人看，必填）
tags: [编程, Go, 桌面应用, 入门] # 标签，首页筛选用
date: 2026-08-21                 # 日期，用于排序（新的在前）
summary: 一句话讲清这个主题覆盖什么
---
```

### 第 3 步：写 `_modules.md`（任务集中存放，推荐格式）
```yaml
---
modules:
  - slug: intro            # URL 片段（英文短横线），须唯一
    title: 认识 Go 桌面开发并选对 GUI 方案   # 菜单文字 + 内容页标题
    order: 1               # 数字越小越靠前（可选）
    question: |-           # AI 优化过的提问词（提示词），内容页直接展示可复制
      你是一位熟悉 Go 生态的桌面应用讲师……
      （支持多行，见下方「提问词写法」）
  - slug: env-setup
    title: 搭建 Go 环境并选定 GUI 方案
    order: 2
---
```
- `slug` → 三级路由片段；缺省回退 `m1/m2…`。
- `title` → 二级菜单 + 内容页标题；缺省取 `slug`。
- `question`（可选）→ 内容页展示的提问词；不写则取 `title`。
- `order`（可选）→ 排序；缺省按数组顺序。

> 兼容旧格式：若主题目录下**没有** `_modules.md`，会回退读分散的 `<module>.md`（文件名即 slug）。但只要建了 `_modules.md` 就整体切到集中格式。

### 第 4 步：写「提问词」（question 字段）的套路
我给每个任务写的提问词，基本是同一套模板，保证丢给任意 AI 都能产出好东西：

```
你是一位 <具体角色，如「Fyne 讲师 / Go 桌面开发讲师」>。
<用一句话说清任务 + 面向谁 + 当前水平>。
要求：
1. <结构：分小节 / 用表格 / 给前后对比>
2. <受众：零基础 / 有前端经验 / 想看成果>
3. <格式：中文、代码用 Markdown 代码块、可直接复制运行>
4. <避坑：点出 1–2 个新手常见错误>
5. <收尾：一句话总结 / 给出学习路线>
```

要点：
- **角色设定**让 AI 进入正确人设（讲师 / 顾问 / 工程师）。
- **分点要求**比一句「教我 XX」产出质量高得多。
- 强调「**可直接复制运行**」「**中文**」「**分小节**」这些输出约束。
- 一个主题里的任务最好**有递进关系**（认识 → 装环境 → Hello World → 组件 → 实战 → 美化 → 系统能力 → 打包 → 选型总结），像刚生成的 Go GUI 主题那样。

### 第 5 步：校验
我用项目自带的 `gray-matter`（构建时实际用的库）解析 frontmatter，确认：
- `_topic.md` 能解析出 `title/tags/date/summary`；
- `_modules.md` 的 `modules` 数组长度正确、`slug` 齐全无重复。
这样能提前拦掉 YAML 写错导致构建挂掉的问题。

### 第 6 步：收尾提醒
内容改完，必须重新构建（Vercel 在 push 后自动重部署）才会在线上生效——因为页面是**构建时**读 `content/` 生成的。

---

## 三、你可以直接抄的指令示例

- 「生成主题 <XX>，面向 <谁>，覆盖 <点1/点2/点3>」
- 「给 go-gui-desktop 主题再加一个『用 Gio 做移动端界面』的任务」
- 「把 java 主题里 oop 的提问词改得更口语一点」
- 「检查一下 content 目录能不能正常构建」
- 「build 一下，没问题就推 Gitee」

---

## 附：相关文档
- `AGENTS.md` — 给 AI / 协作者看的项目架构全貌（技术栈、目录、数据层）。
- `使用手册.md` — 给网站终端用户看的操作说明。
- `content/<topic>/` — 你所有的主题和任务内容都在这里。